Renamed -purgeAllTiles to -removeAllCachedImages. Added -removeAllCachedImages m…

…ethod to RMMapContents. Added documentation.

@@ -136,7 +136,7 @@
 	return [self shortAttribution];
 }
 
--(void) purgeAllTiles
+-(void) removeAllCachedImages
 {
 }
 @end

@@ -147,9 +147,9 @@
   return [tileSource tilePath];
 }
 
--(void) purgeAllTiles
+-(void) removeAllCachedImages
 {
-	[cache purgeAllTiles];
+	[cache removeAllCachedImages];
 }
 
 @end

@@ -177,9 +177,9 @@
 
 }
 
--(void) purgeAllTiles 
+-(void) removeAllCachedImages 
 {
-	[dao purgeAllTiles];
+	[dao removeAllCachedImages];
 }
 
 @end

@@ -205,10 +205,20 @@ enum {
 
 - (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;
 
+/*! \brief Clear all images from the #tileSource's caching system.
+ 
+ All of the existing RMTileSource implementations load tile images via NSURLRequest. It's possible that some images will remain in your
+ application's shared URL cache. If you need to clear this out too, use this call:
+ \code
+ [[NSURLCache sharedURLCache] removeAllCachedResponses];
+ \endcode
+ */
+-(void)removeAllCachedImages;
+
 @end
 
 @protocol RMMapContentsFacade

@@ -567,6 +567,12 @@
 	[renderer drawRect:aRect];
 }
 
+-(void)removeAllCachedImages
+{
+	[tileSource removeAllCachedImages];
+}
+
+
 #pragma mark Properties
 
 - (void) setTileSource: (id<RMTileSource>)newTileSource

@@ -129,7 +129,7 @@
 	[cache setObject:image forKey:key];
 }
 
--(void) purgeAllTiles 
+-(void) removeAllCachedImages 
 {
 	[cache removeAllObjects];
 }

@@ -46,8 +46,8 @@ typedef enum {
 @optional
 
 -(void)addTile: (RMTile)tile WithImage: (RMTileImage*)image;
-/// removes all tiles from the memory and disk subcaches
--(void)purgeAllTiles;
+/// removes all tile images from the memory and disk subcaches
+-(void)removeAllCachedImages;
 
 @end
 

@@ -140,11 +140,11 @@
 	}
 }
 
--(void) purgeAllTiles
+-(void) removeAllCachedImages
 {
 	for (id<RMTileCache> cache in caches)
 	{
-		[cache purgeAllTiles];
+		[cache removeAllCachedImages];
 	}
 }
 @end

@@ -41,6 +41,6 @@
 -(void) touchTile: (uint64_t) tileHash withDate: (NSDate*) date;
 -(void) addData: (NSData*) data LastUsed: (NSDate*)date ForTile: (uint64_t) tileHash;
 -(void) purgeTiles: (NSUInteger) count;
--(void) purgeAllTiles;
+-(void) removeAllCachedImages;
 
 @end

@@ -122,7 +122,7 @@
 	
 }
 
--(void) purgeAllTiles 
+-(void) removeAllCachedImages 
 {
 	BOOL result = [db executeUpdate: @"DELETE FROM ZCACHE"];
 	if (result == NO) {

@@ -58,6 +58,9 @@
 -(NSString *)shortAttribution;
 -(NSString *)longAttribution;
 
--(void)purgeAllTiles;
+/*! \brief clear all images from the in-memory and on-disk image caches
+ \bug This method belongs on RMCachedTileSource, not on RMTileSource, because an RMTileSource doesn't have a cache.
+ */
+-(void)removeAllCachedImages;
 
 @end