Add some comments

src/gui/qgsrubberband.h

@@ -31,14 +31,38 @@ class QPaintEvent;
 class GUI_EXPORT QgsRubberBand: public QgsMapCanvasItem
 {
   public:
+    /**
+     * Creates a new RubberBand.
+     * @param mapCanvas The map canvas to draw onto. It's CRS will be used map points onto screen coordinates.
+     * @param geometryType Defines how the data should be drawn onto the screen. (Use QGis::Line, QGis::Polygon or QGis::Point)
+     * Added in 1.9.
+     */
     QgsRubberBand( QgsMapCanvas* mapCanvas, QGis::GeometryType geometryType = QGis::Line );
+    /**
+     * Creates a new RubberBand.
+     * @deprecated
+     * @param mapCanvas The map canvas to draw onto. It's CRS will be used map points onto screen coordinates.
+     * @param isPolygon true: draw as (multi-)polygon, false draw as (multi-)linestring
+     */
     QgsRubberBand( QgsMapCanvas* mapCanvas, bool isPolygon );
     ~QgsRubberBand();
 
     void setColor( const QColor & color );
     void setWidth( int width );
 
+    /**
+     * Clears all the geometries in this rubberband.
+     * Sets the representation type according to geometryType.
+     * @param geometryType Defines how the data should be drawn onto the screen. (Use QGis::Line, QGis::Polygon or QGis::Point)
+     * Added in 1.9.
+     */
     void reset( QGis::GeometryType geometryType = QGis::Line );
+    /**
+     * @deprecated
+     * Clears all the geometries in this rubberband.
+     * Sets the representation type according to isPolygon.
+     * @param isPolygon true: draw as (multi-)polygon, false draw as (multi-)linestring
+     */
     void reset( bool isPolygon );
 
     //! Add point to rubberband and update canvas