doc clarifications

@@ -89,6 +89,7 @@
 /** @name Representing an Annotation Visually */
 /** @name Representing an Annotation Visually */
 
 
 /** An object representing the annotation's visual appearance.
 /** An object representing the annotation's visual appearance.
+*
 *   @see RMMarker
 *   @see RMMarker
 *   @see RMShape
 *   @see RMShape
 *   @see RMCircle */
 *   @see RMCircle */

@@ -62,12 +62,20 @@ typedef enum : NSUInteger {
 /** @name Creating Tile Sources */
 /** @name Creating Tile Sources */
 
 
 /** Initialize a tile source using the MapBox map ID.
 /** Initialize a tile source using the MapBox map ID.
+*
+*   This method requires a network connection in order to download the TileJSON used to define the tile source. 
+*
 *   @param mapID The MapBox map ID string, typically in the format `<username>.map-<random characters>`.
 *   @param mapID The MapBox map ID string, typically in the format `<username>.map-<random characters>`.
 *   @return An initialized MapBox tile source. */
 *   @return An initialized MapBox tile source. */
 - (id)initWithMapID:(NSString *)mapID;
 - (id)initWithMapID:(NSString *)mapID;
 
 
 /** Initialize a tile source with either a remote or local TileJSON structure.
 /** Initialize a tile source with either a remote or local TileJSON structure.
-*   @param referenceURL A remote or local URL pointing to a TileJSON structure. 
+*
+*   Passing a remote URL requires a network connection. If offline functionality is desired, you should cache the TileJSON locally at a prior date, then pass a file path URL to this method.
+*
+*   @see tileJSON
+*
+*   @param referenceURL A remote or file path URL pointing to a TileJSON structure.
 *   @return An initialized MapBox tile source. */
 *   @return An initialized MapBox tile source. */
 - (id)initWithReferenceURL:(NSURL *)referenceURL;
 - (id)initWithReferenceURL:(NSURL *)referenceURL;
 
 
@@ -77,19 +85,27 @@ typedef enum : NSUInteger {
 - (id)initWithTileJSON:(NSString *)tileJSON;
 - (id)initWithTileJSON:(NSString *)tileJSON;
 
 
 /** For TileJSON 2.1.0+ layers, initialize a tile source and automatically find and add annotations from [simplestyle](http://mapbox.com/developers/simplestyle/) data.
 /** For TileJSON 2.1.0+ layers, initialize a tile source and automatically find and add annotations from [simplestyle](http://mapbox.com/developers/simplestyle/) data.
+*
+*   This method requires a network connection in order to download the TileJSON used to define the tile source.
+*
 *   @param mapID The MapBox map ID string, typically in the format `<username>.map-<random characters>`.
 *   @param mapID The MapBox map ID string, typically in the format `<username>.map-<random characters>`.
 *   @param mapView A map view on which to display the annotations.
 *   @param mapView A map view on which to display the annotations.
 *   @return An initialized MapBox tile source. */
 *   @return An initialized MapBox tile source. */
 - (id)initWithMapID:(NSString *)mapID enablingDataOnMapView:(RMMapView *)mapView;
 - (id)initWithMapID:(NSString *)mapID enablingDataOnMapView:(RMMapView *)mapView;
 
 
 /** For TileJSON 2.1.0+ layers, initialize a tile source and automatically find and add annotations from [simplestyle](http://mapbox.com/developers/simplestyle/) data.
 /** For TileJSON 2.1.0+ layers, initialize a tile source and automatically find and add annotations from [simplestyle](http://mapbox.com/developers/simplestyle/) data.
-*   @param tileJSON A string containing TileJSON. 
+*   @param tileJSON A string containing TileJSON.
 *   @param mapView A map view on which to display the annotations. 
 *   @param mapView A map view on which to display the annotations. 
 *   @return An initialized MapBox tile source. */
 *   @return An initialized MapBox tile source. */
 - (id)initWithTileJSON:(NSString *)tileJSON enablingDataOnMapView:(RMMapView *)mapView;
 - (id)initWithTileJSON:(NSString *)tileJSON enablingDataOnMapView:(RMMapView *)mapView;
 
 
 /** For TileJSON 2.1.0+ layers, initialize a tile source and automatically find and add annotations from [simplestyle](http://mapbox.com/developers/simplestyle/) data.
 /** For TileJSON 2.1.0+ layers, initialize a tile source and automatically find and add annotations from [simplestyle](http://mapbox.com/developers/simplestyle/) data.
-*   @param referenceURL A remote or local URL pointing to a TileJSON structure.
+*
+*   Passing a remote URL requires a network connection. If offline functionality is desired, you should cache the TileJSON locally at a prior date, then pass a file path URL to this method.
+*
+*   @see tileJSON
+*
+*   @param referenceURL A remote or file path URL pointing to a TileJSON structure.
 *   @param mapView A map view on which to display the annotations.
 *   @param mapView A map view on which to display the annotations.
 *   @return An initialized MapBox tile source. */
 *   @return An initialized MapBox tile source. */
 - (id)initWithReferenceURL:(NSURL *)referenceURL enablingDataOnMapView:(RMMapView *)mapView;
 - (id)initWithReferenceURL:(NSURL *)referenceURL enablingDataOnMapView:(RMMapView *)mapView;
@@ -117,6 +133,8 @@ typedef enum : NSUInteger {
 /** The TileJSON data in dictionary format. Useful for retrieving info about the layer without having to parse TileJSON. */
 /** The TileJSON data in dictionary format. Useful for retrieving info about the layer without having to parse TileJSON. */
 @property (nonatomic, readonly, strong) NSDictionary *infoDictionary;
 @property (nonatomic, readonly, strong) NSDictionary *infoDictionary;
 
 
+/** @name Configuring Map Options */
+
 /** Image quality that is retrieved from the network. Useful for lower-bandwidth environments. The default is to provide full-quality imagery. 
 /** Image quality that is retrieved from the network. Useful for lower-bandwidth environments. The default is to provide full-quality imagery. 
 *
 *
 *   Note that you may want to clear the tile cache after changing this value in order to provide a consistent experience. */
 *   Note that you may want to clear the tile cache after changing this value in order to provide a consistent experience. */