Add retrieveModuleDocumentation(modName) function to DocParser API.

Reviewer: Luciano Wolf <[email protected]>
          Marcelo Lira <[email protected]>

Author: hugopl

docparser.h

@@ -91,6 +91,15 @@ class APIEXTRACTOR_API DocParser
         return m_packageName;
     }
 
+    /**
+    *   Process and retrieves documentation concerning the entire
+    *   module or library.
+    *   \param name module name
+    *   \return object containing module/library documentation information
+    *   \todo Merge with retrieveModuleDocumentation() on next ABI change.
+    */
+    virtual Documentation retrieveModuleDocumentation(const QString& name) = 0;
+
 protected:
     QString getDocumentation(QXmlQuery& xquery, const QString& query,
                              const DocModificationList& mods) const;

qtdocparser.cpp

@@ -28,24 +28,7 @@
 
 Documentation QtDocParser::retrieveModuleDocumentation()
 {
-    // TODO: This method of acquiring the module name supposes that the target language uses
-    // dots as module separators in package names. Improve this.
-    QString moduleName = QString(packageName()).remove(0, packageName().lastIndexOf('.') + 1);
-    QString sourceFile = documentationDataDirectory() + '/' + moduleName.toLower() + ".xml";
-
-    if (!QFile::exists(sourceFile)) {
-        ReportHandler::warning("Can't find qdoc3 file for module "
-                               + packageName() + ", tried: "
-                               + sourceFile);
-        return Documentation();
-    }
-
-    QXmlQuery xquery;
-    xquery.setFocus(QUrl(sourceFile));
-
-    // Module documentation
-    QString query = "/WebXML/document/page[@name=\"" + moduleName + "\"]/description";
-    return Documentation(getDocumentation(xquery, query, DocModificationList()));
+    return retrieveModuleDocumentation(packageName());
 }
 
 void QtDocParser::fillDocumentation(AbstractMetaClass* metaClass)
@@ -164,3 +147,25 @@ void QtDocParser::fillDocumentation(AbstractMetaClass* metaClass)
         meta_enum->setDocumentation(doc);
     }
 }
+
+Documentation QtDocParser::retrieveModuleDocumentation(const QString& name)
+{
+    // TODO: This method of acquiring the module name supposes that the target language uses
+    // dots as module separators in package names. Improve this.
+    QString moduleName = QString(name).remove(0, name.lastIndexOf('.') + 1);
+    QString sourceFile = documentationDataDirectory() + '/' + moduleName.toLower() + ".xml";
+
+    if (!QFile::exists(sourceFile)) {
+        ReportHandler::warning("Can't find qdoc3 file for module "
+                               + name + ", tried: "
+                                                 + sourceFile);
+        return Documentation();
+    }
+
+    QXmlQuery xquery;
+    xquery.setFocus(QUrl(sourceFile));
+
+    // Module documentation
+    QString query = "/WebXML/document/page[@name=\"" + moduleName + "\"]/description";
+    return Documentation(getDocumentation(xquery, query, DocModificationList()));
+}

qtdocparser.h

@@ -32,6 +32,7 @@ class APIEXTRACTOR_API QtDocParser : public DocParser
     QtDocParser() {}
     virtual void fillDocumentation(AbstractMetaClass* metaClass);
     virtual Documentation retrieveModuleDocumentation();
+    virtual Documentation retrieveModuleDocumentation(const QString& name);
 };
 
 #endif // QTDOCPARSER_H