Add missing docs

nyalldawson · nyalldawson · commit d075b128a8e8 · 2016-08-02T07:26:11.000+10:00
diff --git a/python/core/geometry/qgsgeometry.sip b/python/core/geometry/qgsgeometry.sip
@@ -794,6 +794,10 @@ class QgsGeometry
     //! Allows direct construction of QVariants from geometry.
     operator QVariant() const;
 
+    /** Returns true if the geometry is non empty (ie, isEmpty() returns false),
+     * or false if it is an empty, uninitialised geometry (ie, ieEmpty() returns true).
+     * @note added in QGIS 3.0
+     */
     operator bool() const;
 
 }; // class QgsGeometry
diff --git a/python/core/qgsvectorlayereditbuffer.sip b/python/core/qgsvectorlayereditbuffer.sip
@@ -145,7 +145,13 @@ class QgsVectorLayerEditBuffer : QObject
 
     void featureAdded( QgsFeatureId fid );
     void featureDeleted( QgsFeatureId fid );
+
+    /** Emitted when a feature's geometry is changed.
+     * @param fid feature ID
+     * @param geom new feature geometry
+     */
     void geometryChanged( QgsFeatureId fid, const QgsGeometry &geom );
+
     void attributeValueChanged( QgsFeatureId fid, int idx, const QVariant & );
     void attributeAdded( int idx );
     void attributeDeleted( int idx );
diff --git a/python/gui/qgshighlight.sip b/python/gui/qgshighlight.sip
@@ -4,7 +4,21 @@ class QgsHighlight : QgsMapCanvasItem
 #include <qgshighlight.h>
 %End
   public:
+
+    /** Constructor for QgsHighlight
+     * @param mapCanvas associated map canvas
+     * @param geom initial geometry of highlight
+     * @param layer associated map layer
+     */
+    //QgsHighlight( QgsMapCanvas *mapCanvas, const QgsGeometry& geom, QgsMapLayer *layer );
+
+    /** Constructor for QgsHighlight
+     * @param mapCanvas associated map canvas
+     * @param geom initial geometry of highlight
+     * @param layer associated vector layer
+     */
     QgsHighlight( QgsMapCanvas *mapCanvas, const QgsGeometry& geom, QgsVectorLayer *layer );
+
     ~QgsHighlight();
 
     /** Set line/outline to color, polygon fill to color with alpha = 63.
diff --git a/src/core/geometry/qgsgeometry.h b/src/core/geometry/qgsgeometry.h
@@ -845,6 +845,10 @@ class CORE_EXPORT QgsGeometry
       return QVariant::fromValue( *this );
     }
 
+    /** Returns true if the geometry is non empty (ie, isEmpty() returns false),
+     * or false if it is an empty, uninitialised geometry (ie, ieEmpty() returns true).
+     * @note added in QGIS 3.0
+     */
     operator bool() const;
 
   private:
diff --git a/src/core/qgsvectorlayereditbuffer.h b/src/core/qgsvectorlayereditbuffer.h
@@ -172,7 +172,13 @@ class CORE_EXPORT QgsVectorLayerEditBuffer : public QObject
 
     void featureAdded( QgsFeatureId fid );
     void featureDeleted( QgsFeatureId fid );
+
+    /** Emitted when a feature's geometry is changed.
+     * @param fid feature ID
+     * @param geom new feature geometry
+     */
     void geometryChanged( QgsFeatureId fid, const QgsGeometry &geom );
+
     void attributeValueChanged( QgsFeatureId fid, int idx, const QVariant & );
     void attributeAdded( int idx );
     void attributeDeleted( int idx );
diff --git a/src/gui/qgshighlight.h b/src/gui/qgshighlight.h
@@ -35,8 +35,21 @@ class QgsSymbolV2;
 class GUI_EXPORT QgsHighlight: public QgsMapCanvasItem
 {
   public:
+
+    /** Constructor for QgsHighlight
+     * @param mapCanvas associated map canvas
+     * @param geom initial geometry of highlight
+     * @param layer associated map layer
+     */
     QgsHighlight( QgsMapCanvas *mapCanvas, const QgsGeometry& geom, QgsMapLayer *layer );
+
+    /** Constructor for QgsHighlight
+     * @param mapCanvas associated map canvas
+     * @param geom initial geometry of highlight
+     * @param layer associated vector layer
+     */
     QgsHighlight( QgsMapCanvas *mapCanvas, const QgsGeometry& geom, QgsVectorLayer *layer );
+
     /** Constructor for highlighting true feature shape using feature attributes
      * and renderer.
      * @param mapCanvas map canvas

Original file line number	Diff line number	Diff line change
`@@ -845,6 +845,10 @@ class CORE_EXPORT QgsGeometry`
`845`	`845`	`return QVariant::fromValue( *this );`
`846`	`846`	`}`
`847`	`847`
	`848`	`+ /** Returns true if the geometry is non empty (ie, isEmpty() returns false),`
	`849`	`+ * or false if it is an empty, uninitialised geometry (ie, ieEmpty() returns true).`
	`850`	`+ * @note added in QGIS 3.0`
	`851`	`+ */`
`848`	`852`	`operator bool() const;`
`849`	`853`
`850`	`854`	`private:`