Capture doxygen comments for namespaces

cxxheaderparser/parser.py

@@ -404,7 +404,7 @@ class CxxParser:
 
         # TODO: namespace_alias_definition
 
-        ns = NamespaceDecl(names, inline)
+        ns = NamespaceDecl(names, inline, doxygen)
         state = self._push_state(NamespaceBlockState, ns)
         state.location = location
         self.visitor.on_namespace_start(state)

cxxheaderparser/simple.py

@@ -92,6 +92,7 @@ class NamespaceScope:
 
     name: str = ""
     inline: bool = False
+    doxygen: typing.Optional[str] = None
 
     classes: typing.List["ClassScope"] = field(default_factory=list)
     enums: typing.List[EnumDecl] = field(default_factory=list)
@@ -249,8 +250,9 @@ class SimpleCxxVisitor:
 
         assert ns is not None
 
-        # only set inline on inner namespace
+        # only set inline/doxygen on inner namespace
         ns.inline = state.namespace.inline
+        ns.doxygen = state.namespace.doxygen
 
         self.block = ns
         self.namespace = ns

cxxheaderparser/types.py

@@ -56,6 +56,9 @@ class NamespaceDecl:
     names: typing.List[str]
     inline: bool = False
 
+    #: Documentation if present
+    doxygen: typing.Optional[str] = None
+
 
 @dataclass
 class DecltypeSpecifier: