From 24c23ed9377b4db87443df708824d9e0e79bc8f5 Mon Sep 17 00:00:00 2001 From: Kaj-Michael Lang Date: Wed, 25 Jul 2007 14:36:33 +0300 Subject: [PATCH] It's Mapper now. --- data/help/en_US/maemomapper.xml.in | 200 ++++++++++++++--------------- 1 file changed, 99 insertions(+), 101 deletions(-) diff --git a/data/help/en_US/maemomapper.xml.in b/data/help/en_US/maemomapper.xml.in index 14421cd..ea7da67 100644 --- a/data/help/en_US/maemomapper.xml.in +++ b/data/help/en_US/maemomapper.xml.in @@ -1,13 +1,13 @@ - Maemo Mapper + Mapper Introduction - - Welcome to Maemo Mapper. + + Welcome to Mapper. - Maemo Mapper is a geographical mapping tool that can be used to: + Mapper is a geographical mapping tool that can be used to: @@ -36,77 +36,77 @@ - Use the to peruse the + Use the to peruse the various sections of this help document, or go to to + refid="help_mapper_getstarted" refdoc="Getting Started"/> to get up and running quickly. Getting Started - + - When you first start Maemo Mapper, you will be presented with the + When you first start Mapper, you will be presented with the Settings dialog box. Most of the settings have reasonable defaults, but if you have a GPS receiver, you should fill in the MAC field with the MAC address of your GPS receiver. If you don't know the MAC, turn on your GPS receiver and push the - Search button. Maemo Mapper will + Search button. Mapper will attempt to automatically discover the MAC address of your receiver. For more information about the Settings - dialog box, see . - When you are finished setting up Maemo Mapper to your preferences, + When you are finished setting up Mapper to your preferences, pressing the Ok button will lead you to another dialog box: the Manage Repositories dialog. To get started quickly, press the - Download... button. Maemo Mapper will + Download... button. Mapper will download a set of pre-defined repository information for you to use. If you use the pre-defined repositories, you can delete the Default repository. For more information about repositories and the Manage Repositories dialog, see - . Certain repositories (most notably, the commercial ones) may have license agreements attached with their use. It may be illegal to - use a certain repository with Maemo Mapper or under certain + use a certain repository with Mapper or under certain conditions. This includes the repositories downloaded via the Download... button. If you are not sure if you are legally allowed to use a particular repository, you should delete it from your list of repositories. The authors of - Maemo Mapper cannot be held responsible for your use of a particular + Mapper cannot be held responsible for your use of a particular repository. Once you have your Repositories set up the way you like, press the Ok button, and you will be presented with a blank screen, because you have not yet actually downloaded any map data to your device. - To allow Maemo Mapper to automatically download map data as it + To allow Mapper to automatically download map data as it becomes needed on the display, enable the Auto-Download checkbox in the Maps menu. - If you have a working internet connection, Maemo Mapper will attempt + If you have a working internet connection, Mapper will attempt to download maps and display them on the screen automatically as the downloads complete. You should see a map of the world. Be careful when you enable Auto-Download, because it can quickly fill your available disk space. See - for + for details on how to manage disk space for a particular repository. The Graphical User Interface - The main view of Maemo Mapper emphasizes simplicity. By default, + The main view of Mapper emphasizes simplicity. By default, the map is all that is displayed. You current position (if you have a GPS receiver) is indicated by a blue circle. The blue line extending from the blue circle indicates your current heading and @@ -175,20 +175,20 @@ For help with any of these features, use the - . + . Main Menu - + This help topic describes the functionality of each of the menu - items in Maemo Mapper. + items in Mapper. Route The Route menu is used to manipulate - the current route. A route in Maemo Mapper is defined as a + the current route. A route in Mapper is defined as a set of points and waypoints describing where you would like to go, e.g. driving directions from 123 Main Street to 456 Elm Street. It can include multiple segments. The current route is @@ -207,7 +207,7 @@ Download... - Download a route from - the internet. See for more information. @@ -227,7 +227,7 @@ one route segment and the beginning of another route segment). - Reset - Reset Maemo Mapper's tracking + Reset - Reset Mapper's tracking of your progress along the current route. Use this if Maemo Mapper loses track of where you are with respect to the current route. @@ -240,7 +240,7 @@ Track The Track menu is used to manipulate - your current track. A track in Maemo Mapper is defined as + your current track. A track in Mapper is defined as a set of points along which you have been traveling, i.e. where you have been. It can include multiple segments. Tracks are most useful if you have enabled a GPS receiver. The current track @@ -307,17 +307,17 @@ Manage Maps... - Download or delete maps for the currently selected repository. For more details, see - . + . Manage Repositories... - Configure each of your available repositories, or add new ones. You can also download a pre-defined set of repositories. For more - details, see . - Auto-Download - Toggle Maemo Mapper's + Auto-Download - Toggle Mapper's ability to automatically download maps as they are needed in order to fill the screen with map data. This is useful for arbitrary exploration of the world while connected to the internet, or if @@ -372,18 +372,18 @@ POI Categories... - Define POI categories and which categories are displayed on the map. For - more details, see . Auto-Center The Auto-Center menu is used to control - whether or not Maemo Mapper should re-center the display as your + whether or not Mapper should re-center the display as your current location changes. The sensitivity of re-centering (how - close you get to the edge of the display before Maemo Mapper + close you get to the edge of the display before Mapper re-centers the display) can be configured in the Dialog. + refid="help_mapper_settings" refdoc="Settings"/> Dialog. There are three different modes of Auto-Center: @@ -444,7 +444,7 @@ Enable GPS - Toggle communication with a GPS receiver. You must have a GPS receiver set up in order - to use this menu item. When on, Maemo Mapper will constantly + to use this menu item. When on, Mapper will constantly search for the GPS receiver. @@ -475,8 +475,8 @@ Settings... - Access and change - settings for using Maemo Mapper. For more information, see . + settings for using Mapper. For more information, see . Help... - Access this help file. @@ -486,13 +486,13 @@ copyright information. - Close - Close Maemo Mapper. + Close - Close Mapper. Context Menu - + By tapping and holding on the screen, you can access the context menu to execute actions on either that location, the nearest route @@ -529,7 +529,7 @@ Download Route to... - Open the - dialog with the selected location pre-filled as the destination. @@ -577,7 +577,7 @@ Show Description - Show the description attached to the select waypoint. When downloading - routes via the dialog, the description will contain the directions needed to take at that waypoint (e.g. "Turn left at Main Street. Go 2.5 kilometers."). @@ -600,7 +600,7 @@ Download Route to... - Open the - dialog with the selected waypoint's location pre-filled as the destination. @@ -636,7 +636,7 @@ Download Route to... - Open the - dialog with the selected POI's location pre-filled as the destination. @@ -657,9 +657,9 @@ Managing Repositories - + - In Maemo Mapper, map data is divided into specific areas called + In Mapper, map data is divided into specific areas called repositories. A repository is a source of map data, each of which has its own way of visualizing the Earth. For example, repositories based on street maps typically draw roads as lines and @@ -682,10 +682,10 @@ Once you have set up at least one repository, you can start downloading maps from that repository to your device's file system. For details on how to do this, see - . + . - You can set up any number of repositories in Maemo Mapper, but only + You can set up any number of repositories in Mapper, but only one can be active at any given time. The Manage Repositories dialog is accessed via the Manage Repositories... menu item of the @@ -723,15 +723,15 @@ zoom levels should be avoided when automatically downloading maps (i.e. Auto-Download is enabled). The lowest setting (one bar) means to download every zoom level. The highest setting (four - bars) causes Maemo Mapper to only download every fourth zoom level + bars) causes Mapper to only download every fourth zoom level (0, 4, 8, and 16). View Zoom Steps - Similar to the above-described Download Zoom Steps - option, except that it controls how Maemo Mapper behaves when + option, except that it controls how Mapper behaves when zooming. For example, at two bars, pressing - causes Maemo Mapper to zoom + causes Mapper to zoom in two levels instead of just one. Setting this equal to Download Zoom Steps ensures that you see all maps at their native resolution. @@ -773,7 +773,7 @@ Reset... - Resets your repository list to the factory default. This will remove all of your repositories and replace them with the single default repository - that comes with Maemo Mapper. + that comes with Mapper. Download... - Downloads information @@ -786,31 +786,31 @@ Certain repositories (most notably, the commercial ones) may have license agreements attached with their use. It may be - illegal to use a certain repository with Maemo Mapper or under + illegal to use a certain repository with Mapper or under certain conditions. This includes the repositories downloaded via the Download... button. If you are not sure if you are legally allowed to use a particular repository, you should delete it from your list of repositories. - The authors of Maemo Mapper cannot be held responsible for your + The authors of Mapper cannot be held responsible for your use of a particular repository. Downloading Routes - + Route data can be loaded from GPX files, like the ones provided by the GPX Driving Directions web service (http://www.gnuite.com/cgi-bin/gpx.cgi). Or, route data can be - downloaded directly within Maemo Mapper using the + downloaded directly within Mapper using the Download Route dialog. Downloading routes requires an active connection to the internet, - but once a route is loaded into Maemo Mapper, the internet + but once a route is loaded into Mapper, the internet connection is no longer needed (unless Auto-Update is enabled). The route - download functionality in Maemo Mapper actually uses the + download functionality in Mapper actually uses the aforementioned GPX Driving Directions web service. @@ -826,7 +826,7 @@ Auto-Update - This option, only available if Use GPS Location is - enabled, will cause Maemo Mapper to automatically re-download a + enabled, will cause Mapper to automatically re-download a new route if you stray from the route. Note that you must have a continuous connection to the internet (i.e. cellular data service) for Auto-Update to work. @@ -861,25 +861,25 @@ Managing Maps - + - In Maemo Mapper, repositories represent sources of map data, + In Mapper, repositories represent sources of map data, and maps are just image files (e.g. PNG or JPEG) that are drawn onto the screen. Once you have a repository set up (see - ), you can download maps from a repository into a Map Cache, which is just a directory on your device's file system. - Maemo Mapper downloads maps from the current repository so that they + Mapper downloads maps from the current repository so that they can be drawn onto the screen and later recalled from disk, instead of downloading a map every time it is needed. This is called - caching, and it allows you to use Maemo Mapper even when you + caching, and it allows you to use Mapper even when you are not connected to the internet. - Because Maemo Mapper downloads maps to your device's file system, + Because Mapper downloads maps to your device's file system, you must be aware of how much disk space your maps are taking up, especially if you enable Auto-Download. @@ -920,7 +920,7 @@ specify. - By Area - If selected, Maemo Mapper + By Area - If selected, Mapper will download or delete maps for a particular rectangular area of the world, based on the latitude and longitude of an upper-left and lower-right corner. See the Area @@ -938,7 +938,7 @@ Along Route is selected, then you can specify the radius around your route for which maps will be downloaded or deleted. For example, if you specify 4 (the - default), then Maemo Mapper will download all tiles that are + default), then Mapper will download all tiles that are within 4 tiles of your route. @@ -965,7 +965,7 @@ POI Categories - + POI Categories are a means by which you can organize your POIs for selective display. The POI Categories @@ -1006,11 +1006,11 @@ Settings - + The Settings dialog (accessible from the main menu) provides access to a plethora of configurable options - that control how Maemo Mapper appears and runs. In addition to the + that control how Mapper appears and runs. In addition to the tabs, which are described below, there are also two buttons at the bottom of the diagram labeled Hardware Keys... and Colors.... @@ -1028,10 +1028,10 @@ GPS - The GPS tab tells Maemo Mapper which + The GPS tab tells Mapper which bluetooth device from which to retrieve GPS data. It is only applicable if you have a bluetooth GPS receiver with which to use - Maemo Mapper. + Mapper. Enter the MAC address in the field provided. If you don't know the @@ -1043,13 +1043,13 @@ Alternatively, if you are using rfcomm or any other file-system-based NMEA input source, you can provide a pathname (beginning with a leading slash) such as "/dev/rfcomm1". In this - case, Maemo Mapper will read NMEA sentences from the file system + case, Mapper will read NMEA sentences from the file system instead of via bluetooth. Auto-Center The Auto-Center tab allows you to - configure how Maemo Mapper automatically re-centers the display when + configure how Mapper automatically re-centers the display when either Lat/Lon or Lead is enabled from the Auto-Center menu. The Auto-Center @@ -1058,16 +1058,16 @@ Sensitivity - Controls how often - Maemo Mapper re-centers the display, based on how close your + Mapper re-centers the display, based on how close your position (or the position of your lead) gets to the edge of - the screen. When set to a low value, Maemo Mapper will only + the screen. When set to a low value, Mapper will only re-center the screen when you are near the edge of the screen. - When set to the maximum, Maemo Mapper will keep your position as + When set to the maximum, Mapper will keep your position as close to the center as possible. Lead Amount - When Auto-Center is set - to Lead, then Maemo Mapper will keep + to Lead, then Mapper will keep the center of the screen focused on an area in front of you. When driving, this allows you to view more of the road ahead of you. The distance in front of you on which the screen is centered is @@ -1078,15 +1078,15 @@ Announce The Announce tab controls how and when - Maemo Mapper displays or speaks waypoint information. When you + Mapper displays or speaks waypoint information. When you approach a waypoint in your route (defined by the presence of a - description in the GPX file), Maemo Mapper will pop up a text box + description in the GPX file), Mapper will pop up a text box with the contents of that description. When downloading routes from - within Maemo Mapper, the text describes your next action, e.g. "Turn + within Mapper, the text describes your next action, e.g. "Turn left at Main Street. Go 2.4 miles." - As you approach a waypoint, Maemo Mapper will continue to display + As you approach a waypoint, Mapper will continue to display the description of that waypoint, so long as you are within the range defined by the Advance Notice option, or until you pass the waypoint. Because the amount of @@ -1098,9 +1098,9 @@ If you have installed flite, which is available in the same - repository from which you downloaded Maemo Mapper, then Maemo Mapper + repository from which you downloaded Mapper, then Mapper can optionally also speak the same directions that appear on screen. - Maemo Mapper will only speak the directions once, at the exact + Mapper will only speak the directions once, at the exact moment you first reach the distance from the waypoint defined by the Advance Notice option. The same directions are on-screen if you need to reference them. @@ -1108,17 +1108,17 @@ Advance Notice - Controls how much in - advance Maemo Mapper begins to provide the waypoint description. - The exact distance at which Maemo Mapper begins to announce a + advance Mapper begins to provide the waypoint description. + The exact distance at which Mapper begins to announce a waypoint also depends on your speed, so the value of this option can be thought of more accurately in units of time. At the - minimum value, Maemo Mapper gives you almost no notice. At the - maximum value, Maemo Mapper gives you about two minutes of notice. + minimum value, Mapper gives you almost no notice. At the + maximum value, Mapper gives you about two minutes of notice. Experiment to find your happy medium. Enable Voice Synthesis - If you have - installed flite, this option will cause Maemo Mapper to + installed flite, this option will cause Mapper to speak the description of the next waypoint when you enter the range defined by the Advance Notice option. @@ -1137,10 +1137,10 @@ Keep Display On Only in Fullscreen - Mode - Controls whether or not Maemo Mapper + Mode - Controls whether or not Mapper should limit its "Keep the display on" behavior to full screen - mode only. If disabled, then Maemo Mapper will always keep the - screen on, as long as you are moving. If enabled, Maemo Mapper + mode only. If disabled, then Mapper will always keep the + screen on, as long as you are moving. If enabled, Mapper will only keep the screen on in full screen mode. @@ -1176,7 +1176,7 @@ POI database - The location on the file system where the POI database is located. The database must be in sqlite3 format. A default (empty) POI database is - automatically created for you when you first run Maemo Mapper. + automatically created for you when you first run Mapper. Show POI below zoom - Defines the @@ -1186,17 +1186,15 @@ - About Maemo Mapper - + About Mapper + Current Version: __VERSION__ - Maemo Mapper was created and developed by John Costigan (aka - gnuite). + Mapper is developed by Kaj-Michael Lang. - - Copyright © 2006-2007 John Costigan. + Mapper is based on Maemo Mapper by John Costigan. Copyright © 2006-2007 John Costigan. POI and GPS-Info code originally written by Cezary Jackiewicz. @@ -1204,12 +1202,12 @@ Default map data provided by http://www.openstreetmap.org/ - other map repositories are subject to their own licenses and may or may not - be suitable for use with Maemo Mapper. It may be illegal to use a - certain repository with Maemo Mapper or under certain conditions. This - includes the repositories downloadable directly in Maemo Mapper. If + be suitable for use with Mapper. It may be illegal to use a + certain repository with Mapper or under certain conditions. This + includes the repositories downloadable directly in Mapper. If you are not sure if you are legally allowed to use a particular repository, you should delete it from your list of repositories. The - authors of Maemo Mapper cannot be held responsible for your use of a + authors of Mapper cannot be held responsible for your use of a particular repository. -- 2.39.5