Documentation: Improve function documentation extraction

The XQuery used to obtain the function description can fail due to
argument type mismatches (typedefs or blank formatting).
In that case, repeat the query restricting the search
the argument count. If exactly one match is found, use that
with a warning. Output the matches otherwise.

Split out functions for the function queries and and helper
function for creating the XQuery with flags.

Task-number: PYSIDE-363
Change-Id: I83aaa53511896ee78a25f39a769ca907d0ac10bb
Reviewed-by: Alexandru Croitor <alexandru.croitor@qt.io>

1 files changed, 9 insertions, 0 deletions

diff --git a/sources/shiboken2/ApiExtractor/qtdocparser.h b/sources/shiboken2/ApiExtractor/qtdocparser.h
index 3ea0122b4..b5f0e51d8 100644
--- a/sources/shiboken2/ApiExtractor/qtdocparser.h
+++ b/sources/shiboken2/ApiExtractor/qtdocparser.h
@@ -38,6 +38,15 @@ public:
     void fillDocumentation(AbstractMetaClass* metaClass) override;
     Documentation retrieveModuleDocumentation() override;
     Documentation retrieveModuleDocumentation(const QString& name) override;
+
+private:
+    QString queryFunctionDocumentation(const QString &sourceFileName,
+                                       const AbstractMetaClass* metaClass,
+                                       const QString &classQuery,
+                                       const  AbstractMetaFunction *func,
+                                       const DocModificationList &signedModifs,
+                                       QXmlQuery &xquery,
+                                       QString *errorMessage);
 };
 
 #endif // QTDOCPARSER_H