fix: honor attr metadata privacy (swev-id: sphinx-doc__sphinx-8593)

sphinx/ext/autodoc/__init__.py

@@ -729,6 +729,14 @@ def is_filtered_inherited_member(name: str, obj: Any) -> bool:
             has_doc = bool(doc)
 
             metadata = extract_metadata(doc)
+            attr_doc = attr_docs.get((namespace, membername))
+            if attr_doc:
+                if isinstance(attr_doc, (list, tuple)):
+                    attr_doc = '\n'.join(attr_doc)
+                attr_metadata = extract_metadata(attr_doc)
+                if attr_metadata:
+                    metadata = {**attr_metadata, **metadata}
+
             if 'private' in metadata:
                 # consider a member private if docstring has "private" metadata
                 isprivate = True

tests/roots/test-ext-autodoc/target/meta_doc_comments.py

@@ -0,0 +1,2 @@
+#: :meta public:
+_foo = None

tests/test_ext_autodoc_attr_metadata.py

@@ -0,0 +1,17 @@
+"""
+    test_ext_autodoc_attr_metadata
+    ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+    Tests for autodoc behavior around metadata in attribute doc comments.
+"""
+
+import pytest
+
+from .test_ext_autodoc import do_autodoc
+
+
+@pytest.mark.sphinx('html', testroot='ext-autodoc')
+def test_meta_public_doc_comment(app):
+    options = {"members": None}
+    actual = do_autodoc(app, 'module', 'target.meta_doc_comments', options)
+    assert '.. py:data:: _foo' in list(actual)