clarifications

@@ -37,9 +37,9 @@
 
 /** Initialize a polygon annotation.
 *   @param aMapView The map view on which to place the annotation.
-*   @param points An array of CLLocation points defining the shape. The data in this array is copied to the new object.
+*   @param points An array of CLLocation points defining the polygon. The data in this array is copied to the new object.
 *   @param interiorPolygons An array of RMPolygonAnnotation objects that define one or more cutout regions for the receiver’s polygon.
-*   @return An initialized shape annotation object, or `nil` if an annotation was unable to be initialized. */
+*   @return An initialized polygon annotation object, or `nil` if an annotation was unable to be initialized. */
 - (id)initWithMapView:(RMMapView *)aMapView points:(NSArray *)points interiorPolygons:(NSArray *)interiorPolygons;
 
 /** The array of polygons nested inside the receiver. (read-only)

@@ -29,8 +29,8 @@
 #import "RMShapeAnnotation.h"
 
 /** An RMPolylineAnnotation is a concrete subclass of RMShapeAnnotation that is used to represent a shape consisting of one or more points that define connecting line segments. The points are connected end-to-end in the order they are provided. The first and last points are not connected to each other. The annotation will automatically have a layer created when needed that displays an RMShape.
- *
- *  If you wish to customize the layer appearance in more detail, you should instead create an RMAnnotation and configure its layer directly. Providing a layer manually for instances of RMPolylineAnnotation will not have any effect. */
+*
+*   If you wish to customize the layer appearance in more detail, you should instead create an RMAnnotation and configure its layer directly. Providing a layer manually for instances of RMPolylineAnnotation will not have any effect. */
 @interface RMPolylineAnnotation : RMShapeAnnotation
 
 @end