git.itanic.dy.fi Git - maemo-mapper/blob - data/help/en_US/maemomapper.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <?xml-stylesheet type="text/xsl" href="../tohtml.xsl?root=maemo-mapper"?>
   3
   4 <!--
   5  -
   6  - Copyright (C) 2006 - 2008 John Costigan.
   7  -
   8  - This file is part of Maemo Mapper.
   9  -
  10  - Maemo Mapper is free software: you can redistribute it and/or modify
  11  - it under the terms of the GNU General Public License as published by
  12  - the Free Software Foundation, either version 3 of the License, or
  13  - (at your option) any later version.
  14  -
  15  - Maemo Mapper is distributed in the hope that it will be useful,
  16  - but WITHOUT ANY WARRANTY; without even the implied warranty of
  17  - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  18  - GNU General Public License for more details.
  19  -
  20  - You should have received a copy of the GNU General Public License
  21  - along with Maemo Mapper.  If not, see <http://www.gnu.org/licenses/>.
  22  -
  23 -->
  24
  25 <ossohelpsource>
  26   <folder>
  27     <title>Maemo Mapper</title>
  28     <topic>
  29       <topictitle>Introduction</topictitle>
  30       <context contextUID="help_maemomapper_intro"/>
  31       <para>Welcome to Maemo Mapper.</para>
  32       <para>
  33         Maemo Mapper is a geographical mapping tool that can be used to:
  34       </para>
  35       <list>
  36         <listitem>
  37           Download map data to your device's main memory or to an external
  38           memory card.
  39         </listitem>
  40         <listitem>
  41           View that map data on the screen.
  42         </listitem>
  43         <listitem>
  44           Navigate that map data by panning around the screen and zooming in
  45           and out.
  46         </listitem>
  47         <listitem>
  48           Display your position and other GPS information from a GPS
  49           receiver.
  50         </listitem>
  51         <listitem>
  52           Store and display Point-of-Interest (POI) data.
  53         </listitem>
  54         <listitem>
  55           Download directions between arbitrary points on the map.
  56         </listitem>
  57         <listitem>
  58           Save or open track data or route data.
  59         </listitem>
  60       </list>
  61       <para>
  62         Use the <ref refid="help_maemomapper_" refdoc="index"/> to peruse the
  63         various sections of this help document, or go to <ref
  64           refid="help_maemomapper_getstarted" refdoc="Getting Started"/> to
  65         get up and running quickly.
  66       </para>
  67     </topic>
  68     <topic>
  69       <topictitle>Getting Started</topictitle>
  70       <context contextUID="help_maemomapper_getstarted"/>
  71       <para>
  72         When you first start Maemo Mapper, you will be presented with the
  73         <display_text>Settings</display_text> dialog box.  Most of the
  74         settings have reasonable defaults, but if you have a GPS receiver,
  75         you should fill in the <display_text>Bluetooth</display_text> field
  76         with the MAC address of your GPS receiver.  If you don't know the
  77         MAC, turn on your GPS receiver and push the
  78         <display_text>Search</display_text> button.  Maemo Mapper will
  79         attempt to automatically discover the MAC address of your receiver.
  80         For more information about the <display_text>Settings</display_text>
  81         dialog box, see <ref refid="help_maemomapper_settings"
  82           refdoc="Settings"/>.
  83       </para>
  84       <para>
  85         Alternatively, you can leave the
  86         <display_text>Bluetooth</display_text> field blank, and Maemo Mapper
  87         will attempt to automatically search for and use any bluetooth GPS
  88         receivers that it can identify.  This is particularly useful if you
  89         tend to use multiple different GPS receivers.  This feature is not
  90         guaranteed to work on all Nokia devices or with all bluetooth GPS
  91         receivers.
  92       </para>
  93       <note>
  94         If you are using Maemo Mapper on a device with an internal GPS
  95         receiver, then you should probably use the "Bluetooth" receiver type
  96         and leave the field empty.
  97       </note>
  98       <para>
  99         When you are finished setting up Maemo Mapper to your preferences,
 100         pressing the <display_text>Ok</display_text> button will lead you to
 101         another dialog box: the <display_text>Manage
 102           Repositories</display_text> dialog.
 103       </para>
 104       <para>
 105         To get started quickly, press the
 106         <display_text>Download...</display_text> button.  Maemo Mapper will
 107         download a set of pre-defined repository information for you to use.
 108         If you use the pre-defined repositories, you can delete the
 109         <display_text>Default</display_text> repository.  For more
 110         information about repositories and the <display_text>Manage
 111           Repositories</display_text> dialog, see
 112         <ref refid="help_maemomapper_repoman"
 113           refdoc="Managing Repositories"/>.
 114       </para>
 115       <para>
 116         Certain repositories (most notably, the commercial ones) may have
 117         license agreements attached with their use.  It may be illegal to
 118         use a certain repository with Maemo Mapper or under certain
 119         conditions.  This includes the repositories downloaded via the
 120         <display_text>Download...</display_text> button.  If you are not
 121         sure if you are legally allowed to use a particular repository, you
 122         should delete it from your list of repositories.  The authors of
 123         Maemo Mapper cannot be held responsible for your use of a particular
 124         repository.
 125       </para>
 126       <para>
 127         Once you have your Repositories set up the way you like, press the
 128         Ok button, and you will be presented with a blank screen, because
 129         you have not yet actually downloaded any map data to your device.
 130         To allow Maemo Mapper to automatically download map data as it
 131         becomes needed on the display, enable the
 132         <display_text>Auto-Download</display_text> checkbox in the
 133         <display_text>Maps</display_text> menu.
 134       </para>
 135       <para>
 136         If you have a working internet connection, Maemo Mapper will attempt
 137         to download maps and display them on the screen automatically as
 138         the downloads complete.  You should see a map of the world.  Be
 139         careful when you enable Auto-Download, because it can quickly fill
 140         your available disk space.  See
 141         <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/> for
 142         details on how to manage disk space for a particular repository.
 143       </para>
 144       <heading>The Graphical User Interface</heading>
 145       <para>
 146         The main view of Maemo Mapper emphasizes simplicity.  By default,
 147         the map is all that is displayed.  You current position (if you have
 148         a GPS receiver) is indicated by a blue circle.  The blue line
 149         extending from the blue circle indicates your current heading and
 150         speed.  <i>Tracks</i> are red and represent where you have been.
 151         <i>Routes</i> are green and represent where you want to go, i.e.
 152         directions to a location.
 153       </para>
 154       <para>
 155         The hardware buttons on your device provide quick access to common
 156         functionality:
 157       </para>
 158       <list>
 159         <listitem>
 160           <graphic filename="2686KEY_full_screen"/> - Toggle
 161           Full-Screen Mode
 162         </listitem>
 163         <listitem>
 164           <graphic filename="2686KEY_zoom_in"/> - Zoom In - hold down to
 165           zoom multiple levels at a time
 166         </listitem>
 167         <listitem>
 168           <graphic filename="2686KEY_zoom_out"/> - Zoom Out - hold down to
 169           zoom multiple levels at a time
 170         </listitem>
 171         <listitem>
 172           <graphic filename="2686KEY_scroll_up"/> - Pan Up - hold down to
 173           scroll
 174         </listitem>
 175         <listitem>
 176           <graphic filename="2686KEY_scroll_down"/> - Pan Down - hold down
 177           to scroll
 178         </listitem>
 179         <listitem>
 180           <graphic filename="2686KEY_scroll_left"/> - Pan Left - hold down
 181           to scroll
 182         </listitem>
 183         <listitem>
 184           <graphic filename="2686KEY_scroll_right"/> - Pan Right - hold down
 185           to scroll
 186         </listitem>
 187         <listitem>
 188           <graphic filename="2686KEY_scroll_center"/> - Toggle Auto-Center
 189         </listitem>
 190         <listitem>
 191           <graphic filename="2686KEY_esc"/> - Programmable; defaults
 192           to: Hide/Show Tracks and Routes
 193         </listitem>
 194       </list>
 195       <para>
 196         You can also pan around the map by tapping on the screen.  Maemo
 197         Mapper will center the display on where you tapped.  If you had
 198         <display_text>Auto-Center</display_text> enabled, tapping a location
 199         to center on it will automatically disable that functionality.
 200       </para>
 201       <para>
 202         From this point, you can use the menus to manage routes, tracks, and
 203         map data; to change the view; to change settings; or to see detailed
 204         GPS information (if you have a GPS receiver).
 205       </para>
 206       <para>
 207         There is also a context-sensitive menu that appears on the map when
 208         you tap and hold a location on the map.  From that menu, you can
 209         download directions, calculate distances, or add/modify
 210         Point-of-Interest (POI) data.
 211       </para>
 212       <para>
 213         For help with any of these features, use the
 214         <ref refid="help_maemomapper_" refdoc="index"/>.
 215       </para>
 216     </topic>
 217     <topic>
 218       <topictitle>Main Menu</topictitle>
 219       <context contextUID="help_maemomapper_mainmenu"/>
 220       <para>
 221         This help topic describes the functionality of each of the menu
 222         items in Maemo Mapper.
 223       </para>
 224       <heading>Route</heading>
 225       <para>
 226         The <display_text>Route</display_text> menu is used to manipulate
 227         the current <i>route</i>.  A route in Maemo Mapper is defined as a
 228         set of points and waypoints describing <i>where you would like to
 229           go</i>, e.g. driving directions from 123 Main Street to 456 Elm
 230         Street.  It can include multiple segments.  The current route is
 231         empty until you open or download a route.
 232       </para>
 233       <para>
 234         The <display_text>Route</display_text> menu has the following menu
 235         items:
 236       </para>
 237       <list>
 238         <listitem>
 239           <display_text>Open...</display_text> - Open a route from a GPX
 240           file on the file system.  The opened route is <i>appended</i> to
 241           the current route, so you can string together different routes
 242           together to create a trip with multiple destinations.
 243         </listitem>
 244         <listitem>
 245           <display_text>Download...</display_text> - Download a route from
 246           the internet.  See <ref refid="help_maemomapper_downroute"
 247             refdoc="Download Route"/> for more information.
 248         </listitem>
 249         <listitem>
 250           <display_text>Save...</display_text> - Save the current route to a
 251           GPX file on the file system.
 252         </listitem>
 253         <listitem>
 254           <display_text>Show Distance to Next Waypoint</display_text> - Show
 255           the distance left to be traveled (along the current route) until
 256           the next waypoint.
 257         </listitem>
 258         <listitem>
 259           <display_text>Show Distance to End of Route</display_text> - Show
 260           the distance left to be traveled (along the current route) until
 261           the end of the current route.  The calculated distance includes
 262           the distance between breaks in the route (i.e. between the end of
 263           one route segment and the beginning of another route segment).
 264         </listitem>
 265         <listitem>
 266           <display_text>Reset</display_text> - Reset Maemo Mapper's tracking
 267           of your progress along the current route.  Use this if Maemo
 268           Mapper loses track of where you are with respect to the current
 269           route.
 270         </listitem>
 271         <listitem>
 272           <display_text>Reset</display_text> - Clear the current route,
 273           effectively replacing it with an empty route.
 274         </listitem>
 275       </list>
 276       <heading>Track</heading>
 277       <para>
 278         The <display_text>Track</display_text> menu is used to manipulate
 279         your current <i>track</i>.  A track in Maemo Mapper is defined as
 280         a set of points along which you have been traveling, i.e.  <i>where
 281           you have been</i>.  It can include multiple segments.  Tracks are
 282         most useful if you have enabled a GPS receiver.  The current track
 283         is empty until you get at least one valid position point from your
 284         GPS receiver, and it is appendeded to whenever you stray far enough
 285         from the last track point.
 286       </para>
 287       <para>
 288         The <display_text>Track</display_text> menu has the following menu
 289         items:
 290       </para>
 291       <list>
 292         <listitem>
 293           <display_text>Open...</display_text> - Open a track from a GPX
 294           file on the file system.  In contrast to route data, the opened
 295           track is <i>prepended</i> to the current track, so if you are
 296           trying to rebuild previous track data, you must open the tracks
 297           backward in time (most recent tracks first).
 298         </listitem>
 299         <listitem>
 300           <display_text>Save...</display_text> - Save the current track to a
 301           GPX file on the file system.
 302         </listitem>
 303         <listitem>
 304           <display_text>Insert Break</display_text> - Artificially insert a
 305           break in your current track data.  This simulates the loss and
 306           re-acquisition of a GPS fix, and it can be used to track, for
 307           example, refueling stops.
 308         </listitem>
 309         <listitem>
 310           <display_text>Insert Mark</display_text> - Artificially insert a
 311           mark with a description in your current track data.  This can be
 312           used to mark important landmarks.
 313         </listitem>
 314         <listitem>
 315           <display_text>Show Distance from Last Break</display_text> - Show
 316           the distance traveled (along the current track) since the last
 317           break.
 318         </listitem>
 319         <listitem>
 320           <display_text>Show Distance from Beginning</display_text> - Show
 321           the distance traveled (along the current track) since the
 322           beginning of the track.  The calculated distance includes the
 323           distance between breaks in the track (i.e. between when a GPS fix
 324           is lost and later re-acquired).
 325         </listitem>
 326         <listitem>
 327           <display_text>Clear</display_text> - Clear the current track,
 328           effectively replacing it with an empty track.
 329         </listitem>
 330         <listitem>
 331           <display_text>Enable Tracking</display_text> - This checkbox
 332           controls whether or not Maemo Mapper keeps track of your location
 333           as you move.  If enabled, your track will be recorded to file,
 334           which can be exported to GPX via the "Save..." menu item.  Maemo
 335           Mapper cannot draw your track on-screen if this checkbox is
 336           disabled.
 337         </listitem>
 338       </list>
 339       <heading>Maps</heading>
 340       <para>
 341         The <display_text>Maps</display_text> menu is used to control your
 342         map repositories.  This menu will be populated with a list of all of
 343         your map repositories, from which you can select to switch to a
 344         particular repository.
 345       </para>
 346       <para>
 347         The <display_text>Maps</display_text> menu has the following menu
 348         items in addition to the list of available repositories:
 349       </para>
 350       <list>
 351         <listitem>
 352           <display_text>Manage Maps...</display_text> - Download or delete
 353           maps for the currently selected repository.  For more details, see
 354           <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
 355         </listitem>
 356         <listitem>
 357           <display_text>Manage Repositories...</display_text> - Configure
 358           each of your available repositories, or add new ones.  You can
 359           also download a pre-defined set of repositories.  For more
 360           details, see <ref refid="help_maemomapper_repoman"
 361             refdoc="Managing Repositories"/>.
 362         </listitem>
 363         <listitem>
 364           <display_text>Auto-Download</display_text> - Toggle Maemo Mapper's
 365           ability to automatically download maps as they are needed in order
 366           to fill the screen with map data.  This is useful for arbitrary
 367           exploration of the world while connected to the internet, or if
 368           you have a constant connection to the internet (i.e. via a
 369           cellular data service).
 370         </listitem>
 371       </list>
 372       <heading>View</heading>
 373       <para>
 374         The <display_text>View</display_text> menu allows you to customize
 375         the view by showing or hiding certain features of the display.
 376       </para>
 377       <para>
 378         The <display_text>View</display_text> menu has the following menu
 379         items:
 380       </para>
 381       <list>
 382         <listitem>
 383           <display_text>Zoom In</display_text> - Zoom in by one zoom level.
 384           You can also use the <graphic
 385             filename="2686KEY_zoom_in"/> button.
 386         </listitem>
 387         <listitem>
 388           <display_text>Zoom Out</display_text> - Zoom out by one zoom
 389           level.  You can also use the <graphic
 390             filename="2686KEY_zoom_out"/> button.
 391         </listitem>
 392         <listitem>
 393           <display_text>Full Screen</display_text> - Toggle full-screen
 394           mode.  You can also use the <graphic
 395             filename="2686KEY_full_screen"/> button to toggle
 396           full-screen mode.
 397         </listitem>
 398         <listitem>
 399           <display_text>Scale</display_text> - Toggle the display of the
 400           scale.
 401         </listitem>
 402         <listitem>
 403           <display_text>Route</display_text> - Toggle the display of routes.
 404         </listitem>
 405         <listitem>
 406           <display_text>Track</display_text> - Toggle the display of tracks.
 407         </listitem>
 408         <listitem>
 409           <display_text>Velocity Vector</display_text> - Toggle the display
 410           of the velocity vector (the blue line extending from the blue
 411           circle that represents your current location).
 412         </listitem>
 413         <listitem>
 414           <display_text>POIs</display_text> - Toggle the display of POIs.
 415         </listitem>
 416         <listitem>
 417           <display_text>POI Categories...</display_text> - Define POI
 418           categories and which categories are displayed on the map.  For
 419           more details, see <ref refid="help_maemomapper_poicat" refdoc="POI
 420             Categories"/>.
 421         </listitem>
 422       </list>
 423       <heading>Auto-Center</heading>
 424       <para>
 425         The <display_text>Auto-Center</display_text> menu is used to control
 426         whether or not Maemo Mapper should re-center the display as your
 427         current location changes.  The sensitivity of re-centering (how
 428         close you get to the edge of the display before Maemo Mapper
 429         re-centers the display) can be configured in the <ref
 430           refid="help_maemomapper_settings" refdoc="Settings"/> Dialog.
 431       </para>
 432       <para>
 433         There are three different modes of Auto-Center:
 434       </para>
 435       <list>
 436         <listitem>
 437           <display_text>Lat/Lon</display_text> - Keep your location centered
 438           on the display.
 439         </listitem>
 440         <listitem>
 441           <display_text>Lead</display_text> - Depending on your speed, keep
 442           a location in front of you centered on the screen.  The faster you
 443           are going, the more lead distance is used.
 444         </listitem>
 445         <listitem>
 446           <display_text>None</display_text> - Do no re-center the display
 447           automatically.
 448         </listitem>
 449       </list>
 450       <heading>Go to</heading>
 451       <para>
 452         The <display_text>Go to</display_text> menu is used to center the
 453         view on a particular location.
 454       </para>
 455       <para>
 456         The <display_text>Go to</display_text> menu has the following menu
 457         items:
 458       </para>
 459       <list>
 460         <listitem>
 461           <display_text>Lat/Lon...</display_text> - Specify an exact
 462           Latitude and Longitude on which to center the display.
 463         </listitem>
 464         <listitem>
 465           <display_text>GPS Position</display_text> - Center the display on
 466           your current GPS position.  This is the manual counter-part of
 467           the <display_text>Auto-Center</display_text> functionality
 468           mentioned above.
 469         </listitem>
 470         <listitem>
 471           <display_text>Next Waypoint</display_text> - Center the display on
 472           the next waypoint in your route.  By default, the next waypoint is
 473           colored a slightly darker green than normal waypoints.
 474         </listitem>
 475         <listitem>
 476           <display_text>Nearest POI</display_text> - Center the display on
 477           the enabled POI nearest to the current view center.
 478         </listitem>
 479       </list>
 480       <heading>GPS</heading>
 481       <para>
 482         The <display_text>GPS</display_text> menu is used to access features
 483         of the GPS receiver, including textual information not displayed on
 484         the map.  It is also used to control your connection to the GPS
 485         receiver.
 486       </para>
 487       <list>
 488         <listitem>
 489           <display_text>Enable GPS</display_text> - Toggle communication
 490           with a GPS receiver.  You must have a GPS receiver set up in order
 491           to use this menu item.  When on, Maemo Mapper will constantly
 492           search for the GPS receiver.
 493         </listitem>
 494         <listitem>
 495           <display_text>Show Information</display_text> - Toggle display of
 496           additional information provided by the GPS receiver.  This
 497           information will appear in the main display as a panel on the
 498           left.
 499         </listitem>
 500         <listitem>
 501           <display_text>Details...</display_text> - Show even more
 502           information provided by the GPS receiver, including a polar plot
 503           of all GPS satellites in view.
 504         </listitem>
 505         <listitem>
 506           <display_text>Reset Bluetooth</display_text> - Attempt to reset
 507           the bluetooth radio, in case it locks up for some reason.  In
 508           order for this to succeed, you <i>must</i> add the following line
 509           to your /etc/sudoers file (if you don't know what that means,
 510           don't try it): <b>user ALL = NOPASSWD: /usr/sbin/hciconfig hci0
 511             reset</b>
 512         </listitem>
 513       </list>
 514       <heading>Other</heading>
 515       <para>
 516         In addition to the above menus, there are a few other items in the
 517         main menu:
 518       </para>
 519       <list>
 520         <listitem>
 521           <display_text>Settings...</display_text> - Access and change
 522           settings for using Maemo Mapper.  For more information, see <ref
 523             refid="help_maemomapper_settings" refdoc="Settings"/>.
 524         </listitem>
 525         <listitem>
 526           <display_text>Help...</display_text> - Access this help file.
 527         </listitem>
 528         <listitem>
 529           <display_text>About...</display_text> - Display version and
 530           copyright information.
 531         </listitem>
 532         <listitem>
 533           <display_text>Close</display_text> - Close Maemo Mapper.
 534         </listitem>
 535       </list>
 536     </topic>
 537     <topic>
 538       <topictitle>Context Menu</topictitle>
 539       <context contextUID="help_maemomapper_cmenu"/>
 540       <para>
 541         By tapping and holding on the screen, you can access the context
 542         menu to execute actions on either that location, the nearest route
 543         waypoint, or the nearest POI.
 544       </para>
 545       <para>
 546         The context menu is separated into two hierarchical levels.  The
 547         first level (<display_text>Location</display_text>,
 548         <display_text>Waypoint</display_text>, or
 549         <display_text>POI</display_text>) determines what kind of data on
 550         which the operation applies.
 551       </para>
 552       <heading>Location</heading>
 553       <para>
 554         The <display_text>Location</display_text> submenu performs actions
 555         on the exactly latitude and longitude on which the tap-and-hold
 556         operation was performed.  With that location, you can do the
 557         following actions:
 558       </para>
 559       <list>
 560         <listitem>
 561           <display_text>Show Lat/Lon</display_text> - Display the latitude
 562           and longitude of the selected location, in the style chosen in
 563           <display_text>Settings</display_text>
 564         </listitem>
 565         <listitem>
 566           <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
 567           longitude of the selected location to the clipboard, in
 568           comma-separated decimal format.
 569         </listitem>
 570         <listitem>
 571           <display_text>Show Distance to</display_text> - Display the
 572           distance (in a straight line) to the selected location.
 573         </listitem>
 574         <listitem>
 575           <display_text>Download Route to...</display_text> - Open the
 576           <ref refid="help_maemomapper_downroute"
 577             refdoc="Download Route"/> dialog with the selected location
 578           pre-filled as the destination.
 579         </listitem>
 580         <listitem>
 581           <display_text>Add Route Point</display_text> - Add a point to the
 582           current route, based on the selected location.  The point is not a
 583           waypoint.
 584         </listitem>
 585         <listitem>
 586           <display_text>Add Waypoint...</display_text> - Add a waypoint
 587           to the current route, based on the selected location.  You must
 588           provide a description for the waypoint to be legitimate.  By
 589           specifying an empty description, however, you can create a break
 590           in the route.  The break will not be connected to the rest of the
 591           route, so it can be used to start a new segment.
 592         </listitem>
 593         <listitem>
 594           <display_text>Add POI...</display_text> - Add a POI to the POI
 595           database, based on the selected location.  If the category in
 596           which you place the POI is disabled, it will not be visible on the
 597           map after creation, but it will still be in the database.
 598         </listitem>
 599         <listitem>
 600           <display_text>Set as GPS Position</display_text> - Force Maemo
 601           Mapper to consider the selected location to be the current GPS
 602           location.  This will not affect the current track, but it will
 603           change the location of the blue circle that represents your
 604           current location, and it can be used to calculate a route from
 605           that location.
 606         </listitem>
 607         <listitem>
 608           <display_text>Apply Map Correction</display_text> - Enables and
 609           disables the application of map correction.  When enabling map
 610           correction, the tap point is used as the correction reference point.
 611           See the note below for more details.
 612         </listitem>
 613       </list>
 614       <note>
 615         Map Correction is a little-used feature that corrects a rare problem
 616         with map data.  In some locations around the world (like Brazil and
 617         Québec), road data from a particular map repository may not be
 618         accurate, although the error is consistent.  For example, as you
 619         travel, you may find that your actual track (as indicated by your
 620         GPS receiver) is a few hundred meters away from the road on which
 621         Maemo Mapper is drawing your current position.  Map Correction fixes
 622         this.  When your GPS receiver has an accurate fix, and if Maemo
 623         Mapper shows your current location as somewhere other than where you
 624         expect to be, simply tap-and-hold on the location on the map where
 625         you think your current location <i>should</i> be drawn, then select
 626         this context menu item.  The correction is saved as part of your
 627         configuration (so it persists even if you restart Maemo Mapper or
 628         your device).
 629       </note>
 630       <heading>Waypoint</heading>
 631       <para>
 632         The <display_text>Waypoint</display_text> submenu performs actions
 633         on the waypoint nearest to the point on which the tap-and-hold
 634         operation was performed.  If no waypoints are nearby, an error
 635         message will be displayed.
 636       </para>
 637       <list>
 638         <listitem>
 639           <display_text>Show Lat/Lon</display_text> - Show the latitude and
 640           longitude of the selected waypoint, in the style chosen in
 641           <display_text>Settings</display_text>.
 642         </listitem>
 643         <listitem>
 644           <display_text>Show Description</display_text> - Show the
 645           description attached to the select waypoint.  When downloading
 646           routes via the <ref refid="help_maemomapper_downroute"
 647             refdoc="Download Route"/> dialog, the description will contain
 648           the directions needed to take at that waypoint (e.g. "Turn left at
 649           Main Street.  Go 2.5 kilometers.").
 650         </listitem>
 651         <listitem>
 652           <display_text>Copy Lat/Lon</display_text> - Copy the latitude and
 653           longitude of the selected waypoint to the clipboard, in
 654           comma-separated decimal format.
 655         </listitem>
 656         <listitem>
 657           <display_text>Copy Description</display_text> - Copy the
 658           description of the waypoint to the clipboard.
 659         </listitem>
 660         <listitem>
 661           <display_text>Show Distance to</display_text> - Show the distance
 662           left to be traveled (along the current route) until the selected
 663           waypoint.  The calculated distance includes the distance between
 664           breaks in the route (i.e. between the end of one route segment and
 665           the beginning of another route segment).
 666         </listitem>
 667         <listitem>
 668           <display_text>Download Route to...</display_text> - Open the
 669           <ref refid="help_maemomapper_downroute"
 670             refdoc="Download Route"/> dialog with the selected waypoint's
 671           location pre-filled as the destination.
 672         </listitem>
 673         <listitem>
 674           <display_text>Delete...</display_text> - Delete the selected
 675           waypoint from the current route.  This will delete all route
 676           segments surrounding the route, including (and limited to) all the
 677           points from that waypoint to the next and previous waypoints.
 678         </listitem>
 679         <listitem>
 680           <display_text>Add POI...</display_text> - Add a POI to the POI
 681           database, based on the selected waypoint's location.  If the
 682           category in which you place the POI is disabled, it will not be
 683           visible on the map after creation, but it will still be in the
 684           database.
 685         </listitem>
 686       </list>
 687       <heading>POI</heading>
 688       <para>
 689         The <display_text>POI</display_text> submenu performs actions
 690         on the POI nearest to the point on which the tap-and-hold operation
 691         was performed.  If no POIs are nearby, an error message will be
 692         displayed.
 693       </para>
 694       <list>
 695         <listitem>
 696           <display_text>View/Edit</display_text> - View and/or edit the
 697           selected POI.
 698         </listitem>
 699         <listitem>
 700           <display_text>Show Distance to</display_text> - Display the
 701           distance (in a straight line) to the selected POI.
 702         </listitem>
 703         <listitem>
 704           <display_text>Download Route to...</display_text> - Open the
 705           <ref refid="help_maemomapper_downroute"
 706             refdoc="Download Route"/> dialog with the selected POI's
 707           location pre-filled as the destination.
 708         </listitem>
 709         <listitem>
 710           <display_text>Add Route Point</display_text> - Add a point to the
 711           current route, based on the selected POI's location.  The point is
 712           not a waypoint.
 713         </listitem>
 714         <listitem>
 715           <display_text>Add Waypoint...</display_text> - Add a waypoint
 716           to the current route, based on the selected location.  You must
 717           provide a description for the waypoint to be legitimate.  By
 718           specifying an empty description, however, you can create a break
 719           in the route.  The break will not be connected to the rest of the
 720           route, so it can be used to start a new segment.
 721         </listitem>
 722       </list>
 723     </topic>
 724     <topic>
 725       <topictitle>Managing Repositories</topictitle>
 726       <context contextUID="help_maemomapper_repoman"/>
 727       <para>
 728         In Maemo Mapper, map data is divided into specific units called
 729         <i>repositories</i>.  A repository is a source of map data, each of
 730         which has its own way of visualizing the Earth.  For example,
 731         repositories based on street maps typically draw roads as lines and
 732         buildings as areas, whereas repositories based on satellite data
 733         draw the Earth as it would appear from space.  There are also
 734         "hybrid" repositories that overlay street map data on top of
 735         satellite data, as well as topographical maps that show altitude
 736         data.
 737       </para>
 738       <para>
 739         Each repository is made up of maps at 16 different zoom levels.
 740         Zoom Level 0 is the highest resolution (closest to the Earth, i.e.
 741         "zoomed in"), and Zoom Level 15 is the lowest resolution (furthest
 742         from the Earth, i.e. "zoomed out").  Not all repositories are
 743         available at all zoom levels, and some repositories may even produce
 744         an error (which you can usually ignore) if you try to download maps
 745         at that zoom level.
 746       </para>
 747       <para>
 748         Once you have set up at least one repository, you can start
 749         downloading maps from that repository to your device's file system.
 750         For details on how to do this, see
 751         <ref refid="help_maemomapper_mapman" refdoc="Managing Maps"/>.
 752       </para>
 753       <para>
 754         You can set up any number of repositories in Maemo Mapper, but only
 755         one can be active at any given time.  The <display_text>Manage
 756           Repositories</display_text> dialog is accessed via the
 757         <display_text>Manage Repositories...</display_text> menu item of the
 758         <display_text>Maps</display_text> menu, and it allows you to add,
 759         edit, and remove repositories.
 760       </para>
 761       <para>
 762         The <display_text>Manage Repositories...</display_text> has a combo
 763         box that controls which repository is being viewed and edited.  When
 764         a repository is selected, the controls below it display the current
 765         settings, which you can change:
 766       </para>
 767       <list>
 768         <listitem>
 769           <display_text>URL Format</display_text> - A specially formatted
 770           string that looks like a URL, but it needs to have at least one
 771           printf-style substitution strings (like %f or %s).  Normally, you
 772           must either get these URL formats from the internet
 773           (www.internettablettalk.com is a good source), or you can use the
 774           <display_text>Download...</display_text> button in the
 775           Repositories dialog box to download a sample.
 776         </listitem>
 777         <listitem>
 778           <display_text>Cache DB</display_text> - A database file on the file
 779           system (either on the device's internal memory, or an external
 780           memory card) in which maps are stored.  Maps are kept here
 781           indefinitely (until you delete them), so pick a location with a
 782           lot of free space.  You can use the
 783           <display_text>Browse...</display_text> button to select the
 784           database file with a graphical file system browser, or you can enter
 785           the filename manually.  The <display_text>Compact...</display_text>
 786           button can be used to compact the database if you have deleted
 787           many maps from your database.  (Otherwise, deleted space is reused
 788           to store new maps.)
 789         </listitem>
 790         <listitem>
 791           <display_text>Download Zoom Steps</display_text> - Controls which
 792           zoom levels should be avoided when automatically downloading maps
 793           (i.e. Auto-Download is enabled).  The lowest setting (one bar)
 794           means to download every zoom level.  The highest setting (four
 795           bars) causes Maemo Mapper to only download every fourth zoom level
 796           (0, 4, 8, and 16).
 797         </listitem>
 798         <listitem>
 799           <display_text>View Zoom Steps</display_text> - Similar to the
 800           above-described <display_text>Download Zoom Steps</display_text>
 801           option, except that it controls how Maemo Mapper behaves when
 802           zooming.  For example, at two bars, pressing
 803           <graphic filename="2686KEY_zoom_in"/> causes Maemo Mapper to zoom
 804           in two levels instead of just one.  Setting this equal to
 805           <display_text>Download Zoom Steps</display_text> ensures that you
 806           see all maps at their native resolution.
 807         </listitem>
 808         <listitem>
 809           <display_text>Double Pixels</display_text> - This forces Maemo
 810           Mapper to avoid using the native resolution of any maps, instead
 811           using pixel-doubling.  This is useful if your repository's maps
 812           contain small, hard-to-read text, and you want to double the size
 813           of the images to make them more readable.  This setting can also
 814           affect the zoom levels that are downloaded when Auto-Download is
 815           enabled.
 816         </listitem>
 817         <listitem>
 818           <display_text>Next-able</display_text> - This oddly-named option
 819           determines whether or not the "Select Next Repository" action
 820           (which can be mapped to any of the hardware keys) will be able to
 821           select this repository.  When unset, the "Select Next Repository"
 822           action will simply skip over this repository.
 823         </listitem>
 824         <listitem>
 825           <display_text>Downloadable Zooms</display_text> - This setting
 826           governs the minimum and maximum zoom levels Maemo Mapper should
 827           attempt to automatically download for this repository (when
 828           Auto-Download is enabled).  Some repositories support more zoom
 829           levels than others, and supported zoom levels may even vary from
 830           location to location.
 831         </listitem>
 832       </list>
 833       <para>
 834         In addition to the per-repository controls, there are a few buttons
 835         that provide additional functionality:
 836       </para>
 837       <list>
 838         <listitem>
 839           <display_text>Rename...</display_text> - Renames the currently
 840           selected repository.
 841         </listitem>
 842         <listitem>
 843           <display_text>Delete...</display_text> - Deletes the currently
 844           selected repository.
 845         </listitem>
 846         <listitem>
 847           <display_text>New...</display_text> - Adds a new repository.  See
 848           <ref refid="help_maemomapper_newrepo" refdoc="New Repositories"/>.
 849         </listitem>
 850         <listitem>
 851           <display_text>Reset...</display_text> - Resets your repository
 852           list to the factory default.  This will remove all of your
 853           repositories and replace them with the single default repository
 854           that comes with Maemo Mapper.
 855         </listitem>
 856         <listitem>
 857           <display_text>Download...</display_text> - Downloads information
 858           about several preset repositories, and adds them to your
 859           repository list.  They will be appended to any existing
 860           repositories you already have.  They are not read-only - you may
 861           edit them as you wish.  This is a good way to get started.
 862         </listitem>
 863       </list>
 864       <note>
 865         Certain repositories (most notably, the commercial ones) may
 866         have license agreements attached with their use.  It may be
 867         illegal to use a certain repository with Maemo Mapper or under
 868         certain conditions.  This includes the repositories downloaded
 869         via the <display_text>Download...</display_text> button.  If you
 870         are not sure if you are legally allowed to use a particular
 871         repository, you should delete it from your list of repositories.
 872         The authors of Maemo Mapper cannot be held responsible for your
 873         use of a particular repository.
 874       </note>
 875     </topic>
 876     <topic>
 877       <topictitle>Repository Types</topictitle>
 878       <context contextUID="help_maemomapper_newrepo"/>
 879       <para>
 880         Over the years, Maemo Mapper has used several different types of
 881         backing databases to store downloaded maps.  Currently, Maemo Mapper
 882         supports two different types of backing map databases.
 883       </para>
 884       <list>
 885         <listitem>
 886           <display_text>SQLite 3 (default)</display_text> - The new default
 887           backing database format since Maemo Mapper v2.6, SQLite 3 provides
 888           better reliability. It also scales somewhat better than GDBM and is
 889           not subject to file size limitations, making it the only choice for
 890           large map databases.  This is the preferred format, and should
 891           generally be used for all new databases.
 892         </listitem>
 893         <listitem>
 894           <display_text>GDBM (legacy)</display_text> - The database format
 895           of versions of Maemo Mapper prior to v2.6.  It is slightly less
 896           reliable than SQLite, and GDBM files are limited to 2 gigabytes.
 897           These limitations, however, allow it to perform slightly faster
 898           than SQLite for small map databases.  If you are unsatisfied with
 899           SQLite's performance in Maemo Mapper, you can take your chances with
 900           GDBM.
 901         </listitem>
 902       </list>
 903     </topic>
 904     <topic>
 905       <topictitle>Managing Maps</topictitle>
 906       <context contextUID="help_maemomapper_mapman"/>
 907       <para>
 908         In Maemo Mapper, <i>repositories</i> represent sources of map data,
 909         and <i>maps</i> are just image files (e.g. PNG or JPEG) that are
 910         drawn onto the screen.  Once you have a repository set up (see
 911         <ref refid="help_maemomapper_repoman"
 912           refdoc="Managing Repositories"/>), you can download maps from a
 913         repository into a Map Cache, which is just a database file on your
 914         device's file system.
 915       </para>
 916       <para>
 917         Maemo Mapper downloads maps from the current repository so that they
 918         can be drawn onto the screen and later recalled from disk, instead
 919         of downloading a map every time it is needed.  This is called
 920         <i>caching</i>, and it allows you to use Maemo Mapper even when you
 921         are not connected to the internet.
 922       </para>
 923       <para>
 924         Because Maemo Mapper downloads maps to your device's file system,
 925         you must be aware of how much disk space your maps are taking up,
 926         especially if you enable Auto-Download.  If space is a concern, you
 927         may also choose to go without a cache entirely.  You can do this by
 928         leaving the Map Cache DB field blank in the <display_text>Manage
 929         Repositories</display_text> dialog.  Note that this will cause Maemo
 930         Mapper to download maps each time they are needed.  If you are using
 931         a cellular data plan that charges per kilobyte, you probably want to
 932         use a cache.  For more information about repositories and the
 933         <display_text>Manage Repositories</display_text> dialog, see
 934         <ref refid="help_maemomapper_repoman"
 935           refdoc="Managing Repositories"/>.
 936       </para>
 937       <para>
 938         Aside from the Auto-Download functionality, you can also download
 939         maps manually using the <display_text>Manage Maps...</display_text>
 940         menu item of the <display_text>Maps</display_text> menu.  The
 941         <display_text>Manage Maps</display_text> dialog allows you to
 942         download, overwrite, or delete maps, either by area or along your
 943         current route.  It contains up to three tabs, all of which control
 944         which and how many maps are downloaded.
 945       </para>
 946       <heading>Setup</heading>
 947       <para>
 948         The <display_text>Setup</display_text> tab controls what you what to
 949         do.  You can download maps (optionally overwriting
 950         already-downloaded maps) from the current repository to your
 951         device's file system, or you can delete maps (pertaining to the
 952         current repository) from your device's file system.  Both of these
 953         operations can be done either over a rectangular area or along your
 954         current route.
 955       </para>
 956       <list>
 957         <listitem>
 958           <display_text>Download Maps</display_text> - If selected, Maemo
 959           Mapper will download maps from the current repository to your
 960           device's file system, for the area you specify.  By default, Maemo
 961           Mapper only downloads the maps that you don't already have.
 962         </listitem>
 963         <listitem>
 964           <display_text>Overwrite</display_text> - If selected, then Maemo
 965           Mapper will download maps and overwrite any maps that you may have
 966           already downloaded.
 967         </listitem>
 968         <listitem>
 969           <display_text>Delete Maps</display_text> - If selected, Maemo
 970           Mapper will delete maps from your file system, for the area you
 971           specify.
 972         </listitem>
 973         <listitem>
 974           <display_text>By Area</display_text> - If selected, Maemo Mapper
 975           will download or delete maps for a particular rectangular area of
 976           the world, based on the latitude and longitude of an upper-left
 977           and lower-right corner.  See the <display_text>Area</display_text>
 978           tab to specify the coordinates.
 979         </listitem>
 980         <listitem>
 981           <display_text>Along Route</display_text> - If selected, Maemo
 982           Mapper will download or delete maps along your current route.
 983           This is useful if, for example, you are about to embark on a trip
 984           and want to make sure that you have maps for all points along the
 985           route.
 986         </listitem>
 987         <listitem>
 988           <display_text>Radius (tiles)</display_text> - If
 989           <display_text>Along Route</display_text> is selected, then you can
 990           specify the radius around your route for which maps will be
 991           downloaded or deleted.  For example, if you specify 4 (the
 992           default), then Maemo Mapper will download all tiles that are
 993           within 4 tiles of your route.
 994         </listitem>
 995       </list>
 996       <heading>Zoom</heading>
 997       <para>
 998         The <display_text>Zoom</display_text> tab controls which zoom levels
 999         at which maps are downloaded or deleted.  The current zoom level is
1000         selected by default, but you can enable or disable any zoom levels
1001         that you like.
1002       </para>
1003       <heading>Area</heading>
1004       <para>
1005         The <display_text>Area</display_text> tab, available if the
1006         <display_text>By Area</display_text> option is selected in the
1007         <display_text>Setup</display_text> tab, defines the rectangular area
1008         of the world for which maps will be downloaded or deleted.  If
1009         applicable, the fields are pre-filled to specify the area
1010         visible on-screen. This allows you to graphically change your
1011         rectangle simply by zooming in and panning to see the area you
1012         want to download.
1013       </para>
1014     </topic>
1015     <topic>
1016       <topictitle>Downloading Routes</topictitle>
1017       <context contextUID="help_maemomapper_downroute"/>
1018       <para>
1019         Route data can be loaded from GPX files, like the ones provided by
1020         the GPX Driving Directions web service
1021         (http://www.gnuite.com/cgi-bin/gpx.cgi).  Or, route data can be
1022         downloaded directly within Maemo Mapper using the
1023         <display_text>Download Route</display_text> dialog.
1024       </para>
1025       <para>
1026         Downloading routes requires an active connection to the internet,
1027         but once a route is loaded into Maemo Mapper, the internet
1028         connection is no longer needed (unless
1029         <display_text>Auto-Update</display_text> is enabled).  The route
1030         download functionality in Maemo Mapper actually uses the
1031         aforementioned GPX Driving Directions web service.
1032       </para>
1033       <para>
1034         To download a route, you must specify an
1035         <display_text>Origin</display_text> and a
1036         <display_text>Destination</display_text>.  The GPX Driving
1037         Directions web service will return a route taking you from the
1038         origin to the destination.
1039       </para>
1040       <para>
1041         The <display_text>Download Route</display_text> dialog contains the
1042         following controls:
1043       </para>
1044       <list>
1045         <listitem>
1046           <display_text>Source URL</display_text> - The web service from
1047           which driving directions are retrieved.  The default is fine, and
1048           it is usually left unchanged.
1049         </listitem>
1050         <listitem>
1051           <display_text>Auto-Update</display_text> - This option, only
1052           available if <display_text>Use GPS Location</display_text> is
1053           enabled, will cause Maemo Mapper to automatically re-download a
1054           new route if you stray from the route.  Note that you must have a
1055           continuous connection to the internet (i.e. cellular data service)
1056           for Auto-Update to work.
1057         </listitem>
1058         <listitem>
1059           <display_text>Use GPS Location</display_text> - If selected, then
1060           the current GPS location will be used as the
1061           <display_text>Origin</display_text>.
1062         </listitem>
1063         <listitem>
1064           <display_text>Use End of Route</display_text> - If selected, then
1065           the end of the route will be used as the
1066           <display_text>Origin</display_text>.  This is useful for stringing
1067           together multiple route downloads into a single route.
1068         </listitem>
1069         <listitem>
1070           <display_text>Origin</display_text> - If selected, then you must
1071           enter your own origin.  An origin can be specified in any format
1072           understood by Google Maps.  Some examples: "25, -43" (lat/lon),
1073           "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1074           "5th and Main, 12151".  In fact, if your route download fails with
1075           a "Could not generate directions" error message, you can use
1076           Google Maps to test your origin for accuracy.
1077         </listitem>
1078         <listitem>
1079           <display_text>Destination</display_text> - The destination to
1080           which the directions will lead.  Like the
1081           <display_text>Origin</display_text>, a destination can be
1082           specified in any format understood by Google Maps.
1083         </listitem>
1084       </list>
1085     </topic>
1086     <topic>
1087       <topictitle>Downloading POIs</topictitle>
1088       <context contextUID="help_maemomapper_downpoi"/>
1089       <para>
1090         Points of Interest (POIs) can be loaded from GPX files, like the
1091         ones provided by the GPX POI Search web service
1092         (http://www.gnuite.com/cgi-bin/poi.cgi).  Or, POI data can be
1093         downloaded directly within Maemo Mapper using the
1094         <display_text>Download POIs</display_text> dialog.
1095       </para>
1096       <para>
1097         Downloading POIs requires an active connection to the internet,
1098         but once a POI is loaded into Maemo Mapper, the POI is accessible in
1099         Maemo Mapper regardless of whether or not you are connected to the
1100         internet.  The POI download functionality in Maemo Mapper actually
1101         uses the aforementioned GPX POI Search web service.
1102       </para>
1103       <para>
1104         To search for POIs, you enter an <display_text>Origin</display_text>
1105         and a <display_text>Query</display_text>.  The GPX POI Search web
1106         service will return up to 10 matching POIs in the vicinity of the
1107         origin.  You can access more POIs from the same query by using the
1108         <display_text>Page</display_text> modifier.
1109       </para>
1110       <para>
1111         Once you have downloaded POIs, they are automatically added to your
1112         POI database, and you are presented with the <display_text>POI
1113           List</display_text> dialog to to review the POIs that were
1114         downloaded and added to your database.  You must manually remove any
1115         POIs that you don't want in your database.  For more information
1116         about the <display_text>POI List</display_text> dialog and
1117         deleting POIs, see <ref refid="help_maemomapper_poilist"
1118           refdoc="POI List"/>.
1119       </para>
1120       <para>
1121         The <display_text>Download POIs</display_text> dialog contains the
1122         following controls:
1123       </para>
1124       <list>
1125         <listitem>
1126           <display_text>Source URL</display_text> - The web service from
1127           which POIs are retrieved.  The default is fine, and it is usually
1128           left unchanged.
1129         </listitem>
1130         <listitem>
1131           <display_text>Use GPS Location</display_text> - If selected, then
1132           the current GPS location will be used as the
1133           <display_text>Origin</display_text>.
1134         </listitem>
1135         <listitem>
1136           <display_text>Use End of Route</display_text> - If selected, then
1137           the end of the route will be used as the
1138           <display_text>Origin</display_text>.  This is useful for searching
1139           for points of interests (like hotels or restaurants) near your
1140           current destination.
1141         </listitem>
1142         <listitem>
1143           <display_text>Origin</display_text> - If selected, then you must
1144           enter your own origin.  An origin can be specified in any format
1145           understood by Google Maps.  Some examples: "25, -43" (lat/lon),
1146           "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1147           "5th and Main, 12151".  In fact, if your route download fails with
1148           a "Could not generate directions" error message, you can use
1149           Google Maps to test your origin for accuracy.
1150         </listitem>
1151         <listitem>
1152           <display_text>Category</display_text> - Specifies the default
1153           category in which all resulting POIs will be placed.  You can
1154           always change the category later.  If you have not yet entered a
1155           <display_text>Query</display_text> when you select a category,
1156           then the name of the category will be entered into the
1157           <display_text>Query</display_text> field for you.  This allows you
1158           to, for example, quickly search for restaurants and put them in
1159           the Restaurant category.
1160         </listitem>
1161         <listitem>
1162           <display_text>Page</display_text> - Specifies the page of results
1163           that you want to retrieve.  Think of it as the page number in a
1164           web search.  Page 1 contains the first 10 results.  Page 2
1165           contains results 10-19.  And so on.
1166         </listitem>
1167         <listitem>
1168           <display_text>Query</display_text> - A free-form text query that
1169           describes the POIs for which you are searching.  This can be
1170           anything from "food" to "hairstylist" to "museum."  Note that the
1171           selected <display_text>Category</display_text> is not part of the
1172           query unless you explicitly include it in the
1173           <display_text>Query</display_text> field.
1174         </listitem>
1175       </list>
1176     </topic>
1177     <topic>
1178       <topictitle>Browsing POIs</topictitle>
1179       <context contextUID="help_maemomapper_browsepoi"/>
1180       <para>
1181         Once you have imported or downloaded POIs into your POI database,
1182         you can use the <display_text>Browse POIs</display_text> dialog to
1183         search for certain POIs in your database and to view those POIs in a
1184         tabular format.
1185       </para>
1186       <para>
1187         To browse for POIs, you enter an <display_text>Origin</display_text>
1188         and a optional <display_text>Query</display_text>.  Maemo Mapper
1189         will search the database for all POIs matching your query, and it
1190         will calculate the distance from each POI to your specified
1191         <display_text>Origin</display_text>.  You may also filter your
1192         results by <display_text>Category</display_text>.
1193       </para>
1194       <para>
1195         Once your search is performed, you are taken to the
1196         <display_text>POI List</display_text> dialog, where you can view,
1197         edit, and delete any of the POIs that matched your query.  For more
1198         information about the <display_text>POI List</display_text> dialog
1199         and editing POIs, see <ref refid="help_maemomapper_poilist"
1200           refdoc="POI List"/>.
1201       </para>
1202       <para>
1203         The <display_text>Browse POIs</display_text> dialog contains the
1204         following controls:
1205       </para>
1206       <list>
1207         <listitem>
1208           <display_text>Use GPS Location</display_text> - If selected, then
1209           the current GPS location will be used as the
1210           <display_text>Origin</display_text>.
1211         </listitem>
1212         <listitem>
1213           <display_text>Use End of Route</display_text> - If selected, then
1214           the end of the route will be used as the
1215           <display_text>Origin</display_text>.  This is useful for searching
1216           for points of interests (like hotels or restaurants) near your
1217           current destination.
1218         </listitem>
1219         <listitem>
1220           <display_text>Origin</display_text> - If selected, then you must
1221           enter your own origin.  An origin can be specified in any format
1222           understood by Google Maps.  Some examples: "25, -43" (lat/lon),
1223           "68712" (zip code), "San Francisco, CA", "123 Main St, 45112",
1224           "5th and Main, 12151".  In fact, if your route download fails with
1225           a "Could not generate directions" error message, you can use
1226           Google Maps to test your origin for accuracy.
1227         </listitem>
1228         <listitem>
1229           <display_text>Category</display_text> - Filters the results based
1230           on the selected category.
1231         </listitem>
1232         <listitem>
1233           <display_text>Query</display_text> - An optional substring which
1234           must appear in either the label or description of a POI in order
1235           for the POI to match.  Any spaces, commas, or other punctiation in
1236           the query must also be in the label or description.  If left
1237           blank, then all POIs are matched.
1238         </listitem>
1239       </list>
1240     </topic>
1241     <topic>
1242       <topictitle>POI List</topictitle>
1243       <context contextUID="help_maemomapper_poilist"/>
1244       <para>
1245         The <display_text>POI List</display_text> dialog is a tabular
1246         display of POIs.  With this dialog, you can go to a specific POI,
1247         edit POIs, change the categories of a set of POIs, delete POIs, and
1248         export POIs to the GPX file format.
1249       </para>
1250       <para>
1251         The main view of the <display_text>POI List</display_text> dialog is
1252         a table with five columns, all of which (except the checkbox) can be
1253         sorted by tapping on the appropriate header:
1254       </para>
1255       <list>
1256         <listitem>
1257           <display_text>*</display_text> - This checkbox column contains a
1258           checkbox for each POI in the table.  All of the POIs that are
1259           checked will be affected by operations in the
1260           <display_text>Checked POI Actions</display_text> dialog, described
1261           later.  You can tap on the column header to enable or disable
1262           all of the checkboxes at once.  Note that this checkbox has no
1263           effect on whether or not the POI is visible in the map.
1264         </listitem>
1265         <listitem>
1266           <display_text>Category</display_text> - The category in which the
1267           POI belongs.  Categories can be edited, enabled, and disabled with
1268           the <display_text>POI Categories</display_text> dialog.  For more
1269           information about the <display_text>POI Categories</display_text>
1270           dialog, see <ref refid="help_maemomapper_poicat"
1271             refdoc="POI Categories"/>
1272         </listitem>
1273         <listitem>
1274           <display_text>Dist.</display_text> - The distance from the Origin
1275           to the given POI.
1276         </listitem>
1277         <listitem>
1278           <display_text>Bear.</display_text> - The bearing (in degrees from
1279           true north) from the Origin to the given POI.  A bearing of zero
1280           or 360 means that the POI is due north of the Origin.  90 means
1281           east; 180 means south; and 270 means west.
1282         </listitem>
1283         <listitem>
1284           <display_text>Label</display_text> - The label of the POI.
1285         </listitem>
1286       </list>
1287       <para>
1288         Below the table are four buttons:
1289       </para>
1290       <list>
1291         <listitem>
1292           <display_text>Go to</display_text> - Pans the map display to the
1293           currently selected POI (i.e. the currently highlighted row).
1294           Remember that you can tap and hold on the title bar of the dialog
1295           in order to see the map behind it.
1296         </listitem>
1297         <listitem>
1298           <display_text>Edit...</display_text> - Opens the
1299           <display_text>Edit POI</display_text> dialog for the currently
1300           selected POI (i.e. the currently highlighted row).  You can also
1301           double-tap on a row in the table to open this dialog.
1302         </listitem>
1303         <listitem>
1304           <display_text>Checked POI Actions...</display_text> - Opens the
1305           <display_text>Checked POI Actions</display_text> dialog, which
1306           allows you to perform actions on the currently checked POIs in the
1307           table.  From that dialog, you can set the categories of the
1308           checked POIs, delete the checked POIs, and/or export the checked
1309           POIs to a GPX file.
1310         </listitem>
1311         <listitem>
1312           <display_text>Close</display_text> - Closes the <display_text>POI
1313             List</display_text> dialog.
1314         </listitem>
1315       </list>
1316     </topic>
1317     <topic>
1318       <topictitle>POI Categories</topictitle>
1319       <context contextUID="help_maemomapper_poicat"/>
1320       <para>
1321         POI Categories are a means by which you can organize your POIs for
1322         selective display.  The <display_text>POI Categories</display_text>
1323         dialog is accessed from the <display_text>View</display_text> menu
1324         and allows you to enable/disable, add, edit, or delete categories.
1325       </para>
1326       <para>
1327         Each row in the table represents a category.  There are three
1328         columns displayed for each category:
1329       </para>
1330       <list>
1331         <listitem>
1332           <display_text>Enabled</display_text> - Controls whether or not
1333           POIs in this category are drawn on the map.
1334         </listitem>
1335         <listitem>
1336           <display_text>Label</display_text> - A short label to describe the
1337           category.  This is the name that will be visible when viewing a
1338           POI.
1339         </listitem>
1340         <listitem>
1341           <display_text>Description</display_text> - A longer description of
1342           the category.  This description is not visible anywhere except in
1343           this dialog; it is only used to get an idea of how the category is
1344           meant to be used.
1345         </listitem>
1346       </list>
1347       <para>
1348         Selecting a row in the table and pressing the
1349         <display_text>Edit</display_text> button will allow you to edit the
1350         above three attributes of a category, and to delete a category.  You
1351         can also add a new category by using the
1352         <display_text>Add</display_text> button.
1353       </para>
1354       <note>
1355         A POI may only be associated with a single category at a time.
1356       </note>
1357       <heading>POI Icons</heading>
1358       <para>
1359         Icons can be customized on a per-POI or per-category basis, and/or
1360         you may provide a custom default icon for all POIs.  To do so, you
1361         should place icon files in the same directory as the POI database
1362         itself.  Most image file formats are supported, but the files
1363         themselves <i>must</i> have the ".jpg" extension (even if the icons
1364         are not in the JPEG format).
1365       </para>
1366       <para>
1367         To customize the default POI icon (to be used instead of the simple
1368         square), place an icon file called "poi.jpg" in the same directory
1369         as the POI database.
1370       </para>
1371       <para>
1372         To customize the icon for a POI category, place an icon file with
1373         the same name as the POI category, all lower-case, plus the ".jpg"
1374         extension.  For example, if your POI category is called "Gas
1375         Stations", the file should have the name "gas stations.jpg".
1376       </para>
1377       <para>
1378         To customize the icon for a specific POI, place an icon file with
1379         a name equal to the POI's label, all lower-case, plus the ".jpg"
1380         extension.  For example, if your POI's label is "Joe's House",
1381         the file should have the name "joe's house.jpg".
1382       </para>
1383       <para>
1384         POI-specific icons are given priority over category-specific icons,
1385         which in turn are given priority over the default POI icon.
1386       </para>
1387     </topic>
1388     <topic>
1389       <topictitle>Settings</topictitle>
1390       <context contextUID="help_maemomapper_settings"/>
1391       <para>
1392         The <display_text>Settings</display_text> dialog (accessible from
1393         the main menu) provides access to a plethora of configurable options
1394         that control how Maemo Mapper appears and runs.  In addition to the
1395         tabs, which are described below, there are also two buttons at the
1396         bottom of the diagram labeled <display_text>Hardware
1397           Keys...</display_text> and <display_text>Colors...</display_text>.
1398       </para>
1399       <para>
1400         The <display_text>Hardware Keys...</display_text> button brings up
1401         another dialog box, which allows you to customize the actions that
1402         each hardware key causes.  For example, you can map the
1403         <graphic filename="2686KEY_esc"/> button to cycle through map
1404         repositories, giving you quick access to switching among them.
1405       </para>
1406       <para>
1407         The <display_text>Colors...</display_text> button allows you to
1408         customize the colors that are used for drawing on-map objects.
1409       </para>
1410       <heading>GPS</heading>
1411       <para>
1412         The <display_text>GPS</display_text> tab tells Maemo Mapper the
1413         source (if any) from which to retrieve GPS data.  It is only
1414         applicable if you have access to a GPS source, such as a bluetooth
1415         GPS receiver or a GPSD server.  Technically, Maemo Mapper uses GPSD
1416         for all of its GPS receiver communication, but you can instruct
1417         Maemo Mapper to use GPSD in one of three ways:
1418       </para>
1419       <list>
1420         <listitem>
1421           <display_text>Bluetooth</display_text> - Select this option
1422           if you are using a bluetooth GPS receiver, and enter the
1423           MAC address in the field provided.  If you don't know the MAC
1424           address, turn on your receiver and press the
1425           <display_text>Scan...</display_text> button to select it from a
1426           list of nearby bluetooth devices.  Or, leave the field blank and
1427           Maemo Mapper will automatically try to use any bluetooth GPS
1428           receivers that it can identify.  This
1429           option is also appropriate if you are running Maemo Mapper on a
1430           device with an internal GPS receiver, in which case you should
1431           leave the field blank.
1432         </listitem>
1433         <listitem>
1434           <display_text>File Path</display_text> - Select this option to use
1435           a device file on your file system, such as an RFCOMM device, and
1436           specify the pathname of the file in the appropriate field.
1437         </listitem>
1438         <listitem>
1439           <display_text>GPSD Host</display_text> - Select this option if you
1440           want to connect Maemo Mapper to any GPSD server (local or remote).
1441           Enter the hostname and port of the server in the fields provided.
1442           The default values (127.0.0.1 on port 2947) cause Maemo Mapper to
1443           use the local GPSD server, if available.
1444         </listitem>
1445       </list>
1446       <heading>Auto-Center</heading>
1447       <para>
1448         The <display_text>Auto-Center</display_text> tab allows you to
1449         configure how Maemo Mapper automatically re-centers the display when
1450         either <display_text>Lat/Lon</display_text> or
1451         <display_text>Lead</display_text> is enabled from the
1452         <display_text>Auto-Center</display_text> menu.  The Auto-Center
1453         feature is most useful in conjunction with a GPS receiver.
1454       </para>
1455       <list>
1456         <listitem>
1457           <display_text>Lead Amount</display_text> - When Auto-Center is set
1458           to <display_text>Lead</display_text>, then Maemo Mapper will keep
1459           the center of the screen focused on an area in front of you.  When
1460           driving, this allows you to view more of the road ahead of you.
1461           The distance in front of you on which the screen is centered is
1462           based on two variables: your current speed and the value of the
1463           <display_text>Lead Amount</display_text> option.
1464         </listitem>
1465         <listitem>
1466           <display_text>Fixed</display_text> - Controls whether or not your
1467           lead amount is affected by your speed.  If checked, then your
1468           speed will not affect the lead amount.
1469         </listitem>
1470         <listitem>
1471           <display_text>Pan Sensitivity</display_text> - Controls how often
1472           Maemo Mapper re-centers the display, based on how close your
1473           position (or the position of your <i>lead</i>) gets to the edge of
1474           the screen.  When set to a low value, Maemo Mapper will only
1475           re-center the screen when you are near the edge of the screen.
1476           When set to the maximum, Maemo Mapper will keep your position as
1477           close to the center as possible.
1478         </listitem>
1479         <listitem>
1480           <display_text>Min. Speed</display_text> - Controls how fast you
1481           must be moving in order for Auto-Center (and Auto-Rotate) to
1482           activate.  For example, walkers may wish to set this threshold
1483           low, while drivers with inaccurate GPS receivers may wish to set
1484           this high (to avoid spurious auto-rotates when parked or waiting
1485           at a red light).  The speed is specified in your chosen units.
1486         </listitem>
1487         <listitem>
1488           <display_text>Rotate Sensit.</display_text> - Controls how often
1489           Maemo Mapper rotates the display based on your heading, depending
1490           on how far your current rotation is from your heading rotation.
1491         </listitem>
1492         <listitem>
1493           <display_text>Points</display_text> - Controls which direction
1494           on the screen your heading points to when auto-rotating.  The
1495           default is for your current heading to point up.
1496         </listitem>
1497       </list>
1498       <heading>Announce</heading>
1499       <para>
1500         The <display_text>Announce</display_text> tab controls how and when
1501         Maemo Mapper displays or speaks waypoint information.  When you
1502         approach a waypoint in your route (defined by the presence of a
1503         description in the GPX file), Maemo Mapper will pop up a text box
1504         with the contents of that description.  When downloading routes from
1505         within Maemo Mapper, the text describes your next action, e.g. "Turn
1506         left at Main Street.  Go 2.4 miles."
1507       </para>
1508       <para>
1509         As you approach a waypoint, Maemo Mapper will continue to display
1510         the description of that waypoint, so long as you are within the
1511         range defined by the <display_text>Advance Notice</display_text>
1512         option, or until you pass the waypoint.  Because the amount of
1513         notice is dependent on your speed, it is possible to see the text,
1514         then slow down to a point where the notice disappears.  This is
1515         possible, for example, if you are stopped at a red light.  The text
1516         will reappear when you have picked up enough speed to again break
1517         the <display_text>Advance Notice</display_text> range.
1518       </para>
1519       <para>
1520         If you have installed <i>flite</i>, which is available in the same
1521         repository from which you downloaded Maemo Mapper, then Maemo Mapper
1522         can optionally also speak the same directions that appear on screen.
1523         Maemo Mapper will only speak the directions once, at the exact
1524         moment you first reach the distance from the waypoint defined by the
1525         <display_text>Advance Notice</display_text> option.  The same
1526         directions are on-screen if you need to reference them.
1527       </para>
1528       <list>
1529         <listitem>
1530           <display_text>Advance Notice</display_text> - Controls how much in
1531           advance Maemo Mapper begins to provide the waypoint description.
1532           The exact distance at which Maemo Mapper begins to announce a
1533           waypoint also depends on your speed, so the value of this option
1534           can be thought of more accurately in units of time.  At the
1535           minimum value, Maemo Mapper gives you almost no notice.  At the
1536           maximum value, Maemo Mapper gives you about two minutes of notice.
1537           Experiment to find your happy medium.
1538         </listitem>
1539         <listitem>
1540           <display_text>Enable Voice Synthesis</display_text> - If you have
1541           installed <i>flite</i>, this option will cause Maemo Mapper to
1542           speak the description of the next waypoint when you enter the
1543           range defined by the <display_text>Advance Notice</display_text>
1544           option.
1545         </listitem>
1546       </list>
1547       <heading>Misc.</heading>
1548       <para>
1549         The <display_text>Misc.</display_text> and <display_text>Misc.
1550           2</display_text> tabs contain miscellaneous options.
1551       </para>
1552       <list>
1553         <listitem>
1554           <display_text>Line Width</display_text> - Controls the thickness
1555           of all lines drawn on top of the map images.  This includes your
1556           mark, all tracks and routes, and the default POI image.
1557         </listitem>
1558         <listitem>
1559           <display_text>Unblank Screen</display_text> - Controls when Maemo
1560           Mapper keeps the display on without user input.  When set to
1561           <display_text>When Receiving Any GPS Data</display_text>, Maemo
1562           Mapper will keep the screen on whenever a GPS receiver is
1563           connected and producing data.  When set to
1564           <display_text>Never</display_text>, Maemo Mapper will not attempt
1565           to keep the screen on, and the screen will go blank after a period
1566           of inactivity on the user's part.  The default is
1567           <display_text>When Moving (Full Screen Only)</display_text>
1568         </listitem>
1569         <listitem>
1570           <display_text>Info Font Size</display_text> - Controls the font
1571           size for all information that is popped up to the user in the
1572           upper-right corner, including waypoint descriptions.
1573         </listitem>
1574         <listitem>
1575           <display_text>Units</display_text> - Controls the units in which
1576           distances and speeds are displayed in the user interface.
1577         </listitem>
1578         <listitem>
1579           <display_text>Degrees Format</display_text> - Controls how
1580           latitude and longitudes are displayed in the user interface.
1581         </listitem>
1582         <listitem>
1583           <display_text>Auto-Download Pre-cache</display_text> - Controls
1584           how much of the world surrounding the view Maemo Mapper should
1585           download when <display_text>Auto-Download</display_text> is
1586           enabled.  When set to the minimum, Maemo Mapper will only download
1587           the maps that are required to draw the screen.  As you pan around
1588           the world, you will see black areas where Maemo Mapper has not yet
1589           downloaded maps, until those maps are downloaded.  If you increase
1590           the Pre-cache amount, the Maemo Mapper will download more of the
1591           surrounding areas, making it less likely that you ever actually
1592           see black areas.  A general rule of thumb is to limit the
1593           Pre-cache based on the bandwidth of your internet connection, but
1594           the default setting (two bars) is usually sufficient for most
1595           people's needs.
1596         </listitem>
1597         <listitem>
1598           <display_text>Speed Limit</display_text> - Enables notification
1599           when you have exceeded the given speed limit (specified in the
1600           units defined via the <display_text>Units</display_text> option).
1601         </listitem>
1602         <listitem>
1603           <display_text>Location</display_text> - Controls the location on
1604           the screen of the speed warning.
1605         </listitem>
1606       </list>
1607       <heading>POI</heading>
1608       <para>
1609         The <display_text>POI</display_text> tab allows you to define your
1610         POI database and how POIs are drawn on the screen.
1611       </para>
1612       <list>
1613         <listitem>
1614           <display_text>POI database</display_text> - The location on the
1615           file system where the POI database is located.  The database must
1616           be in sqlite3 format.  A default (empty) POI database is
1617           automatically created for you when you first run Maemo Mapper.
1618         </listitem>
1619         <listitem>
1620           <display_text>Show POI below zoom</display_text> - Defines the
1621           maximum zoom (furthest away from the Earth) at which POIs will be
1622           drawn.  When zoomed out beyond this level, no POIs will be drawn.
1623         </listitem>
1624       </list>
1625     </topic>
1626     <topic>
1627       <topictitle>About Maemo Mapper</topictitle>
1628       <context contextUID="help_maemomapper_about"/>
1629       <para>
1630         Current Version: 2.6.2
1631       </para>
1632       <para>
1633         Maemo Mapper was created and developed by John Costigan (aka
1634         <display_text>gnuite</display_text>).
1635       </para>
1636       <para>
1637         Copyright © 2006-2008 John Costigan.
1638       </para>
1639       <para>
1640         POI and GPS-Info code originally written by Cezary Jackiewicz.
1641       </para>
1642       <para>
1643         Default map data provided by http://www.openstreetmap.org/ - other
1644         map repositories are subject to their own licenses and may or may not
1645         be suitable for use with Maemo Mapper.  It may be illegal to use a
1646         certain repository with Maemo Mapper or under certain conditions.  This
1647         includes the repositories downloadable directly in Maemo Mapper.  If
1648         you are not sure if you are legally allowed to use a particular
1649         repository, you should delete it from your list of repositories.  The
1650         authors of Maemo Mapper cannot be held responsible for your use of a
1651         particular repository.
1652       </para>
1653       <para>
1654         Maemo Mapper is free software: you can redistribute it and/or modify it
1655         under the terms of the GNU General Public License as published by the
1656         Free Software Foundation, either version 3 of the License, or (at your
1657         option) any later version.
1658       </para>
1659       <para>
1660         Maemo Mapper is distributed in the hope that it will be useful, but
1661         WITHOUT ANY WARRANTY; without even the implied warranty of
1662         MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
1663         General Public License for more details.
1664       </para>
1665     </topic>
1666   </folder>
1667 </ossohelpsource>