a few more Doxygen tags

@@ -29,12 +29,13 @@
 #define _RMLATLONG_H_
 #define _RMLATLONG_H_
 
 
 #import <TargetConditionals.h>
 #import <TargetConditionals.h>
-#if TARGET_OS_IPHONE
 #import <CoreLocation/CoreLocation.h>
 #import <CoreLocation/CoreLocation.h>
 
 
 /*! \struct RMLatLongBounds
 /*! \struct RMLatLongBounds
- Specifies a region by northwest and southeast corners.
- Note: northWest and southEast will change to northeast and southwest (note spelling and corner changes) after 0.5 to keep right-handed coordinate system
+ 
+ \brief Specifies a rectangle by northwest and southeast corners, given as CLLocationCoordinate2D.
+
+ \deprecated Note: northWest and southEast will change to northeast and southwest (note spelling and corner changes) after 0.5 to keep right-handed coordinate system
  */
  */
 typedef struct {
 typedef struct {
 	CLLocationCoordinate2D northWest;
 	CLLocationCoordinate2D northWest;
@@ -71,8 +72,6 @@ typedef struct {
 } CLLocationCoordinate2D;
 } CLLocationCoordinate2D;
 
 
 
 
-#endif
-
 typedef CLLocationCoordinate2D RMLatLong;
 typedef CLLocationCoordinate2D RMLatLong;
 
 
 static const double kRMMinLatitude = -90.0f;
 static const double kRMMinLatitude = -90.0f;

@@ -97,8 +97,8 @@ enum {
 	RMMapRenderer *renderer;
 	RMMapRenderer *renderer;
 	NSUInteger		boundingMask;
 	NSUInteger		boundingMask;
 	
 	
-	// These should probably not be here. Instead equivalent functions
-	// should just fetch them when needed from the tileosurce.
+	/// \bug These should probably not be here. Instead equivalent functions
+	/// should just fetch them when needed from the tileosurce.
 	float minZoom, maxZoom;
 	float minZoom, maxZoom;
 
 
 	id<RMTilesUpdateDelegate> tilesUpdateDelegate;
 	id<RMTilesUpdateDelegate> tilesUpdateDelegate;
@@ -113,7 +113,7 @@ enum {
  "Scale" is how many meters in 1 pixel. Larger scale means bigger things are smaller on the screen.
  "Scale" is how many meters in 1 pixel. Larger scale means bigger things are smaller on the screen.
  "Scale" of 1 means 1 pixel == 1 meter.
  "Scale" of 1 means 1 pixel == 1 meter.
  "Scale" of 10 means 1 pixel == 10 meters.
  "Scale" of 10 means 1 pixel == 10 meters.
- \deprecated will be renamed appropriately and a new -scale method introduced, using cartographic scale (e.g. 1:24000).
+ \deprecated will be renamed metersPerPixel/setMetersPerPixel 
  */
  */
 @property (readwrite) float scale;
 @property (readwrite) float scale;
 @property (readwrite) float zoom;
 @property (readwrite) float zoom;
@@ -135,6 +135,7 @@ enum {
 @property (retain, readwrite) RMMapLayer *background;
 @property (retain, readwrite) RMMapLayer *background;
 @property (retain, readwrite) RMLayerSet *overlay;
 @property (retain, readwrite) RMLayerSet *overlay;
 @property (retain, readonly)  RMMarkerManager *markerManager;
 @property (retain, readonly)  RMMarkerManager *markerManager;
+/// \bug probably shouldn't be retaining this delegate
 @property (nonatomic, retain) id<RMTilesUpdateDelegate> tilesUpdateDelegate;
 @property (nonatomic, retain) id<RMTilesUpdateDelegate> tilesUpdateDelegate;
 @property (readwrite) NSUInteger boundingMask;
 @property (readwrite) NSUInteger boundingMask;
 
 
@@ -202,6 +203,7 @@ enum {
 - (void) tilesUpdatedRegion:(CGRect)region;
 - (void) tilesUpdatedRegion:(CGRect)region;
 
 
 /// the denominator in a cartographic scale like 1/24000, 1/50000, 1/2000000
 /// the denominator in a cartographic scale like 1/24000, 1/50000, 1/2000000
+/// \deprecated will be renamed scaleDenominator after 0.5
 - (double)trueScaleDenominator;
 - (double)trueScaleDenominator;
 
 
 @end
 @end

@@ -60,6 +60,7 @@
 
 
 -(void) removeTile: (RMTile) tile
 -(void) removeTile: (RMTile) tile
 {
 {
+	NSAssert(!RMTileIsDummy(tile), @"attempted to remove dummy tile");
 	if (RMTileIsDummy(tile))
 	if (RMTileIsDummy(tile))
 	{
 	{
 		RMLog(@"attempted to remove dummy tile...??");
 		RMLog(@"attempted to remove dummy tile...??");