Even more docs

m-kuhn · m-kuhn · commit 265df9376918 · 2018-12-22T11:26:53.000+01:00
diff --git a/src/analysis/vector/geometry_checker/qgsgeometryareacheck.h b/src/analysis/vector/geometry_checker/qgsgeometryareacheck.h
@@ -22,6 +22,9 @@
 
 class QgsSurface;
 
+/**
+ * \ingroup analysis
+ */
 class ANALYSIS_EXPORT QgsGeometryAreaCheck : public QgsGeometryCheck
 {
   public:
diff --git a/src/analysis/vector/geometry_checker/qgsgeometrycheckerutils.h b/src/analysis/vector/geometry_checker/qgsgeometrycheckerutils.h
@@ -36,10 +36,17 @@ class QgsFeedback;
  * \note This class is a technology preview and unstable API.
  * \since QGIS 3.4
  */
-
 class ANALYSIS_EXPORT QgsGeometryCheckerUtils
 {
   public:
+    /**
+     * \ingroup analysis
+     *
+     * A layer feature combination to uniquely identify and access a feature in
+     * a set of layers.
+     *
+     * \since QGIS 3.4
+     */
     class ANALYSIS_EXPORT LayerFeature
     {
       public:
@@ -94,6 +101,13 @@ class ANALYSIS_EXPORT QgsGeometryCheckerUtils
         bool mMapCrs;
     };
 
+    /**
+     * \ingroup analysis
+     *
+     * Contains a set of layers and feature ids in those layers to pass to a geometry check.
+     *
+     * \since QGIS 3.4
+     */
     class ANALYSIS_EXPORT LayerFeatures
     {
       public:
@@ -110,6 +124,13 @@ class ANALYSIS_EXPORT QgsGeometryCheckerUtils
                        const QList<QgsWkbTypes::GeometryType> &geometryTypes,
                        const QgsGeometryCheckContext *context );
 
+        /**
+         * \ingroup analysis
+         *
+         * An iterator over all features in a QgsGeometryCheckerUtils::LayerFeatures.
+         * 
+         * \since QGIS 3.4
+         */
         class iterator
         {
           public:
@@ -131,7 +152,14 @@ class ANALYSIS_EXPORT QgsGeometryCheckerUtils
             std::unique_ptr<QgsGeometryCheckerUtils::LayerFeature> mCurrentFeature;
         };
 
+        /**
+         * The first feature to start iterating.
+         */
         iterator begin() const;
+
+        /**
+         * One after the last feature to stop iterating.
+         */
         iterator end() const;
 
 #endif
diff --git a/src/analysis/vector/geometry_checker/qgsgeometrycontainedcheck.h b/src/analysis/vector/geometry_checker/qgsgeometrycontainedcheck.h
@@ -22,6 +22,9 @@
 #include "qgsvectorlayer.h"
 #include "qgsgeometrycheckerror.h"
 
+/**
+ * \ingroup analysis
+ */
 class ANALYSIS_EXPORT QgsGeometryContainedCheckError : public QgsGeometryCheckError
 {
   public:
@@ -46,6 +49,9 @@ class ANALYSIS_EXPORT QgsGeometryContainedCheckError : public QgsGeometryCheckEr
     QPair<QString, QgsFeatureId> mContainingFeature;
 };
 
+/**
+ * \ingroup analysis
+ */
 class ANALYSIS_EXPORT QgsGeometryContainedCheck : public QgsGeometryCheck
 {
   public:
diff --git a/src/analysis/vector/geometry_checker/qgsgeometryfollowboundariescheck.h b/src/analysis/vector/geometry_checker/qgsgeometryfollowboundariescheck.h
@@ -23,6 +23,9 @@
 class QgsSpatialIndex;
 
 
+/**
+ * \ingroup analysis
+ */
 class ANALYSIS_EXPORT QgsGeometryFollowBoundariesCheck : public QgsGeometryCheck
 {
   public:
diff --git a/src/analysis/vector/geometry_checker/qgsgeometrysegmentlengthcheck.h b/src/analysis/vector/geometry_checker/qgsgeometrysegmentlengthcheck.h
@@ -20,6 +20,9 @@
 
 #include "qgsgeometrycheck.h"
 
+/**
+ * \ingroup analysis
+ */
 class ANALYSIS_EXPORT QgsGeometrySegmentLengthCheck : public QgsGeometryCheck
 {
   public:

Original file line number	Diff line number	Diff line change
`@@ -22,6 +22,9 @@`
`22`	`22`
`23`	`23`	`class QgsSurface;`
`24`	`24`
	`25`	`+/**`
	`26`	`+ * \ingroup analysis`
	`27`	`+ */`
`25`	`28`	`class ANALYSIS_EXPORT QgsGeometryAreaCheck : public QgsGeometryCheck`
`26`	`29`	`{`
`27`	`30`	`public:`
Original file line number	Diff line number	Diff line change
`@@ -23,6 +23,9 @@`
`23`	`23`	`class QgsSpatialIndex;`
`24`	`24`
`25`	`25`
	`26`	`+/**`
	`27`	`+ * \ingroup analysis`
	`28`	`+ */`
`26`	`29`	`class ANALYSIS_EXPORT QgsGeometryFollowBoundariesCheck : public QgsGeometryCheck`
`27`	`30`	`{`
`28`	`31`	`public:`
Original file line number	Diff line number	Diff line change
`@@ -20,6 +20,9 @@`
`20`	`20`
`21`	`21`	`#include "qgsgeometrycheck.h"`
`22`	`22`
	`23`	`+/**`
	`24`	`+ * \ingroup analysis`
	`25`	`+ */`
`23`	`26`	`class ANALYSIS_EXPORT QgsGeometrySegmentLengthCheck : public QgsGeometryCheck`
`24`	`27`	`{`
`25`	`28`	`public:`