Function lookup, strip more stuff

Author: jakobandersen

breathe/directives/function.py

@@ -136,10 +136,17 @@ def _parse_args(self, function_description: str) -> Optional[cpp.ASTParametersQu
         # strip everything that doesn't contribute to overloading
 
         def stripParamQual(paramQual):
+            paramQual.exceptionSpec = None  # type: ignore
+            paramQual.final = None  # type: ignore
+            paramQual.override = None  # type: ignore
+            # TODO: strip attrs when Doxygen handles them
+            paramQual.initializer = None  # type: ignore
+            paramQual.trailingReturn = None  # type: ignore
             for p in paramQual.args:
                 if p.arg is None:
                     assert p.ellipsis
                     continue
+                p.arg.init = None  # type: ignore
                 declarator = p.arg.type.decl
                 while hasattr(declarator, 'next'):
                     if isinstance(declarator, cpp.ASTDeclaratorParen):
@@ -148,8 +155,8 @@ def stripParamQual(paramQual):
                     else:
                         declarator = declarator.next  # type: ignore
                 assert hasattr(declarator, 'declId')
+                assert isinstance(declarator, cpp.ASTDeclaratorNameParamQual)
                 declarator.declId = None  # type: ignore
-                p.arg.init = None  # type: ignore
         stripParamQual(paramQual)
         return paramQual
 

documentation/source/specific.rst

@@ -241,6 +241,22 @@ C++ Function Lookup
 
 .. cpp:namespace:: @ex_specific_cpp_function_lookup
 
+.. doxygenfunction:: fNoexcept()
+   :project: cpp_function_lookup
+.. doxygenfunction:: fFinal()
+   :project: cpp_function_lookup
+.. doxygenfunction:: fOverride()
+   :project: cpp_function_lookup
+
+This one should actually have ``[[myattr]]`` but Doxygen seems to not put attributes into the XML:
+
+.. doxygenfunction:: fAttr()
+   :project: cpp_function_lookup
+.. doxygenfunction:: fFInit()
+   :project: cpp_function_lookup
+.. doxygenfunction:: fTrailing()
+   :project: cpp_function_lookup
+
 .. doxygenfunction:: fInit(int)
    :project: cpp_function_lookup
 .. doxygenfunction:: fPlain(int)

examples/specific/cpp_function_lookup.h

@@ -1,3 +1,12 @@
+// stuff on the paramQual
+void fNoexcept() noexcept;
+void fFinal() final;
+void fOverride() override;
+void fAttr() [[myattr]]; // TODO: Doxygen seems to strip attributes
+void fFInit() = default;
+auto fTrailing() -> int;
+
+// different parameters
 void fInit(int arg = 42);
 void fPlain(int arg);
 void fPtr(int *arg);