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

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