<?xml version="1.0" encoding="UTF-8"?>
<ossohelpsource>
<folder>
- <title>Maemo Mapper</title>
+ <title>Mapper</title>
<topic>
<topictitle>Introduction</topictitle>
- <context contextUID="help_maemomapper_intro"/>
- <para>Welcome to Maemo Mapper.</para>
+ <context contextUID="help_mapper_intro"/>
+ <para>Welcome to Mapper.</para>
<para>
- Maemo Mapper is a geographical mapping tool that can be used to:
+ Mapper is a geographical mapping tool that can be used to:
</para>
<list>
<listitem>
</listitem>
</list>
<para>
- Use the <ref refid="help_maemomapper_" refdoc="index"/> to peruse the
+ Use the <ref refid="help_mapper_" refdoc="index"/> to peruse the
various sections of this help document, or go to <ref
- refid="help_maemomapper_getstarted" refdoc="Getting Started"/> to
+ refid="help_mapper_getstarted" refdoc="Getting Started"/> to
get up and running quickly.
</para>
</topic>
<topic>
<topictitle>Getting Started</topictitle>
- <context contextUID="help_maemomapper_getstarted"/>
+ <context contextUID="help_mapper_getstarted"/>
<para>
- When you first start Maemo Mapper, you will be presented with the
+ When you first start Mapper, you will be presented with the
<display_text>Settings</display_text> dialog box. Most of the
settings have reasonable defaults, but if you have a GPS receiver,
you should fill in the <display_text>MAC</display_text> field with
the MAC address of your GPS receiver. If you don't know the MAC,
turn on your GPS receiver and push the
- <display_text>Search</display_text> button. Maemo Mapper will
+ <display_text>Search</display_text> button. Mapper will
attempt to automatically discover the MAC address of your receiver.
For more information about the <display_text>Settings</display_text>
- dialog box, see <ref refid="help_maemomapper_settings"
+ dialog box, see <ref refid="help_mapper_settings"
refdoc="Settings"/>.
</para>
<para>
- When you are finished setting up Maemo Mapper to your preferences,
+ When you are finished setting up Mapper to your preferences,
pressing the <display_text>Ok</display_text> button will lead you to
another dialog box: the <display_text>Manage
Repositories</display_text> dialog.
</para>
<para>
To get started quickly, press the
- <display_text>Download...</display_text> button. Maemo Mapper will
+ <display_text>Download...</display_text> 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
<display_text>Default</display_text> repository. For more
information about repositories and the <display_text>Manage
Repositories</display_text> dialog, see
- <ref refid="help_maemomapper_repoman"
+ <ref refid="help_mapper_repoman"
refdoc="Managing Repositories"/>.
</para>
<para>
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
<display_text>Download...</display_text> 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.
</para>
<para>
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
<display_text>Auto-Download</display_text> checkbox in the
<display_text>Maps</display_text> menu.
</para>
<para>
- 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
- <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/> for
+ <ref refid="help_mapper_mapman" refdoc="Managing Maps"/> for
details on how to manage disk space for a particular repository.
</para>
<heading>The Graphical User Interface</heading>
<para>
- 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
</para>
<para>
For help with any of these features, use the
- <ref refid="help_maemomapper_" refdoc="index"/>.
+ <ref refid="help_mapper_" refdoc="index"/>.
</para>
</topic>
<topic>
<topictitle>Main Menu</topictitle>
- <context contextUID="help_maemomapper_mainmenu"/>
+ <context contextUID="help_mapper_mainmenu"/>
<para>
This help topic describes the functionality of each of the menu
- items in Maemo Mapper.
+ items in Mapper.
</para>
<heading>Route</heading>
<para>
The <display_text>Route</display_text> menu is used to manipulate
- the current <i>route</i>. A route in Maemo Mapper is defined as a
+ the current <i>route</i>. A route in Mapper is defined as a
set of points and waypoints describing <i>where you would like to
go</i>, e.g. driving directions from 123 Main Street to 456 Elm
Street. It can include multiple segments. The current route is
</listitem>
<listitem>
<display_text>Download...</display_text> - Download a route from
- the internet. See <ref refid="help_maemomapper_downroute"
+ the internet. See <ref refid="help_mapper_downroute"
refdoc="Download Route"/> for more information.
</listitem>
<listitem>
one route segment and the beginning of another route segment).
</listitem>
<listitem>
- <display_text>Reset</display_text> - Reset Maemo Mapper's tracking
+ <display_text>Reset</display_text> - 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.
<heading>Track</heading>
<para>
The <display_text>Track</display_text> menu is used to manipulate
- your current <i>track</i>. A track in Maemo Mapper is defined as
+ your current <i>track</i>. A track in Mapper is defined as
a set of points along which you have been traveling, i.e. <i>where
you have been</i>. It can include multiple segments. Tracks are
most useful if you have enabled a GPS receiver. The current track
<listitem>
<display_text>Manage Maps...</display_text> - Download or delete
maps for the currently selected repository. For more details, see
- <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
+ <ref refid="help_mapper_mapman" refdoc="Managing Maps"/>.
</listitem>
<listitem>
<display_text>Manage Repositories...</display_text> - Configure
each of your available repositories, or add new ones. You can
also download a pre-defined set of repositories. For more
- details, see <ref refid="help_maemomapper_repoman"
+ details, see <ref refid="help_mapper_repoman"
refdoc="Managing Repositories"/>.
</listitem>
<listitem>
- <display_text>Auto-Download</display_text> - Toggle Maemo Mapper's
+ <display_text>Auto-Download</display_text> - 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
<listitem>
<display_text>POI Categories...</display_text> - Define POI
categories and which categories are displayed on the map. For
- more details, see <ref refid="help_maemomapper_poicat" refdoc="POI
+ more details, see <ref refid="help_mapper_poicat" refdoc="POI
Categories"/>.
</listitem>
</list>
<heading>Auto-Center</heading>
<para>
The <display_text>Auto-Center</display_text> 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 <ref
- refid="help_maemomapper_settings" refdoc="Settings"/> Dialog.
+ refid="help_mapper_settings" refdoc="Settings"/> Dialog.
</para>
<para>
There are three different modes of Auto-Center:
<listitem>
<display_text>Enable GPS</display_text> - 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.
</listitem>
<listitem>
<list>
<listitem>
<display_text>Settings...</display_text> - Access and change
- settings for using Maemo Mapper. For more information, see <ref
- refid="help_maemomapper_settings" refdoc="Settings"/>.
+ settings for using Mapper. For more information, see <ref
+ refid="help_mapper_settings" refdoc="Settings"/>.
</listitem>
<listitem>
<display_text>Help...</display_text> - Access this help file.
copyright information.
</listitem>
<listitem>
- <display_text>Close</display_text> - Close Maemo Mapper.
+ <display_text>Close</display_text> - Close Mapper.
</listitem>
</list>
</topic>
<topic>
<topictitle>Context Menu</topictitle>
- <context contextUID="help_maemomapper_cmenu"/>
+ <context contextUID="help_mapper_cmenu"/>
<para>
By tapping and holding on the screen, you can access the context
menu to execute actions on either that location, the nearest route
</listitem>
<listitem>
<display_text>Download Route to...</display_text> - Open the
- <ref refid="help_maemomapper_downroute"
+ <ref refid="help_mapper_downroute"
refdoc="Download Route"/> dialog with the selected location
pre-filled as the destination.
</listitem>
<listitem>
<display_text>Show Description</display_text> - Show the
description attached to the select waypoint. When downloading
- routes via the <ref refid="help_maemomapper_downroute"
+ routes via the <ref refid="help_mapper_downroute"
refdoc="Download Route"/> dialog, the description will contain
the directions needed to take at that waypoint (e.g. "Turn left at
Main Street. Go 2.5 kilometers.").
</listitem>
<listitem>
<display_text>Download Route to...</display_text> - Open the
- <ref refid="help_maemomapper_downroute"
+ <ref refid="help_mapper_downroute"
refdoc="Download Route"/> dialog with the selected waypoint's
location pre-filled as the destination.
</listitem>
</listitem>
<listitem>
<display_text>Download Route to...</display_text> - Open the
- <ref refid="help_maemomapper_downroute"
+ <ref refid="help_mapper_downroute"
refdoc="Download Route"/> dialog with the selected POI's
location pre-filled as the destination.
</listitem>
</topic>
<topic>
<topictitle>Managing Repositories</topictitle>
- <context contextUID="help_maemomapper_repoman"/>
+ <context contextUID="help_mapper_repoman"/>
<para>
- In Maemo Mapper, map data is divided into specific areas called
+ In Mapper, map data is divided into specific areas called
<i>repositories</i>. 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
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
- <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
+ <ref refid="help_mapper_mapman" refdoc="Managing Maps"/>.
</para>
<para>
- 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 <display_text>Manage
Repositories</display_text> dialog is accessed via the
<display_text>Manage Repositories...</display_text> menu item of the
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).
</listitem>
<listitem>
<display_text>View Zoom Steps</display_text> - Similar to the
above-described <display_text>Download Zoom Steps</display_text>
- 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
- <graphic filename="2686KEY_zoom_in"/> causes Maemo Mapper to zoom
+ <graphic filename="2686KEY_zoom_in"/> causes Mapper to zoom
in two levels instead of just one. Setting this equal to
<display_text>Download Zoom Steps</display_text> ensures that you
see all maps at their native resolution.
<display_text>Reset...</display_text> - 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.
</listitem>
<listitem>
<display_text>Download...</display_text> - Downloads information
<note>
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 <display_text>Download...</display_text> 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.
</note>
</topic>
<topic>
<topictitle>Downloading Routes</topictitle>
- <context contextUID="help_maemomapper_downroute"/>
+ <context contextUID="help_mapper_downroute"/>
<para>
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
<display_text>Download Route</display_text> dialog.
</para>
<para>
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
<display_text>Auto-Update</display_text> 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.
</para>
<para>
<listitem>
<display_text>Auto-Update</display_text> - This option, only
available if <display_text>Use GPS Location</display_text> 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.
</topic>
<topic>
<topictitle>Managing Maps</topictitle>
- <context contextUID="help_maemomapper_mapman"/>
+ <context contextUID="help_mapper_mapman"/>
<para>
- In Maemo Mapper, <i>repositories</i> represent sources of map data,
+ In Mapper, <i>repositories</i> represent sources of map data,
and <i>maps</i> are just image files (e.g. PNG or JPEG) that are
drawn onto the screen. Once you have a repository set up (see
- <ref refid="help_maemomapper_repoman"
+ <ref refid="help_mapper_repoman"
refdoc="Managing Repositories"/>), you can download maps from a
repository into a Map Cache, which is just a directory on your
device's file system.
</para>
<para>
- 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
- <i>caching</i>, and it allows you to use Maemo Mapper even when you
+ <i>caching</i>, and it allows you to use Mapper even when you
are not connected to the internet.
</para>
<para>
- 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.
</para>
specify.
</listitem>
<listitem>
- <display_text>By Area</display_text> - If selected, Maemo Mapper
+ <display_text>By Area</display_text> - 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 <display_text>Area</display_text>
<display_text>Along Route</display_text> 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.
</listitem>
</list>
</topic>
<topic>
<topictitle>POI Categories</topictitle>
- <context contextUID="help_maemomapper_poicat"/>
+ <context contextUID="help_mapper_poicat"/>
<para>
POI Categories are a means by which you can organize your POIs for
selective display. The <display_text>POI Categories</display_text>
</topic>
<topic>
<topictitle>Settings</topictitle>
- <context contextUID="help_maemomapper_settings"/>
+ <context contextUID="help_mapper_settings"/>
<para>
The <display_text>Settings</display_text> 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 <display_text>Hardware
Keys...</display_text> and <display_text>Colors...</display_text>.
</para>
<heading>GPS</heading>
<para>
- The <display_text>GPS</display_text> tab tells Maemo Mapper which
+ The <display_text>GPS</display_text> 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.
</para>
<para>
Enter the MAC address in the field provided. If you don't know the
<i>Alternatively</i>, 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.
</para>
<heading>Auto-Center</heading>
<para>
The <display_text>Auto-Center</display_text> tab allows you to
- configure how Maemo Mapper automatically re-centers the display when
+ configure how Mapper automatically re-centers the display when
either <display_text>Lat/Lon</display_text> or
<display_text>Lead</display_text> is enabled from the
<display_text>Auto-Center</display_text> menu. The Auto-Center
<list>
<listitem>
<display_text>Sensitivity</display_text> - 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 <i>lead</i>) 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.
</listitem>
<listitem>
<display_text>Lead Amount</display_text> - When Auto-Center is set
- to <display_text>Lead</display_text>, then Maemo Mapper will keep
+ to <display_text>Lead</display_text>, 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
<heading>Announce</heading>
<para>
The <display_text>Announce</display_text> 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."
</para>
<para>
- 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 <display_text>Advance Notice</display_text>
option, or until you pass the waypoint. Because the amount of
</para>
<para>
If you have installed <i>flite</i>, 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
<display_text>Advance Notice</display_text> option. The same
directions are on-screen if you need to reference them.
<list>
<listitem>
<display_text>Advance Notice</display_text> - 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.
</listitem>
<listitem>
<display_text>Enable Voice Synthesis</display_text> - If you have
- installed <i>flite</i>, this option will cause Maemo Mapper to
+ installed <i>flite</i>, this option will cause Mapper to
speak the description of the next waypoint when you enter the
range defined by the <display_text>Advance Notice</display_text>
option.
</listitem>
<listitem>
<display_text>Keep Display On Only in Fullscreen
- Mode</display_text> - Controls whether or not Maemo Mapper
+ Mode</display_text> - 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.
</listitem>
<listitem>
<display_text>POI database</display_text> - 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.
</listitem>
<listitem>
<display_text>Show POI below zoom</display_text> - Defines the
</list>
</topic>
<topic>
- <topictitle>About Maemo Mapper</topictitle>
- <context contextUID="help_maemomapper_about"/>
+ <topictitle>About Mapper</topictitle>
+ <context contextUID="help_mapper_about"/>
<para>
Current Version: __VERSION__
</para>
<para>
- Maemo Mapper was created and developed by John Costigan (aka
- <display_text>gnuite</display_text>).
+ Mapper is developed by Kaj-Michael Lang.
</para>
- <para>
- Copyright © 2006-2007 John Costigan.
+ <para>Mapper is based on Maemo Mapper by John Costigan. Copyright © 2006-2007 John Costigan.
</para>
<para>
POI and GPS-Info code originally written by Cezary Jackiewicz.
<para>
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.
</para>
<para>
projects / mapper / commitdiff