Documentation extraction: Add error handling

Trim the strings returned by the XPath queries and warn about
failing queries.

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

1 files changed, 16 insertions, 0 deletions

diff --git a/sources/shiboken2/ApiExtractor/docparser.h b/sources/shiboken2/ApiExtractor/docparser.h
index afca254a4..1770815b0 100644
--- a/sources/shiboken2/ApiExtractor/docparser.h
+++ b/sources/shiboken2/ApiExtractor/docparser.h
@@ -120,6 +120,22 @@ protected:
 
     static AbstractMetaFunctionList documentableFunctions(const AbstractMetaClass *metaClass);
 
+    static QString msgCannotFindDocumentation(const QString &fileName,
+                                              const char *what, const QString &name,
+                                              const QString &query);
+    static QString msgCannotFindDocumentation(const QString &fileName,
+                                              const AbstractMetaClass *metaClass,
+                                              const AbstractMetaFunction *function,
+                                              const QString &query);
+    static QString msgCannotFindDocumentation(const QString &fileName,
+                                              const AbstractMetaClass *metaClass,
+                                              const AbstractMetaEnum *e,
+                                              const QString &query);
+    static QString msgCannotFindDocumentation(const QString &fileName,
+                                              const AbstractMetaClass *metaClass,
+                                              const AbstractMetaField *f,
+                                              const QString &query);
+
 private:
     QString m_packageName;
     QString m_docDataDir;