/**
 * Downloader
 *
 * Suports downloading files from other servers, including update checking.
 * Primarily used currently for offline maps and its themes.
 *
 * Workflow "selection":
 * - select a map file (or theme file) using the MapDownloadSelectorActivity
 * currently available in maps, settings and installation wizard
 * - selected file triggers the "download" workflow
 *
 * Workflow "download":
 * - Android internal Download manager gets triggered for download of a
 * specific file,
 * temporary info for this process is stored as PendingDownload
 * - Download manager calls DownloadNotificationReceiver with result
 * - this deletes the PendingDownload and triggers ReceiveMapFileActivity
 * - here copying the file to its final destination (unzipping along the
 * way, if needed) and handling of companion file is done
 *
 * Workflow "update":
 * - press "check update" button in MapDownloadSelectorActivity
 * - checks downloaded files for available updates (using info stored
 * in companion files)
 * - selection of found files and further workflow as above "selection"
 *
 * Workflow "mf-map-v4" and "mf-theme" schemes:
 * - download can also be triggered in the browser by clicking a link
 * having one of the above schemes
 * - this will trigger one of the MapDownloadReceiverSchemeXXX activities,
 * which will check the source for being supported, and triggers the
 * Android Download manager
 * - further steps as described in the "download" workflow
 *
 * CompanionFiles:
 * - for each downloaded file there will be a companion file in the same
 * folder having the same file name + addition extension "-cgeo.txt"
 * - This file stores original source uri & filename + date/time
 * to make this data available for update checking
 */
package cgeo.geocaching.downloader;

@@ -149,17 +149,91 @@
 s themes
-.
+ as well as for%0A * routing data. (See models/Download for available types.)
 %0A *%0A * W
@@ -298,27 +298,24 @@
 ) using the 
-Map
 DownloadSele
@@ -329,16 +329,18 @@
 ivity%0A *
+  
  current
@@ -547,16 +547,18 @@
  of a%0A *
+  
  specifi
@@ -567,16 +567,18 @@
 file,%0A *
+  
  tempora
@@ -762,23 +762,23 @@
 eive
-MapFileActivity
+DownloadService
 %0A * 
@@ -849,16 +849,18 @@
 g the%0A *
+  
  way, if
@@ -968,19 +968,16 @@
 tton in 
-Map
 Download
@@ -1065,16 +1065,18 @@
 tored%0A *
+  
  in comp
@@ -1283,16 +1283,18 @@
  link%0A *
+  
  having 
@@ -1395,16 +1395,18 @@
 ties,%0A *
+  
  which w
@@ -1466,16 +1466,18 @@
 s the%0A *
+  
  Android
@@ -1650,16 +1650,18 @@
  same%0A *
+  
  folder 
@@ -1786,16 +1786,18 @@
 /time%0A *
+  
  to make

Update downloader doc