datasources.xml file should be packaged

[andy/viking.git] / help / C / commandline.xml

diff --git a/help/C/commandline.xml b/help/C/commandline.xml
index 9fef9dcae4c0d08d2c0c4b9800b1847c15adad38..89eb33e951035a946985124653690d8b2bf7ff4f 100644 (file)
--- a/help/C/commandline.xml
+++ b/help/C/commandline.xml
@@ -1,18 +1,78 @@
 <?xml version="1.0"?>
 <!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
-   [<!ENTITY appname          "Viking">]
+   [
+    <!ENTITY appname          "Viking">
+    <!ENTITY dhpackage        "viking">
+   ]
 >
 <section id="commandline">
 <title>Command Line</title>
+<section>
+<title>Overview</title>
 <para>
 &appname; being a Graphical User Interface program only has a few command line options.
 </para>
 
-<para>
-<screen>viking [OPTIONS...] files+</screen>
-</para>
+<!-- keep this cmdsynopsis aligned with the man page version -->
+<refentry>
+  <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>
+  <!-- Blank to keep xmllint parsing happy -->
+  <refsection>
+    <title></title><para></para>
+  </refsection>
+</refentry>
+</section>
 
+<section><title>Details</title>
 <para>
 Note that the ordering of files can be important depending on their file type.
 Subsequent non Viking project files are loaded into the previous Viking project, with the files being processed left to right.
@@ -83,12 +143,10 @@ This also enables some extra information features in the GUI itself, primarily o
 </table>
 
 <variablelist>
-  <varlistentry>
-    <listitem><para>Internal Map Ids:</para></listitem>
-    <listitem><para>OSM Mapnik = 13</para></listitem>
-    <listitem><para>OSM Cycle = 17</para></listitem>
-    <listitem><para>Mapquest OSM = 19</para></listitem>
-  </varlistentry>
+  <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>
 
 <para>
@@ -110,3 +168,4 @@ This is especially useful to monitor results of download requests (which need to
 </para>
 
 </section>
+</section>