Add doxygen test to force use of \ingroup for classes

Using the group tag helps keep the API docs organized

Author: nyalldawson

doc/modules.dox

@@ -28,3 +28,10 @@ The SERVER library is built on top of the CORE library and adds map server
 components to QGIS.
 
 */
+
+/** @defgroup plugins plugin classes
+
+Contains classes related to implementation of QGIS plugins.
+
+*/
+

src/analysis/interpolation/Bezier3D.h

@@ -22,7 +22,8 @@
 #include "MathUtils.h"
 #include "qgslogger.h"
 
-/** Class Bezier3D represents a bezier curve, represented by control points. Parameter t is running from 0 to 1. The class is capable to calculate the curve point and the first two derivatives belonging to t.*/
+/** \ingroup analysis
+ * Class Bezier3D represents a bezier curve, represented by control points. Parameter t is running from 0 to 1. The class is capable to calculate the curve point and the first two derivatives belonging to t.*/
 class ANALYSIS_EXPORT Bezier3D: public ParametricLine
 {
   protected:

src/analysis/interpolation/CloughTocherInterpolator.h

@@ -24,7 +24,8 @@
 #include "MathUtils.h"
 #include "Bezier3D.h"
 
-/** This is an implementation of a Clough-Tocher interpolator based on a triangular tessellation. The derivatives orthogonal to the boundary curves are interpolated linearly along a triangle edge.*/
+/** \ingroup analysis
+ * This is an implementation of a Clough-Tocher interpolator based on a triangular tessellation. The derivatives orthogonal to the boundary curves are interpolated linearly along a triangle edge.*/
 class ANALYSIS_EXPORT CloughTocherInterpolator : public TriangleInterpolator
 {
   protected:

src/analysis/interpolation/DualEdgeTriangulation.h

@@ -34,7 +34,8 @@
 #include <QProgressDialog>
 #include <QCursor>
 
-/** DualEdgeTriangulation is an implementation of a triangulation class based on the dual edge data structure*/
+/** \ingroup analysis
+ * DualEdgeTriangulation is an implementation of a triangulation class based on the dual edge data structure*/
 class ANALYSIS_EXPORT DualEdgeTriangulation: public Triangulation
 {
   public:

src/analysis/interpolation/HalfEdge.h

@@ -17,6 +17,9 @@
 #ifndef HALFEDGE_H
 #define HALFEDGE_H
 
+/** \ingroup analysis
+ * \class HalfEdge
+ */
 class ANALYSIS_EXPORT HalfEdge
 {
   protected:

src/analysis/interpolation/LinTriangleInterpolator.h

@@ -20,7 +20,8 @@
 #include "TriangleInterpolator.h"
 #include "DualEdgeTriangulation.h"
 
-/** LinTriangleInterpolator is a class which interpolates linearly on a triangulation*/
+/** \ingroup analysis
+ * LinTriangleInterpolator is a class which interpolates linearly on a triangulation*/
 class ANALYSIS_EXPORT LinTriangleInterpolator : public TriangleInterpolator
 {
   public:

src/analysis/interpolation/Line3D.h

@@ -20,7 +20,8 @@
 #include "Point3D.h"
 #include "Node.h"
 
-/** This class represents a line. It is implemented as a single directed linked list of nodes (with related Point3D objects). Attention: the points inserted in a line are not deleted from Line3D*/
+/** \ingroup analysis
+ * This class represents a line. It is implemented as a single directed linked list of nodes (with related Point3D objects). Attention: the points inserted in a line are not deleted from Line3D*/
 class ANALYSIS_EXPORT Line3D
 {
   private:

src/analysis/interpolation/Node.h

@@ -19,7 +19,8 @@
 
 #include "Point3D.h"
 
-/** Node is a class used by Line3D. It represents a node in the single directed linked list. Associated Point3D objects are deleted when the node is deleted.*/
+/** \ingroup analysis
+ * Node is a class used by Line3D. It represents a node in the single directed linked list. Associated Point3D objects are deleted when the node is deleted.*/
 class ANALYSIS_EXPORT Node
 {
   protected:

src/analysis/interpolation/NormVecDecorator.h

@@ -23,7 +23,8 @@
 #include "qgslogger.h"
 class QProgressDialog;
 
-/** Decorator class which adds the functionality of estimating normals at the data points*/
+/** \ingroup analysis
+ * Decorator class which adds the functionality of estimating normals at the data points*/
 class ANALYSIS_EXPORT NormVecDecorator: public TriDecorator
 {
   public:

src/analysis/interpolation/ParametricLine.h

@@ -21,8 +21,10 @@
 #include "Vector3D.h"
 #include <QVector>
 
+/** \ingroup analysis
+ * ParametricLine is an Interface for parametric lines. It is possible, that a parametric line is composed of several parametric
+ * lines (see the composite pattern in Gamma et al. 'Design Patterns'). Do not build instances of it since it is an abstract class.*/
 class ANALYSIS_EXPORT ParametricLine
-      /** ParametricLine is an Interface for parametric lines. It is possible, that a parametric line is composed of several parametric lines (see the composite pattern in Gamma et al. 'Design Patterns'). Do not build instances of it since it is an abstract class.*/
 {
   protected:
     /** Degree of the parametric Line*/