]> git.street.me.uk Git - andy/viking.git/commitdiff
Insert parameter for Viking's version in viking.xml
authorGuilhem Bonnefille <guilhem.bonnefille@gmail.com>
Wed, 2 Sep 2015 20:27:30 +0000 (22:27 +0200)
committerRob Norris <rw_norris@hotmail.com>
Wed, 2 Sep 2015 22:10:49 +0000 (23:10 +0100)
Insertion is done by configure, so the file is renamed as viking.xml.in.
The most annoying with this change is probably to configure the XML editor
to handle xml.in files.

configure.ac
help/Makefile.am
help/viking.xml [deleted file]
help/viking.xml.in [new file with mode: 0644]

index 66fa53baa25acfb634cb89b9e98003278a70a4ac..7c1891938ec3848c846e47ca0dea6e3232864ab4 100644 (file)
@@ -439,6 +439,7 @@ AC_CONFIG_FILES([
                tools/Makefile
                test/Makefile
                help/Makefile
                tools/Makefile
                test/Makefile
                help/Makefile
+               help/viking.xml
                win32/Makefile
                win32/installer/Makefile
                win32/installer/pixmaps/Makefile
                win32/Makefile
                win32/installer/Makefile
                win32/installer/pixmaps/Makefile
index fc27781e51543cd757422883e6f90a0fa19eab8c..8ed26708ae725a566cd24841ea10a4fb5b77f673 100644 (file)
@@ -53,7 +53,7 @@ DOC_FIGURES = \
     figures/customize_toolbar_dialog.png
 DOC_LINGUAS =
 
     figures/customize_toolbar_dialog.png
 DOC_LINGUAS =
 
-EXTRA_DIST = viking.xml
+EXTRA_DIST = viking.xml.in
 
 CLEANFILES=
 # man pages processing
 
 CLEANFILES=
 # man pages processing
diff --git a/help/viking.xml b/help/viking.xml
deleted file mode 100644 (file)
index 5e0bb35..0000000
+++ /dev/null
@@ -1,650 +0,0 @@
-<?xml version='1.0' encoding='ISO-8859-1'?>
-<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
-"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
-
-<!--
-
-Process this file with an XSLT processor: `xsltproc \
--''-nonet /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\
-manpages/docbook.xsl manpage.dbk'.  A manual page
-<package>.<section> will be generated.  You may view the
-manual page with: nroff -man <package>.<section> | less'.  A
-typical entry in a Makefile or Makefile.am is:
-
-DB2MAN=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\
-manpages/docbook.xsl
-XP=xsltproc -''-nonet
-
-manpage.1: manpage.dbk
-        $(XP) $(DB2MAN) $<
-    
-The xsltproc binary is found in the xsltproc package.  The
-XSL files are in docbook-xsl.  Please remember that if you
-create the nroff version in one of the debian/rules file
-targets (such as build), you will need to include xsltproc
-and docbook-xsl in your Build-Depends control field.
-
--->
-
-  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
-  <!ENTITY dhfirstname "<firstname>Ralf</firstname>">
-  <!ENTITY dhsurname   "<surname>Meyer</surname>">
-  <!-- Please adjust the date whenever revising the manpage. -->
-  <!ENTITY dhdate      "<date>2015-03-29</date>">
-  <!-- Would be nice if the version could auto-update. -->
-  <!ENTITY dhsource      "Viking">
-  <!ENTITY dhversion     "1.6.0">
-  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
-       allowed: see man(7), man(1). -->
-  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
-  <!ENTITY dhemail     "<email>ranfyy@gmail.com</email>">
-  <!ENTITY dhusername  "Ralf Meyer">
-  <!ENTITY dhucpackage "<refentrytitle>VIKING</refentrytitle>">
-  <!ENTITY dhpackage   "viking">
-
-  <!ENTITY debian      "<productname>Debian</productname>">
-  <!ENTITY gnu         "<acronym>GNU</acronym>">
-  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
-]>
-
-<reference>
-<title>&dhsource; &dhversion;</title>
-
-<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
-  <refentryinfo>
-    <address>
-      &dhemail;
-    </address>
-    <copyright>
-      <year>2007</year>
-      <holder>&dhusername;</holder>
-    </copyright>
-    <copyright>
-      <year>2010</year>
-      <holder>Guilhem Bonnefille</holder>
-    </copyright>
-    <copyright>
-      <year>2013</year>
-      <holder>Rob Norris</holder>
-    </copyright>
-    &dhdate;
-  </refentryinfo>
-  <refmeta>
-    &dhucpackage;
-    &dhsection;
-    <refmiscinfo CLASS="source">&dhsource;</refmiscinfo>
-    <refmiscinfo CLASS="version">&dhversion;</refmiscinfo>
-  </refmeta>
-  <refnamediv>
-    <refname>&dhpackage;</refname>
-
-    <refpurpose>program to manage GPS data</refpurpose>
-  </refnamediv>
-  <refsynopsisdiv>
-    <cmdsynopsis>
-      <command>&dhpackage;</command>
-      <group choice="opt">
-        <arg choice="plain"><option>-d</option></arg>
-        <arg choice="plain"><option>--debug</option></arg>
-      </group>
-      <group choice="opt">
-        <arg choice="plain"><option>-V</option></arg>
-        <arg choice="plain"><option>--verbose</option></arg>
-      </group>
-      <sbr/>
-      <group choice="opt">
-        <arg choice="plain"><option>--latitude</option> <replaceable>degrees</replaceable></arg>
-      </group>
-      <group choice="opt">
-        <arg choice="plain"><option>--longitude</option> <replaceable>degrees</replaceable></arg>
-      </group>
-      <sbr/>
-      <group choice="opt">
-        <arg choice="plain"><option>-z</option></arg>
-        <arg choice="plain"><option>--zoom</option> <replaceable>ZoomLevelOSM</replaceable></arg>
-      </group>
-      <group choice="opt">
-        <arg choice="plain"><option>-m</option></arg>
-        <arg choice="plain"><option>--map</option> <replaceable>MapId</replaceable></arg>
-      </group>
-      <sbr/>
-      <arg rep="repeat"><replaceable>file</replaceable></arg>
-    </cmdsynopsis>
-    <cmdsynopsis>
-      <command>&dhpackage;</command>
-      <group choice="opt">
-        <arg choice="plain"><option>-h</option></arg>
-        <arg choice="plain"><option>--help</option></arg>
-      </group>
-    </cmdsynopsis>
-    <cmdsynopsis>
-      <command>&dhpackage;</command>
-      <group choice="opt">
-        <arg choice="plain"><option>-v</option></arg>
-        <arg choice="plain"><option>--version</option></arg>
-      </group>
-    </cmdsynopsis>
-  </refsynopsisdiv>
-  <refsect1>
-    <title>DESCRIPTION</title>
-
-    <para>
-      Viking is a program to manage GPS data.
-    </para>
-    <para>  
-      You can import and plot tracks, routes and waypoints, show OpenStreetMap (OSM) and/or other maps, generate maps (using Mapnik),
-       geotag images, add coordinate lines, make new tracks, routes and waypoints, hide different things, etc.
-      It is written mainly in C with some C++ and uses the GTK+ 2 toolkit. It is available for Linux, other POSIX operating systems and Windows.
-    </para>
-    <para>  
-      Homepage: <ulink type="http" url="http://viking.sf.net">http://viking.sf.net</ulink>
-    </para>
-    <para>  
-      Viking is licensed under the GNU GPL.
-    </para>
-
-  </refsect1>
-  <refsect1>
-    <title>OPTIONS</title>
-
-    <variablelist>
-      <varlistentry>
-        <term><option>file</option></term>
-        <listitem>
-          <para>Specify file to load at start.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-d</option></term>
-        <term><option>--debug</option></term>
-        <listitem>
-          <para>Enable debug output.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-V</option></term>
-        <term><option>--verbose</option></term>
-        <listitem>
-          <para>Enable verbose output.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-?</option></term>
-        <term><option>--help</option></term>
-        <listitem>
-          <para>Show help options.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-v</option></term>
-        <term><option>--version</option></term>
-        <listitem>
-          <para>Show version.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>--latitude</option></term>
-        <listitem>
-          <para>Set the initial position to the specified latitude in decimal degrees.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>--longitude</option></term>
-        <listitem>
-          <para>Set the initial position to the specified longitude in decimal degrees.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-z</option></term>
-        <term><option>--zoom</option></term>
-        <listitem>
-          <para>Set the initial zoom level. The value is the OSM zoom level (0 - 22).</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><option>-m</option></term>
-        <term><option>--map</option></term>
-        <listitem>
-          <para>Add a map layer by specifying the map id. The value needs to match one of the internal ids or an id from the maps configuration extension (see below).
-          Specifying a value of 0 will use the configured map layer default.</para>
-<variablelist>
-  <varlistentry><term></term><listitem><para>Internal Map Ids:</para></listitem></varlistentry>
-  <varlistentry><term></term><listitem><para>OSM Mapnik = 13</para></listitem></varlistentry>
-  <varlistentry><term></term><listitem><para>OSM Cycle = 17</para></listitem></varlistentry>
-  <varlistentry><term></term><listitem><para>Mapquest OSM = 19</para></listitem></varlistentry>
-</variablelist>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1>
-  <refsect1>
-    <title>Extending Viking</title>
-
-      <para>Currently, &dhpackage; has some extension points based on configuration files. The file format is heavily inspired by the GtkBuilder file format: you specify the class of the GObject to build and set its properties. Technically, it is a XML file containing a "objects" root element. Inside this element, you set a collection of "object".</para>
-      <para>Here is an example:
-<literallayout><![CDATA[
-<objects>
-  <object class="ClassName">
-    <property name="property_name1">Property value</property>
-    <property name="property_name2">Property value</property>
-  </object>
-  ...
-<objects>
-]]>
-</literallayout>
-</para>
-      <para>You can find more examples in the documentation part of the distribution.</para>
-      <formalpara>
-        <title>Map Source</title>
-        <para>It is possible to add new map's sources. The file is <filename>~/.viking/maps.xml</filename>.</para>
-        <para>An example of the file in the distribution <filename>doc/examples/maps.xml</filename>.</para>
-        <para>The VikSlippyMapSource allows to declare any map's source working like OpenStreetMap. It supports the following properties:
-          <variablelist>
-            <varlistentry>
-              <term>id</term>
-              <listitem><para>this is an integer and should be unique as it used to identify the map source</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>name</term>
-              <listitem><para>a string (should be unique) that is used for the OSM style cache directory name when the Map Cache directory is the default (<filename>~/.viking-maps</filename>)</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>label</term>
-              <listitem><para>the text displayed in the map's source selection dialog</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>hostname</term>
-              <listitem><para>the server's hostname (eg. "tile.openstreetmap.org")</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>url</term>
-              <listitem><para>the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for Z, X and Y (in that order) (eg. "/%d/%d/%d.png")</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>zoom-min (optional)</term>
-              <listitem><para>The minimum zoom value supported by the tile server. The Default is 0 if not specified.</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>zoom-max (optional)</term>
-              <listitem>
-                 <para>The maximum zoom value supported by the tile server. The Default is 18 if not specified.</para>
-                 <para>See <ulink url="http://wiki.openstreetmap.org/wiki/Zoom_levels">Zoom Levels</ulink></para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>lat-min (optional)</term>
-              <listitem><para>The minimum latitude value in degrees supported by the tile server. The Default is -90 degrees if not specified.</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>lat-max (optional)</term>
-              <listitem><para>The maximum latitude value in degrees supported by the tile server. The Default is 90 degrees if not specified.</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>lon-min (optional)</term>
-              <listitem><para>The minimum longitude value in degrees supported by the tile server. The Default is -180 degrees if not specified.</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>lon-max (optional)</term>
-              <listitem><para>The maximum longitude value in degrees supported by the tile server. The Default is 180 degrees if not specified.</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>file-extension (optional)</term>
-              <listitem>
-                <para>The file extension of the files on disk. The default is <emphasis>.png</emphasis></para>
-                <para>If the tile source URL ends in something other than .png, then this parameter will need to match it.</para>
-                <para>This can also be useful in reading a tileset from other software which may name tiles in an alternative form,
-                      e.g. for Mobile Atlas creator it names them <emphasis>.png.tile</emphasis></para>
-                <note><para>The file types actually usable are those supported by GDK Pixbuf Library, which includes at least PNG and JPEG.</para></note>
-                <note><para>Remember to include the beginning <emphasis>'.'</emphasis> when specifying this parameter.</para></note>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>switch-xy (optional)</term>
-              <listitem>
-                <para>Swap the X,Y values around in the URL parametrized ordering.</para>
-                <para>The default is false.</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>check-file-server-time (optional)</term>
-              <listitem>
-                <para>Sends the timestamp of the tile to the server, so the server can decide whether it should send a new tile or not.</para>
-                <para>The default is false.</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>use-etag (optional)</term>
-              <listitem>
-                <para>Use and compare the <ulink url="http://en.wikipedia.org/wiki/HTTP_ETag">ETag</ulink> value in determining whether to download a newer tile. The default is false.</para>
-                <para>The ETag value is stored in a separate file in the same directory as the tile to enable checking the value across multiple runs of the program.</para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </para>
-        <para>The VikTmsMapSource allows to declare any TMS service. It supports the following properties (as per VikSlippyMapSource above):
-          <variablelist>
-            <varlistentry>
-              <term>id</term>
-            </varlistentry>
-            <varlistentry>
-              <term>label</term>
-            </varlistentry>
-            <varlistentry>
-              <term>hostname</term>
-            </varlistentry>
-            <varlistentry>
-              <term>url</term>
-            </varlistentry>
-            <varlistentry>
-              <term>check-file-server-time (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>zoom-min (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>zoom-max (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>lat-min (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>lat-max (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>lon-min (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>lon-max (optional)</term>
-            </varlistentry>
-          </variablelist>
-        </para>
-        <para>The VikWmscMapSource allows to declare any WMS or WMS-C service. It supports the following properties  (as per VikSlippyMapSource above):
-          <variablelist>
-            <varlistentry>
-              <term>id</term>
-            </varlistentry>
-            <varlistentry>
-              <term>label</term>
-            </varlistentry>
-            <varlistentry>
-              <term>hostname</term>
-            </varlistentry>
-            <varlistentry>
-              <term>url</term>
-            </varlistentry>
-            <varlistentry>
-              <term>check-file-server-time (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>zoom-min (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>zoom-max (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>lat-min (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>lat-max (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>lon-min (optional)</term>
-            </varlistentry>
-            <varlistentry>
-              <term>lon-max (optional)</term>
-            </varlistentry>
-          </variablelist>
-        </para>
-      </formalpara>
-
-      <formalpara>
-        <title>Go-to search engines</title>
-        <para>It is possible to add new new search engines for the "Go-To" feature. The file is <filename>~/.viking/goto_tools.xml</filename>.</para>
-        <para>An example of the file in the distribution <filename>doc/examples/goto_tools.xml</filename>.</para>
-        <para>Currently, there is a single object class available: VikGotoXmlTool. Such feature allows to declare any search engine using a XML format as result.</para>
-        <para>The related properties are:
-          <variablelist>
-            <varlistentry>
-              <term>label</term>
-              <listitem><para>the text displayed in the <guilabel>Go-To</guilabel> dialog</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>url-format</term>
-              <listitem><para>the parametrized address of the query, in the spirit of C <function>printf</function> format, with a single "%s" field (replaced by the query string)</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>lat-path</term>
-              <listitem><para>XML path of the latitude (eg. <literal>/root/parent/elem</literal>)</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>lat-attr (optional)</term>
-              <listitem><para>name of the attribute (of previous element) containing the latitude</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>lon-path</term>
-              <listitem><para>XML path of the longitude (eg. <literal>/root/parent/elem</literal>)</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>lon-attr (optional)</term>
-              <listitem><para>name of the attribute (of previous element) containing the longiude</para></listitem>
-            </varlistentry>
-          </variablelist>
-        </para>
-        <para>As a facility (or readability) it is possible to set both path and attribute name in a single property, like an XPath expression. To do so, simply set both info in lat-path (or lon-path) in the following format: <literal>/root/parent/elem@attribute</literal>.</para>
-      </formalpara>
-
-      <formalpara>
-        <title>External tools</title>
-        <para>It is possible to add new external tools. The file is <filename>~/.viking/external_tools.xml</filename>.</para>
-        <para>An example of the file in the distribution <filename>doc/examples/external_tools.xml</filename>.</para>
-        <para>The VikWebtoolCenter allows to declare any Webtool using a logic based on center coordinates and zoom level value.</para>
-        <para>The related properties are:
-          <variablelist>
-            <varlistentry>
-              <term>label</term>
-              <listitem><para>the text displayed in the menu entry</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>url</term>
-              <listitem><para>the parametrized URL to open, in the spirit of C printf format, with 2 "%s" and a "%d" fields for X, Y and Z (zoom level) (eg. "http://hostname/?lat=%s&amp;lon=%s&amp;zoom=%d")</para></listitem>
-            </varlistentry>
-          </variablelist>
-        </para>
-        <para>The VikWebtoolBounds allows to declare any Webtool using a logic based on bounds coordinates.</para>
-        <para>The related properties are:
-          <variablelist>
-            <varlistentry>
-              <term>label</term>
-              <listitem><para>the text displayed in the menu entry</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>url</term>
-              <listitem><para>the parametrized address of the tile, in the spirit of C printf format, with 4 "%s" fields for left, right, bottom and top (eg. "http://hostname:8111/load_and_zoom?left=%s&amp;right=%s&amp;bottom=%s&amp;top=%s")</para></listitem>
-            </varlistentry>
-          </variablelist>
-        </para>
-      </formalpara>
-
-      <formalpara>
-        <title>Remote File Datasources</title>
-        <para>It is possible to add web references expected to return a file which can then be opened directly or converted via GPSBabel.</para>
-        <para>The file is <filename>~/.viking/datasources.xml</filename>.</para>
-        <para>An example of the file is in the source distribution <filename>doc/examples/datasources.xml</filename>.</para>
-        <para>The VikWebtoolDatasource allows to declare any URL using logic based on coordinates.</para>
-        <para>The related properties are:
-          <variablelist>
-            <varlistentry>
-              <term>label</term>
-              <listitem><para>the text displayed in the menu entry</para></listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>url</term>
-              <listitem>
-                <para>the parametrized URL to open in the spirit of C printf format, with up to 7 "%s" values. e.g. <literal>http://hostname/getfile?lat=%s&amp;lon=%s</literal></para>
-                <para>The order and meaning of these parameters is given by the url_format_code below</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>url_format_code</term>
-              <listitem>
-                <para>A string describing the parametrized URL substitution parameters, each character represents how to translate each term.</para>
-                <para>B = Bottom of the current view i.e. minimum latitude</para>
-                <para>L = Left of the current view i.e. minimum longitude</para>
-                <para>T = Top of the current view i.e. maximum latitude</para>
-                <para>R = Right of the current view i.e. maximum longitude</para>
-                <para>A = center lAtitude of the current view</para>
-                <para>O = center lOngitude of the current view</para>
-                <para>Z = OSM Zoom value of the current view. See <ulink url="http://wiki.openstreetmap.org/wiki/Zoom_levels">Zoom Levels</ulink></para>
-                <para>S = A user specified input string requested from the user via a dialog box</para>
-                <para>Thus for the url example above then the format code should be <emphasis>AO</emphasis></para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>file_type</term>
-              <listitem>
-                <para>This value is passed on for the -i parameter in interfacing with GPSBabel.</para>
-                <para>If it is not defined then the returned file is interpreted internally as a GPX file.</para>
-                <para>Possible values such as 'kml', 'mapsource' etc.. can be used. See <ulink url="http://www.gpsbabel.org/capabilities.html">GPSBabel File Formats</ulink> for the full list.</para>
-              </listitem>
-            </varlistentry>
-            <varlistentry>
-              <term>babel_filter_args</term>
-              <listitem>
-                <para>This value is passed on for the filter arguments interfacing with GPSBabel.</para>
-                <para>E.g. "-x nuketypes,routes" can be used to filter all routes from the results.</para>
-              </listitem>
-            </varlistentry>
-             <varlistentry>
-              <term>input_label</term>
-              <listitem>
-                <para>This value is used when requesting input from the user.</para>
-                <para>It is the label of the text input box.</para>
-              </listitem>
-            </varlistentry>
-          </variablelist>
-        </para>
-      </formalpara>
-
-  </refsect1>
-  <refsect1>
-    <title>FILES</title>
-
-    <variablelist>
-      <varlistentry>
-        <term><filename>~/.viking/maps.xml</filename></term>
-        <listitem>
-          <para>File containing definition of map sources.</para>
-          <para>See previous section for details.</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking/goto_tools.xml</filename></term>
-        <listitem>
-          <para>File containing definition of "Go-to" services.</para>
-          <para>See previous section for details.</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking/external_tools.xml</filename></term>
-        <listitem>
-          <para>File containing definition of external tools.</para>
-          <para>See previous section for details.</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking/datasources.xml</filename></term>
-        <listitem>
-          <para>File containing definition of remote file datasources.</para>
-          <para>See previous section for details.</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking/viking.prefs</filename></term>
-        <listitem>
-          <para>Preferences for &dhpackage;.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking/viking_layer_defaults.ini</filename></term>
-        <listitem>
-          <para>Layer default values for &dhpackage;.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking/viking.ini</filename></term>
-        <listitem>
-          <para>Values for &dhpackage; automatically saved between sessions.</para>
-          <para>Not generally intended to be manually edited.</para>
-         <para>However some finer control of default internal values can be set.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking/keys.rc</filename></term>
-        <listitem>
-          <para>File containing short cut key accelerators.</para>
-          <para>This is in the standard GTK Accelerator map format.</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking/cookies.txt</filename></term>
-        <listitem>
-          <para>File hosting cookies used by &dhpackage;.</para>
-        </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><filename>~/.viking-maps/</filename></term>
-        <listitem>
-          <para>Default location of the map cache of tiles downloaded or created by &dhpackage;.</para>
-        </listitem>
-      </varlistentry>
-    </variablelist>
-
-       <para>Extension files (<filename>maps.xml</filename>,
-       <filename>goto_tools.xml</filename>,
-       <filename>datasources.xml</filename>,
-       <filename>external_tools.xml</filename>)
-       are also searched in <filename>/etc/viking</filename> and
-       <filename>/usr/share/viking</filename> directories (or related in your system).</para>
-
-  </refsect1>
-  <refsect1>
-    <title>ENVIRONMENT</title>
-
-    <variablelist>
-      <varlistentry>
-        <term><envar>XDG_DATA_HOME</envar></term>
-        <listitem>
-          <para>Optional directory to look for extension files
-          (<filename>maps.xml</filename>, <filename>goto_tools.xml</filename>,
-          <filename>external_tools.xml</filename>).</para>
-       </listitem>
-      </varlistentry>
-      <varlistentry>
-        <term><envar>XDG_DATA_DIRS</envar></term>
-        <listitem>
-          <para>Path used to change the directories scanned for extension files
-          (<filename>maps.xml</filename>, <filename>goto_tools.xml</filename>,
-          <filename>external_tools.xml</filename>).</para>
-       </listitem>
-      </varlistentry>
-    </variablelist>
-
-  </refsect1>
-  <refsect1>
-    <title>AUTHOR</title>
-
-    <para>This manual page was originally written by &dhusername; &dhemail; for
-      the &debian; system (but may be used by others).  Permission is
-      granted to copy, distribute and/or modify this document under
-      the terms of the &gnu; General Public License, Version 2 any 
-         later version published by the Free Software Foundation.
-    </para>
-       <para>
-         On Debian systems, the complete text of the GNU General Public
-         License can be found in /usr/share/common-licenses/GPL.
-       </para>
-
-  </refsect1>
-</refentry>
-</reference>
diff --git a/help/viking.xml.in b/help/viking.xml.in
new file mode 100644 (file)
index 0000000..ebc2de3
--- /dev/null
@@ -0,0 +1,649 @@
+<?xml version='1.0' encoding='ISO-8859-1'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+<!--
+
+Process this file with an XSLT processor: `xsltproc \
+-''-nonet /usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\
+manpages/docbook.xsl manpage.dbk'.  A manual page
+<package>.<section> will be generated.  You may view the
+manual page with: nroff -man <package>.<section> | less'.  A
+typical entry in a Makefile or Makefile.am is:
+
+DB2MAN=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/\
+manpages/docbook.xsl
+XP=xsltproc -''-nonet
+
+manpage.1: manpage.dbk
+        $(XP) $(DB2MAN) $<
+    
+The xsltproc binary is found in the xsltproc package.  The
+XSL files are in docbook-xsl.  Please remember that if you
+create the nroff version in one of the debian/rules file
+targets (such as build), you will need to include xsltproc
+and docbook-xsl in your Build-Depends control field.
+
+-->
+
+  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
+  <!ENTITY dhfirstname "<firstname>Ralf</firstname>">
+  <!ENTITY dhsurname   "<surname>Meyer</surname>">
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY dhdate      "<date>2015-03-29</date>">
+  <!ENTITY dhsource      "Viking">
+  <!ENTITY dhversion     "@PACKAGE_VERSION@">
+  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
+       allowed: see man(7), man(1). -->
+  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
+  <!ENTITY dhemail     "<email>ranfyy@gmail.com</email>">
+  <!ENTITY dhusername  "Ralf Meyer">
+  <!ENTITY dhucpackage "<refentrytitle>VIKING</refentrytitle>">
+  <!ENTITY dhpackage   "viking">
+
+  <!ENTITY debian      "<productname>Debian</productname>">
+  <!ENTITY gnu         "<acronym>GNU</acronym>">
+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
+]>
+
+<reference>
+<title>&dhsource; &dhversion;</title>
+
+<refentry xmlns:xi="http://www.w3.org/2001/XInclude">
+  <refentryinfo>
+    <address>
+      &dhemail;
+    </address>
+    <copyright>
+      <year>2007</year>
+      <holder>&dhusername;</holder>
+    </copyright>
+    <copyright>
+      <year>2010</year>
+      <holder>Guilhem Bonnefille</holder>
+    </copyright>
+    <copyright>
+      <year>2013</year>
+      <holder>Rob Norris</holder>
+    </copyright>
+    &dhdate;
+  </refentryinfo>
+  <refmeta>
+    &dhucpackage;
+    &dhsection;
+    <refmiscinfo CLASS="source">&dhsource;</refmiscinfo>
+    <refmiscinfo CLASS="version">&dhversion;</refmiscinfo>
+  </refmeta>
+  <refnamediv>
+    <refname>&dhpackage;</refname>
+
+    <refpurpose>program to manage GPS data</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+      <group choice="opt">
+        <arg choice="plain"><option>-d</option></arg>
+        <arg choice="plain"><option>--debug</option></arg>
+      </group>
+      <group choice="opt">
+        <arg choice="plain"><option>-V</option></arg>
+        <arg choice="plain"><option>--verbose</option></arg>
+      </group>
+      <sbr/>
+      <group choice="opt">
+        <arg choice="plain"><option>--latitude</option> <replaceable>degrees</replaceable></arg>
+      </group>
+      <group choice="opt">
+        <arg choice="plain"><option>--longitude</option> <replaceable>degrees</replaceable></arg>
+      </group>
+      <sbr/>
+      <group choice="opt">
+        <arg choice="plain"><option>-z</option></arg>
+        <arg choice="plain"><option>--zoom</option> <replaceable>ZoomLevelOSM</replaceable></arg>
+      </group>
+      <group choice="opt">
+        <arg choice="plain"><option>-m</option></arg>
+        <arg choice="plain"><option>--map</option> <replaceable>MapId</replaceable></arg>
+      </group>
+      <sbr/>
+      <arg rep="repeat"><replaceable>file</replaceable></arg>
+    </cmdsynopsis>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+      <group choice="opt">
+        <arg choice="plain"><option>-h</option></arg>
+        <arg choice="plain"><option>--help</option></arg>
+      </group>
+    </cmdsynopsis>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+      <group choice="opt">
+        <arg choice="plain"><option>-v</option></arg>
+        <arg choice="plain"><option>--version</option></arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para>
+      Viking is a program to manage GPS data.
+    </para>
+    <para>  
+      You can import and plot tracks, routes and waypoints, show OpenStreetMap (OSM) and/or other maps, generate maps (using Mapnik),
+       geotag images, add coordinate lines, make new tracks, routes and waypoints, hide different things, etc.
+      It is written mainly in C with some C++ and uses the GTK+ 2 toolkit. It is available for Linux, other POSIX operating systems and Windows.
+    </para>
+    <para>  
+      Homepage: <ulink type="http" url="http://viking.sf.net">http://viking.sf.net</ulink>
+    </para>
+    <para>  
+      Viking is licensed under the GNU GPL.
+    </para>
+
+  </refsect1>
+  <refsect1>
+    <title>OPTIONS</title>
+
+    <variablelist>
+      <varlistentry>
+        <term><option>file</option></term>
+        <listitem>
+          <para>Specify file to load at start.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-d</option></term>
+        <term><option>--debug</option></term>
+        <listitem>
+          <para>Enable debug output.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-V</option></term>
+        <term><option>--verbose</option></term>
+        <listitem>
+          <para>Enable verbose output.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-?</option></term>
+        <term><option>--help</option></term>
+        <listitem>
+          <para>Show help options.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-v</option></term>
+        <term><option>--version</option></term>
+        <listitem>
+          <para>Show version.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--latitude</option></term>
+        <listitem>
+          <para>Set the initial position to the specified latitude in decimal degrees.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>--longitude</option></term>
+        <listitem>
+          <para>Set the initial position to the specified longitude in decimal degrees.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-z</option></term>
+        <term><option>--zoom</option></term>
+        <listitem>
+          <para>Set the initial zoom level. The value is the OSM zoom level (0 - 22).</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><option>-m</option></term>
+        <term><option>--map</option></term>
+        <listitem>
+          <para>Add a map layer by specifying the map id. The value needs to match one of the internal ids or an id from the maps configuration extension (see below).
+          Specifying a value of 0 will use the configured map layer default.</para>
+<variablelist>
+  <varlistentry><term></term><listitem><para>Internal Map Ids:</para></listitem></varlistentry>
+  <varlistentry><term></term><listitem><para>OSM Mapnik = 13</para></listitem></varlistentry>
+  <varlistentry><term></term><listitem><para>OSM Cycle = 17</para></listitem></varlistentry>
+  <varlistentry><term></term><listitem><para>Mapquest OSM = 19</para></listitem></varlistentry>
+</variablelist>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+  </refsect1>
+  <refsect1>
+    <title>Extending Viking</title>
+
+      <para>Currently, &dhpackage; has some extension points based on configuration files. The file format is heavily inspired by the GtkBuilder file format: you specify the class of the GObject to build and set its properties. Technically, it is a XML file containing a "objects" root element. Inside this element, you set a collection of "object".</para>
+      <para>Here is an example:
+<literallayout><![CDATA[
+<objects>
+  <object class="ClassName">
+    <property name="property_name1">Property value</property>
+    <property name="property_name2">Property value</property>
+  </object>
+  ...
+<objects>
+]]>
+</literallayout>
+</para>
+      <para>You can find more examples in the documentation part of the distribution.</para>
+      <formalpara>
+        <title>Map Source</title>
+        <para>It is possible to add new map's sources. The file is <filename>~/.viking/maps.xml</filename>.</para>
+        <para>An example of the file in the distribution <filename>doc/examples/maps.xml</filename>.</para>
+        <para>The VikSlippyMapSource allows to declare any map's source working like OpenStreetMap. It supports the following properties:
+          <variablelist>
+            <varlistentry>
+              <term>id</term>
+              <listitem><para>this is an integer and should be unique as it used to identify the map source</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>name</term>
+              <listitem><para>a string (should be unique) that is used for the OSM style cache directory name when the Map Cache directory is the default (<filename>~/.viking-maps</filename>)</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>label</term>
+              <listitem><para>the text displayed in the map's source selection dialog</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>hostname</term>
+              <listitem><para>the server's hostname (eg. "tile.openstreetmap.org")</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>url</term>
+              <listitem><para>the parametrized address of the tile, in the spirit of C printf format, with 3 "%d" fields for Z, X and Y (in that order) (eg. "/%d/%d/%d.png")</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>zoom-min (optional)</term>
+              <listitem><para>The minimum zoom value supported by the tile server. The Default is 0 if not specified.</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>zoom-max (optional)</term>
+              <listitem>
+                 <para>The maximum zoom value supported by the tile server. The Default is 18 if not specified.</para>
+                 <para>See <ulink url="http://wiki.openstreetmap.org/wiki/Zoom_levels">Zoom Levels</ulink></para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>lat-min (optional)</term>
+              <listitem><para>The minimum latitude value in degrees supported by the tile server. The Default is -90 degrees if not specified.</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>lat-max (optional)</term>
+              <listitem><para>The maximum latitude value in degrees supported by the tile server. The Default is 90 degrees if not specified.</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>lon-min (optional)</term>
+              <listitem><para>The minimum longitude value in degrees supported by the tile server. The Default is -180 degrees if not specified.</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>lon-max (optional)</term>
+              <listitem><para>The maximum longitude value in degrees supported by the tile server. The Default is 180 degrees if not specified.</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>file-extension (optional)</term>
+              <listitem>
+                <para>The file extension of the files on disk. The default is <emphasis>.png</emphasis></para>
+                <para>If the tile source URL ends in something other than .png, then this parameter will need to match it.</para>
+                <para>This can also be useful in reading a tileset from other software which may name tiles in an alternative form,
+                      e.g. for Mobile Atlas creator it names them <emphasis>.png.tile</emphasis></para>
+                <note><para>The file types actually usable are those supported by GDK Pixbuf Library, which includes at least PNG and JPEG.</para></note>
+                <note><para>Remember to include the beginning <emphasis>'.'</emphasis> when specifying this parameter.</para></note>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>switch-xy (optional)</term>
+              <listitem>
+                <para>Swap the X,Y values around in the URL parametrized ordering.</para>
+                <para>The default is false.</para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>check-file-server-time (optional)</term>
+              <listitem>
+                <para>Sends the timestamp of the tile to the server, so the server can decide whether it should send a new tile or not.</para>
+                <para>The default is false.</para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>use-etag (optional)</term>
+              <listitem>
+                <para>Use and compare the <ulink url="http://en.wikipedia.org/wiki/HTTP_ETag">ETag</ulink> value in determining whether to download a newer tile. The default is false.</para>
+                <para>The ETag value is stored in a separate file in the same directory as the tile to enable checking the value across multiple runs of the program.</para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+        </para>
+        <para>The VikTmsMapSource allows to declare any TMS service. It supports the following properties (as per VikSlippyMapSource above):
+          <variablelist>
+            <varlistentry>
+              <term>id</term>
+            </varlistentry>
+            <varlistentry>
+              <term>label</term>
+            </varlistentry>
+            <varlistentry>
+              <term>hostname</term>
+            </varlistentry>
+            <varlistentry>
+              <term>url</term>
+            </varlistentry>
+            <varlistentry>
+              <term>check-file-server-time (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>zoom-min (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>zoom-max (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>lat-min (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>lat-max (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>lon-min (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>lon-max (optional)</term>
+            </varlistentry>
+          </variablelist>
+        </para>
+        <para>The VikWmscMapSource allows to declare any WMS or WMS-C service. It supports the following properties  (as per VikSlippyMapSource above):
+          <variablelist>
+            <varlistentry>
+              <term>id</term>
+            </varlistentry>
+            <varlistentry>
+              <term>label</term>
+            </varlistentry>
+            <varlistentry>
+              <term>hostname</term>
+            </varlistentry>
+            <varlistentry>
+              <term>url</term>
+            </varlistentry>
+            <varlistentry>
+              <term>check-file-server-time (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>zoom-min (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>zoom-max (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>lat-min (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>lat-max (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>lon-min (optional)</term>
+            </varlistentry>
+            <varlistentry>
+              <term>lon-max (optional)</term>
+            </varlistentry>
+          </variablelist>
+        </para>
+      </formalpara>
+
+      <formalpara>
+        <title>Go-to search engines</title>
+        <para>It is possible to add new new search engines for the "Go-To" feature. The file is <filename>~/.viking/goto_tools.xml</filename>.</para>
+        <para>An example of the file in the distribution <filename>doc/examples/goto_tools.xml</filename>.</para>
+        <para>Currently, there is a single object class available: VikGotoXmlTool. Such feature allows to declare any search engine using a XML format as result.</para>
+        <para>The related properties are:
+          <variablelist>
+            <varlistentry>
+              <term>label</term>
+              <listitem><para>the text displayed in the <guilabel>Go-To</guilabel> dialog</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>url-format</term>
+              <listitem><para>the parametrized address of the query, in the spirit of C <function>printf</function> format, with a single "%s" field (replaced by the query string)</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>lat-path</term>
+              <listitem><para>XML path of the latitude (eg. <literal>/root/parent/elem</literal>)</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>lat-attr (optional)</term>
+              <listitem><para>name of the attribute (of previous element) containing the latitude</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>lon-path</term>
+              <listitem><para>XML path of the longitude (eg. <literal>/root/parent/elem</literal>)</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>lon-attr (optional)</term>
+              <listitem><para>name of the attribute (of previous element) containing the longiude</para></listitem>
+            </varlistentry>
+          </variablelist>
+        </para>
+        <para>As a facility (or readability) it is possible to set both path and attribute name in a single property, like an XPath expression. To do so, simply set both info in lat-path (or lon-path) in the following format: <literal>/root/parent/elem@attribute</literal>.</para>
+      </formalpara>
+
+      <formalpara>
+        <title>External tools</title>
+        <para>It is possible to add new external tools. The file is <filename>~/.viking/external_tools.xml</filename>.</para>
+        <para>An example of the file in the distribution <filename>doc/examples/external_tools.xml</filename>.</para>
+        <para>The VikWebtoolCenter allows to declare any Webtool using a logic based on center coordinates and zoom level value.</para>
+        <para>The related properties are:
+          <variablelist>
+            <varlistentry>
+              <term>label</term>
+              <listitem><para>the text displayed in the menu entry</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>url</term>
+              <listitem><para>the parametrized URL to open, in the spirit of C printf format, with 2 "%s" and a "%d" fields for X, Y and Z (zoom level) (eg. "http://hostname/?lat=%s&amp;lon=%s&amp;zoom=%d")</para></listitem>
+            </varlistentry>
+          </variablelist>
+        </para>
+        <para>The VikWebtoolBounds allows to declare any Webtool using a logic based on bounds coordinates.</para>
+        <para>The related properties are:
+          <variablelist>
+            <varlistentry>
+              <term>label</term>
+              <listitem><para>the text displayed in the menu entry</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>url</term>
+              <listitem><para>the parametrized address of the tile, in the spirit of C printf format, with 4 "%s" fields for left, right, bottom and top (eg. "http://hostname:8111/load_and_zoom?left=%s&amp;right=%s&amp;bottom=%s&amp;top=%s")</para></listitem>
+            </varlistentry>
+          </variablelist>
+        </para>
+      </formalpara>
+
+      <formalpara>
+        <title>Remote File Datasources</title>
+        <para>It is possible to add web references expected to return a file which can then be opened directly or converted via GPSBabel.</para>
+        <para>The file is <filename>~/.viking/datasources.xml</filename>.</para>
+        <para>An example of the file is in the source distribution <filename>doc/examples/datasources.xml</filename>.</para>
+        <para>The VikWebtoolDatasource allows to declare any URL using logic based on coordinates.</para>
+        <para>The related properties are:
+          <variablelist>
+            <varlistentry>
+              <term>label</term>
+              <listitem><para>the text displayed in the menu entry</para></listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>url</term>
+              <listitem>
+                <para>the parametrized URL to open in the spirit of C printf format, with up to 7 "%s" values. e.g. <literal>http://hostname/getfile?lat=%s&amp;lon=%s</literal></para>
+                <para>The order and meaning of these parameters is given by the url_format_code below</para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>url_format_code</term>
+              <listitem>
+                <para>A string describing the parametrized URL substitution parameters, each character represents how to translate each term.</para>
+                <para>B = Bottom of the current view i.e. minimum latitude</para>
+                <para>L = Left of the current view i.e. minimum longitude</para>
+                <para>T = Top of the current view i.e. maximum latitude</para>
+                <para>R = Right of the current view i.e. maximum longitude</para>
+                <para>A = center lAtitude of the current view</para>
+                <para>O = center lOngitude of the current view</para>
+                <para>Z = OSM Zoom value of the current view. See <ulink url="http://wiki.openstreetmap.org/wiki/Zoom_levels">Zoom Levels</ulink></para>
+                <para>S = A user specified input string requested from the user via a dialog box</para>
+                <para>Thus for the url example above then the format code should be <emphasis>AO</emphasis></para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>file_type</term>
+              <listitem>
+                <para>This value is passed on for the -i parameter in interfacing with GPSBabel.</para>
+                <para>If it is not defined then the returned file is interpreted internally as a GPX file.</para>
+                <para>Possible values such as 'kml', 'mapsource' etc.. can be used. See <ulink url="http://www.gpsbabel.org/capabilities.html">GPSBabel File Formats</ulink> for the full list.</para>
+              </listitem>
+            </varlistentry>
+            <varlistentry>
+              <term>babel_filter_args</term>
+              <listitem>
+                <para>This value is passed on for the filter arguments interfacing with GPSBabel.</para>
+                <para>E.g. "-x nuketypes,routes" can be used to filter all routes from the results.</para>
+              </listitem>
+            </varlistentry>
+             <varlistentry>
+              <term>input_label</term>
+              <listitem>
+                <para>This value is used when requesting input from the user.</para>
+                <para>It is the label of the text input box.</para>
+              </listitem>
+            </varlistentry>
+          </variablelist>
+        </para>
+      </formalpara>
+
+  </refsect1>
+  <refsect1>
+    <title>FILES</title>
+
+    <variablelist>
+      <varlistentry>
+        <term><filename>~/.viking/maps.xml</filename></term>
+        <listitem>
+          <para>File containing definition of map sources.</para>
+          <para>See previous section for details.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking/goto_tools.xml</filename></term>
+        <listitem>
+          <para>File containing definition of "Go-to" services.</para>
+          <para>See previous section for details.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking/external_tools.xml</filename></term>
+        <listitem>
+          <para>File containing definition of external tools.</para>
+          <para>See previous section for details.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking/datasources.xml</filename></term>
+        <listitem>
+          <para>File containing definition of remote file datasources.</para>
+          <para>See previous section for details.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking/viking.prefs</filename></term>
+        <listitem>
+          <para>Preferences for &dhpackage;.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking/viking_layer_defaults.ini</filename></term>
+        <listitem>
+          <para>Layer default values for &dhpackage;.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking/viking.ini</filename></term>
+        <listitem>
+          <para>Values for &dhpackage; automatically saved between sessions.</para>
+          <para>Not generally intended to be manually edited.</para>
+         <para>However some finer control of default internal values can be set.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking/keys.rc</filename></term>
+        <listitem>
+          <para>File containing short cut key accelerators.</para>
+          <para>This is in the standard GTK Accelerator map format.</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking/cookies.txt</filename></term>
+        <listitem>
+          <para>File hosting cookies used by &dhpackage;.</para>
+        </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><filename>~/.viking-maps/</filename></term>
+        <listitem>
+          <para>Default location of the map cache of tiles downloaded or created by &dhpackage;.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+       <para>Extension files (<filename>maps.xml</filename>,
+       <filename>goto_tools.xml</filename>,
+       <filename>datasources.xml</filename>,
+       <filename>external_tools.xml</filename>)
+       are also searched in <filename>/etc/viking</filename> and
+       <filename>/usr/share/viking</filename> directories (or related in your system).</para>
+
+  </refsect1>
+  <refsect1>
+    <title>ENVIRONMENT</title>
+
+    <variablelist>
+      <varlistentry>
+        <term><envar>XDG_DATA_HOME</envar></term>
+        <listitem>
+          <para>Optional directory to look for extension files
+          (<filename>maps.xml</filename>, <filename>goto_tools.xml</filename>,
+          <filename>external_tools.xml</filename>).</para>
+       </listitem>
+      </varlistentry>
+      <varlistentry>
+        <term><envar>XDG_DATA_DIRS</envar></term>
+        <listitem>
+          <para>Path used to change the directories scanned for extension files
+          (<filename>maps.xml</filename>, <filename>goto_tools.xml</filename>,
+          <filename>external_tools.xml</filename>).</para>
+       </listitem>
+      </varlistentry>
+    </variablelist>
+
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>This manual page was originally written by &dhusername; &dhemail; for
+      the &debian; system (but may be used by others).  Permission is
+      granted to copy, distribute and/or modify this document under
+      the terms of the &gnu; General Public License, Version 2 any 
+         later version published by the Free Software Foundation.
+    </para>
+       <para>
+         On Debian systems, the complete text of the GNU General Public
+         License can be found in /usr/share/common-licenses/GPL.
+       </para>
+
+  </refsect1>
+</refentry>
+</reference>