[QGIS Commit] r10492 - trunk/qgis/src/core

[svn_qgis at osgeo.org]

Author: mhugent
Date: 2009-04-07 04:08:53 -0400 (Tue, 07 Apr 2009)
New Revision: 10492

Modified:
   trunk/qgis/src/core/qgscentralpointpositionmanager.h
   trunk/qgis/src/core/qgsgeometry.h
   trunk/qgis/src/core/qgsmaprenderer.h
   trunk/qgis/src/core/qgsoverlayobject.h
   trunk/qgis/src/core/qgsoverlayobjectpositionmanager.h
   trunk/qgis/src/core/qgspalobjectpositionmanager.h
   trunk/qgis/src/core/qgsvectorlayer.h
   trunk/qgis/src/core/qgsvectoroverlay.h
Log:
Added notes about new classes and methods in 1.1

Modified: trunk/qgis/src/core/qgscentralpointpositionmanager.h
===================================================================
--- trunk/qgis/src/core/qgscentralpointpositionmanager.h	2009-04-07 07:11:43 UTC (rev 10491)
+++ trunk/qgis/src/core/qgscentralpointpositionmanager.h	2009-04-07 08:08:53 UTC (rev 10492)
@@ -24,7 +24,9 @@
 class QgsPoint;
 
 /**A simple position manager implementation which positions the overlay objects on the center point of
-a feature. It does not consider conflicts in case of several overlay layers*/
+a feature. It does not consider conflicts in case of several overlay layers
+* \note This class has been added in version 1.1
+*/
 class QgsCentralPointPositionManager: public QgsOverlayObjectPositionManager
 {
   public:

Modified: trunk/qgis/src/core/qgsgeometry.h
===================================================================
--- trunk/qgis/src/core/qgsgeometry.h	2009-04-07 07:11:43 UTC (rev 10491)
+++ trunk/qgis/src/core/qgsgeometry.h	2009-04-07 08:08:53 UTC (rev 10492)
@@ -118,7 +118,8 @@
     */
     size_t wkbSize();
 
-    /**Returns a geos geomtry. QgsGeometry keeps ownership, don't delete this object!*/
+    /**Returns a geos geomtry. QgsGeometry keeps ownership, don't delete the returned object!
+        @note this method was added in version 1.1*/
     GEOSGeometry* asGeos();
 
     /** Returns type of wkb (point / linestring / polygon etc.) */

Modified: trunk/qgis/src/core/qgsmaprenderer.h
===================================================================
--- trunk/qgis/src/core/qgsmaprenderer.h	2009-04-07 07:11:43 UTC (rev 10491)
+++ trunk/qgis/src/core/qgsmaprenderer.h	2009-04-07 08:08:53 UTC (rev 10492)
@@ -179,7 +179,8 @@
      */
     bool splitLayersExtent( QgsMapLayer* layer, QgsRectangle& extent, QgsRectangle& r2 );
 
-    /**Creates an overlay object position manager subclass according to the current settings*/
+    /**Creates an overlay object position manager subclass according to the current settings
+    @note this method was added in version 1.1*/
     QgsOverlayObjectPositionManager* overlayManagerFromSettings();
 
   protected:

Modified: trunk/qgis/src/core/qgsoverlayobject.h
===================================================================
--- trunk/qgis/src/core/qgsoverlayobject.h	2009-04-07 07:11:43 UTC (rev 10491)
+++ trunk/qgis/src/core/qgsoverlayobject.h	2009-04-07 08:08:53 UTC (rev 10492)
@@ -25,8 +25,10 @@
 class QgsGeometry;
 
 /**An object that holds information about the position and bounding box size of
-    an overlay object. It stores a copy of the feature geometry as this information is commonly used
-    to calculate object placement*/
+*    an overlay object. It stores a copy of the feature geometry as this information is commonly used
+*    to calculate object placement
+* \note This class has been added in version 1.1
+*/
 class CORE_EXPORT QgsOverlayObject: public pal::PalGeometry
 {
   public:

Modified: trunk/qgis/src/core/qgsoverlayobjectpositionmanager.h
===================================================================
--- trunk/qgis/src/core/qgsoverlayobjectpositionmanager.h	2009-04-07 07:11:43 UTC (rev 10491)
+++ trunk/qgis/src/core/qgsoverlayobjectpositionmanager.h	2009-04-07 08:08:53 UTC (rev 10492)
@@ -25,7 +25,9 @@
 class QgsVectorLayer;
 class QgsVectorOverlay;
 
-/**Interface for classes that arrange overlay objects of different layers on the map*/
+/**Interface for classes that arrange overlay objects of different layers on the map
+* \note This class has been added in version 1.1
+*/
 class QgsOverlayObjectPositionManager
 {
   public:

Modified: trunk/qgis/src/core/qgspalobjectpositionmanager.h
===================================================================
--- trunk/qgis/src/core/qgspalobjectpositionmanager.h	2009-04-07 07:11:43 UTC (rev 10491)
+++ trunk/qgis/src/core/qgspalobjectpositionmanager.h	2009-04-07 08:08:53 UTC (rev 10492)
@@ -21,6 +21,9 @@
 #include "qgsoverlayobjectpositionmanager.h"
 #include "pal.h"
 
+/**A class that uses the PAL library for overlay object placement
+* \note This class has been added in version 1.1
+*/
 class QgsPALObjectPositionManager: public QgsOverlayObjectPositionManager
 {
   public:

Modified: trunk/qgis/src/core/qgsvectorlayer.h
===================================================================
--- trunk/qgis/src/core/qgsvectorlayer.h	2009-04-07 07:11:43 UTC (rev 10491)
+++ trunk/qgis/src/core/qgsvectorlayer.h	2009-04-07 08:08:53 UTC (rev 10492)
@@ -427,16 +427,24 @@
     /**access range */
     RangeData &range( int idx );
 
-    /**Adds a new overlay to this class. QgsVectorLayer takes ownership of the object*/
+    /**Adds a new overlay to this class. QgsVectorLayer takes ownership of the object
+    @note this method was added in version 1.1
+    */
     void addOverlay( QgsVectorOverlay* overlay );
 
-    /**Removes all overlays of a given type*/
+    /**Removes all overlays of a given type
+    @note this method was added in version 1.1
+    */
     void removeOverlay( const QString& typeName );
 
-    /**Returns pointers to the overlays of this layer*/
+    /**Returns pointers to the overlays of this layer
+    @note this method was added in version 1.1
+    */
     void vectorOverlays( QList<QgsVectorOverlay*>& overlayList );
 
-    /**Returns the (first) overlay of a type, e.g. diagram or label*/
+    /**Returns the (first) overlay of a type, e.g. diagram or label
+    @note this method was added in version 1.1
+    */
     QgsVectorOverlay* findOverlayByType( const QString& typeName );
 
   public slots:

Modified: trunk/qgis/src/core/qgsvectoroverlay.h
===================================================================
--- trunk/qgis/src/core/qgsvectoroverlay.h	2009-04-07 07:11:43 UTC (rev 10491)
+++ trunk/qgis/src/core/qgsvectoroverlay.h	2009-04-07 08:08:53 UTC (rev 10492)
@@ -25,7 +25,9 @@
 class QgsRect;
 class QgsRenderContext;
 
-/**Base class for vector layer overlays (e.g. Diagrams, labels, etc.). For each object, the position of the bounding box is stored in a QgsOberlayObject. The vector overlays are drawn on top of all layers*/
+/**Base class for vector layer overlays (e.g. Diagrams, labels, etc.). For each object, the position of the bounding box is *stored in a QgsOberlayObject. The vector overlays are drawn on top of all layers
+* \note This class has been added in version 1.1
+*/
 class CORE_EXPORT QgsVectorOverlay
 {
   public: