[routino] 10/13: Add man pages for routino utilities.
Sebastiaan Couwenberg
sebastic at moszumanska.debian.org
Fri Feb 20 20:20:43 UTC 2015
This is an automated email from the git hooks/post-receive script.
sebastic pushed a commit to branch master
in repository routino.
commit 0219804fc89bef1c78456e6bfe16f8f8944e2e34
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Fri Feb 20 18:43:25 2015 +0100
Add man pages for routino utilities.
---
debian/changelog | 2 +
debian/control | 6 +-
debian/man/filedumper-slim.1.xml | 407 ++++++++++++++++++++
debian/man/filedumper.1.xml | 407 ++++++++++++++++++++
debian/man/filedumperx.1.xml | 155 ++++++++
debian/man/planetsplitter-slim.1.xml | 346 +++++++++++++++++
debian/man/planetsplitter.1.xml | 405 ++++++++++++++++++++
debian/man/routino-router-slim.1.xml | 696 +++++++++++++++++++++++++++++++++++
debian/man/routino-router.1.xml | 696 +++++++++++++++++++++++++++++++++++
debian/routino.manpages | 1 +
debian/rules | 14 +
11 files changed, 3134 insertions(+), 1 deletion(-)
diff --git a/debian/changelog b/debian/changelog
index 93b0d77..a2b920f 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -6,6 +6,8 @@ routino (2.7.3-1) UNRELEASED; urgency=medium
* Update copyright file using copyright-format 1.0.
* Add upstream metadata.
* Add substitution variable ${perl:Depends} to routino-www.
+ * Add man pages for routino utilities.
+ (closes: #704172)
-- Bas Couwenberg <sebastic at debian.org> Fri, 06 Feb 2015 21:22:51 +0100
diff --git a/debian/control b/debian/control
index de6ee2a..b4392fa 100644
--- a/debian/control
+++ b/debian/control
@@ -8,7 +8,11 @@ Priority: extra
Build-Depends: debhelper (>= 9),
flex,
libbz2-dev,
- zlib1g-dev
+ zlib1g-dev,
+ docbook2x,
+ docbook-xsl,
+ docbook-xml,
+ xsltproc
Standards-Version: 3.9.6
Vcs-Browser: http://anonscm.debian.org/cgit/pkg-grass/routino.git
Vcs-Git: git://anonscm.debian.org/pkg-grass/routino.git
diff --git a/debian/man/filedumper-slim.1.xml b/debian/man/filedumper-slim.1.xml
new file mode 100644
index 0000000..9f5e88c
--- /dev/null
+++ b/debian/man/filedumper-slim.1.xml
@@ -0,0 +1,407 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='filedumper-slim'>
+
+ <refmeta>
+ <refentrytitle>filedumper-slim</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>filedumper-slim</refname>
+ <refpurpose>dump routino database contents</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>filedumper-slim</command>
+ <arg choice='opt'><option>--help</option></arg>
+ <arg choice='opt'><option>--dir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--prefix=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--statistics</option></arg>
+ <arg choice='opt'><option>--visualiser</option>
+ <arg choice='plain'><option>--latmin=<replaceable>latmin</replaceable></option></arg>
+ <arg choice='plain'><option>--latmax=<replaceable>latmax</replaceable></option></arg>
+ <arg choice='plain'><option>--lonmin=<replaceable>lonmin</replaceable></option></arg>
+ <arg choice='plain'><option>--lonmax=<replaceable>lonmax</replaceable></option></arg>
+ <arg choice='plain'><option>--data=<replaceable>data-type</replaceable></option></arg>
+ </arg>
+ <arg choice='opt'><option>--dump</option>
+ <arg choice='opt'><option>--node=<replaceable>node</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--segment=<replaceable>segment</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--way=<replaceable>way</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--turn-relation=<replaceable>rel</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--errorlog=<replaceable>number</replaceable></option> ...</arg>
+ </arg>
+ <arg choice='opt'><option>--dump-osm</option>
+ <arg choice='opt'><option>--no-super</option></arg>
+ <arg choice='opt'><option>--latmin=<replaceable>latmin</replaceable></option>
+ <arg choice='plain'><option>--latmax=<replaceable>latmax</replaceable></option></arg>
+ <arg choice='plain'><option>--lonmin=<replaceable>lonmin</replaceable></option></arg>
+ <arg choice='plain'><option>--lonmax=<replaceable>lonmax</replaceable></option></arg>
+ </arg>
+ </arg>
+ <arg choice='opt'><option>--dump-visualiser</option>
+ <arg choice='opt'><option>--data=node<node></option></arg>
+ <arg choice='opt'><option>--data=segment<segment></option></arg>
+ <arg choice='opt'><option>--data=turn-relation<rel></option></arg>
+ <arg choice='opt'><option>--data=errorlog<number></option></arg>
+ </arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>filedumper-slim</command> is used to extract statistics from the
+ <command>routino</command> database, extract particular information for
+ visualisation purposes or for dumping the database contents.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>
+ Prints usage information
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ The directory containing the routing database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prefix</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ The filename prefix for the routing database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--statistics</option></term>
+ <listitem>
+ <para>
+ Print statistics about the routing database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--visualiser</option></term>
+ <listitem>
+ <para>
+ Extract selected data from the routing database:
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--latmin</option>=<replaceable>latmin</replaceable></term>
+ <listitem>
+ <para>
+ The minimum latitude (degrees N)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--latmax</option>=<replaceable>latmax</replaceable></term>
+ <listitem>
+ <para>
+ The maximum latitude (degrees N).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lonmin</option>=<replaceable>lonmin</replaceable></term>
+ <listitem>
+ <para>
+ The minimum longitude (degrees E).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lonmax</option>=<replaceable>lonmax</replaceable></term>
+ <listitem>
+ <para>
+ The maximum longitude (degrees E).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--data</option>=<replaceable>data-type</replaceable></term>
+ <listitem>
+ <para>
+ The type of data to select.
+ </para>
+ <para>
+ <replaceable>data-type</replaceable> can be selected from:
+ <informaltable frame='none' colsep='0' rowsep='0'>
+ <tgroup cols='3'>
+ <tbody>
+ <row>
+ <entry>junctions</entry>
+ <entry>=</entry>
+ <entry>segment count at each junction.</entry>
+ </row>
+ <row>
+ <entry>super</entry>
+ <entry>=</entry>
+ <entry>super-node and super-segments.</entry>
+ </row>
+ <row>
+ <entry>waytype-*</entry>
+ <entry>=</entry>
+ <entry>segments of oneway, cyclebothways or roundabout type.</entry>
+ </row>
+ <row>
+ <entry>highway-*</entry>
+ <entry>=</entry>
+ <entry>segments of the specified highway type.</entry>
+ </row>
+ <row>
+ <entry>transport-*</entry>
+ <entry>=</entry>
+ <entry>segments allowing the specified transport type.</entry>
+ </row>
+ <row>
+ <entry>barrier-*</entry>
+ <entry>=</entry>
+ <entry>nodes disallowing the specified transport type.</entry>
+ </row>
+ <row>
+ <entry>turns</entry>
+ <entry>=</entry>
+ <entry>turn restrictions.</entry>
+ </row>
+ <row>
+ <entry>speed</entry>
+ <entry>=</entry>
+ <entry>speed limits.</entry>
+ </row>
+ <row>
+ <entry>weight</entry>
+ <entry>=</entry>
+ <entry>weight limits.</entry>
+ </row>
+ <row>
+ <entry>height</entry>
+ <entry>=</entry>
+ <entry>height limits.</entry>
+ </row>
+ <row>
+ <entry>width</entry>
+ <entry>=</entry>
+ <entry>width limits.</entry>
+ </row>
+ <row>
+ <entry>length</entry>
+ <entry>=</entry>
+ <entry>length limits.</entry>
+ </row>
+ <row>
+ <entry>property-*</entry>
+ <entry>=</entry>
+ <entry>segments with the specified property.</entry>
+ </row>
+ <row>
+ <entry>errorlogs</entry>
+ <entry>=</entry>
+ <entry>errors logged during parsing.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dump</option></term>
+ <listitem>
+ <para>
+ Dump selected contents of the database.
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--node</option>=<replaceable>node</replaceable></term>
+ <listitem>
+ <para>
+ The node with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--segment</option>=<replaceable>segment</replaceable></term>
+ <listitem>
+ <para>
+ The segment with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--way</option>=<replaceable>way</replaceable></term>
+ <listitem>
+ <para>
+ The way with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--turn-relation</option>=<replaceable>rel</replaceable></term>
+ <listitem>
+ <para>
+ The turn relation with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--errorlog</option>=<replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ The error log with the selected index.
+ </para>
+ <para>
+ Use 'all' instead of a number to get all of them.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dump-osm</option></term>
+ <listitem>
+ <para>
+ Dump all or part of the database as an XML file.
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--no-super</option></term>
+ <listitem>
+ <para>
+ Exclude the super-segments.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--latmin</option>=<replaceable>latmin</replaceable></term>
+ <listitem>
+ <para>
+ The minimum latitude (degrees N).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--latmax</option>=<replaceable>latmax</replaceable></term>
+ <listitem>
+ <para>
+ The maximum latitude (degrees N).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lonmin</option>=<replaceable>lonmin</replaceable></term>
+ <listitem>
+ <para>
+ The minimum longitude (degrees E).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lonmax</option>=<replaceable>lonmax</replaceable></term>
+ <listitem>
+ <para>
+ The maximum longitude (degrees E).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dump-visualiser</option></term>
+ <listitem>
+ <para>
+ Dump selected contents of the database in HTML.
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--data</option>=node<node></term>
+ <listitem>
+ <para>
+ The node with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--data</option>=segment<segment></term>
+ <listitem>
+ <para>
+ The segment with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--data</option>=turn-relation<rel></term>
+ <listitem>
+ <para>
+ The turn relation with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--data</option>=errorlog<number></term>
+ <listitem>
+ <para>
+ The error log with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/filedumper.1.xml b/debian/man/filedumper.1.xml
new file mode 100644
index 0000000..8394a66
--- /dev/null
+++ b/debian/man/filedumper.1.xml
@@ -0,0 +1,407 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='filedumper'>
+
+ <refmeta>
+ <refentrytitle>filedumper</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>filedumper</refname>
+ <refpurpose>dump routino database contents</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>filedumper</command>
+ <arg choice='opt'><option>--help</option></arg>
+ <arg choice='opt'><option>--dir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--prefix=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--statistics</option></arg>
+ <arg choice='opt'><option>--visualiser</option>
+ <arg choice='plain'><option>--latmin=<replaceable>latmin</replaceable></option></arg>
+ <arg choice='plain'><option>--latmax=<replaceable>latmax</replaceable></option></arg>
+ <arg choice='plain'><option>--lonmin=<replaceable>lonmin</replaceable></option></arg>
+ <arg choice='plain'><option>--lonmax=<replaceable>lonmax</replaceable></option></arg>
+ <arg choice='plain'><option>--data=<replaceable>data-type</replaceable></option></arg>
+ </arg>
+ <arg choice='opt'><option>--dump</option>
+ <arg choice='opt'><option>--node=<replaceable>node</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--segment=<replaceable>segment</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--way=<replaceable>way</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--turn-relation=<replaceable>rel</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--errorlog=<replaceable>number</replaceable></option> ...</arg>
+ </arg>
+ <arg choice='opt'><option>--dump-osm</option>
+ <arg choice='opt'><option>--no-super</option></arg>
+ <arg choice='opt'><option>--latmin=<replaceable>latmin</replaceable></option>
+ <arg choice='plain'><option>--latmax=<replaceable>latmax</replaceable></option></arg>
+ <arg choice='plain'><option>--lonmin=<replaceable>lonmin</replaceable></option></arg>
+ <arg choice='plain'><option>--lonmax=<replaceable>lonmax</replaceable></option></arg>
+ </arg>
+ </arg>
+ <arg choice='opt'><option>--dump-visualiser</option>
+ <arg choice='opt'><option>--data=node<node></option></arg>
+ <arg choice='opt'><option>--data=segment<segment></option></arg>
+ <arg choice='opt'><option>--data=turn-relation<rel></option></arg>
+ <arg choice='opt'><option>--data=errorlog<number></option></arg>
+ </arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>filedumper</command> is used to extract statistics from the
+ <command>routino</command> database, extract particular information for
+ visualisation purposes or for dumping the database contents.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>
+ Prints usage information
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ The directory containing the routing database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prefix</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ The filename prefix for the routing database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--statistics</option></term>
+ <listitem>
+ <para>
+ Print statistics about the routing database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--visualiser</option></term>
+ <listitem>
+ <para>
+ Extract selected data from the routing database:
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--latmin</option>=<replaceable>latmin</replaceable></term>
+ <listitem>
+ <para>
+ The minimum latitude (degrees N)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--latmax</option>=<replaceable>latmax</replaceable></term>
+ <listitem>
+ <para>
+ The maximum latitude (degrees N).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lonmin</option>=<replaceable>lonmin</replaceable></term>
+ <listitem>
+ <para>
+ The minimum longitude (degrees E).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lonmax</option>=<replaceable>lonmax</replaceable></term>
+ <listitem>
+ <para>
+ The maximum longitude (degrees E).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--data</option>=<replaceable>data-type</replaceable></term>
+ <listitem>
+ <para>
+ The type of data to select.
+ </para>
+ <para>
+ <replaceable>data-type</replaceable> can be selected from:
+ <informaltable frame='none' colsep='0' rowsep='0'>
+ <tgroup cols='3'>
+ <tbody>
+ <row>
+ <entry>junctions</entry>
+ <entry>=</entry>
+ <entry>segment count at each junction.</entry>
+ </row>
+ <row>
+ <entry>super</entry>
+ <entry>=</entry>
+ <entry>super-node and super-segments.</entry>
+ </row>
+ <row>
+ <entry>waytype-*</entry>
+ <entry>=</entry>
+ <entry>segments of oneway, cyclebothways or roundabout type.</entry>
+ </row>
+ <row>
+ <entry>highway-*</entry>
+ <entry>=</entry>
+ <entry>segments of the specified highway type.</entry>
+ </row>
+ <row>
+ <entry>transport-*</entry>
+ <entry>=</entry>
+ <entry>segments allowing the specified transport type.</entry>
+ </row>
+ <row>
+ <entry>barrier-*</entry>
+ <entry>=</entry>
+ <entry>nodes disallowing the specified transport type.</entry>
+ </row>
+ <row>
+ <entry>turns</entry>
+ <entry>=</entry>
+ <entry>turn restrictions.</entry>
+ </row>
+ <row>
+ <entry>speed</entry>
+ <entry>=</entry>
+ <entry>speed limits.</entry>
+ </row>
+ <row>
+ <entry>weight</entry>
+ <entry>=</entry>
+ <entry>weight limits.</entry>
+ </row>
+ <row>
+ <entry>height</entry>
+ <entry>=</entry>
+ <entry>height limits.</entry>
+ </row>
+ <row>
+ <entry>width</entry>
+ <entry>=</entry>
+ <entry>width limits.</entry>
+ </row>
+ <row>
+ <entry>length</entry>
+ <entry>=</entry>
+ <entry>length limits.</entry>
+ </row>
+ <row>
+ <entry>property-*</entry>
+ <entry>=</entry>
+ <entry>segments with the specified property.</entry>
+ </row>
+ <row>
+ <entry>errorlogs</entry>
+ <entry>=</entry>
+ <entry>errors logged during parsing.</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dump</option></term>
+ <listitem>
+ <para>
+ Dump selected contents of the database.
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--node</option>=<replaceable>node</replaceable></term>
+ <listitem>
+ <para>
+ The node with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--segment</option>=<replaceable>segment</replaceable></term>
+ <listitem>
+ <para>
+ The segment with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--way</option>=<replaceable>way</replaceable></term>
+ <listitem>
+ <para>
+ The way with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--turn-relation</option>=<replaceable>rel</replaceable></term>
+ <listitem>
+ <para>
+ The turn relation with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--errorlog</option>=<replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ The error log with the selected index.
+ </para>
+ <para>
+ Use 'all' instead of a number to get all of them.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dump-osm</option></term>
+ <listitem>
+ <para>
+ Dump all or part of the database as an XML file.
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--no-super</option></term>
+ <listitem>
+ <para>
+ Exclude the super-segments.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--latmin</option>=<replaceable>latmin</replaceable></term>
+ <listitem>
+ <para>
+ The minimum latitude (degrees N).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--latmax</option>=<replaceable>latmax</replaceable></term>
+ <listitem>
+ <para>
+ The maximum latitude (degrees N).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lonmin</option>=<replaceable>lonmin</replaceable></term>
+ <listitem>
+ <para>
+ The minimum longitude (degrees E).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lonmax</option>=<replaceable>lonmax</replaceable></term>
+ <listitem>
+ <para>
+ The maximum longitude (degrees E).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dump-visualiser</option></term>
+ <listitem>
+ <para>
+ Dump selected contents of the database in HTML.
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--data</option>=node<node></term>
+ <listitem>
+ <para>
+ The node with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--data</option>=segment<segment></term>
+ <listitem>
+ <para>
+ The segment with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--data</option>=turn-relation<rel></term>
+ <listitem>
+ <para>
+ The turn relation with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--data</option>=errorlog<number></term>
+ <listitem>
+ <para>
+ The error log with the selected index.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/filedumperx.1.xml b/debian/man/filedumperx.1.xml
new file mode 100644
index 0000000..1ccb0a6
--- /dev/null
+++ b/debian/man/filedumperx.1.xml
@@ -0,0 +1,155 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='filedumperx'>
+
+ <refmeta>
+ <refentrytitle>filedumperx</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>filedumperx</refname>
+ <refpurpose>dump contents of planetsplitter intermediate data</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>filedumperx</command>
+ <arg choice='opt'><option>--help</option></arg>
+ <arg choice='opt'><option>--dir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--prefix=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--dump</option>
+ <arg choice='opt'><option>--nodes</option></arg>
+ <arg choice='opt'><option>--ways</option></arg>
+ <arg choice='opt'><option>--route-relations</option></arg>
+ <arg choice='opt'><option>--turn-relations</option></arg>
+ </arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>filedumperx</command> is a modified version of
+ <citerefentry>
+ <refentrytitle>filedumper</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ that will dump out the contents of the intermediate data that is saved by
+ <citerefentry>
+ <refentrytitle>planetsplitter</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ after processing using the <option>--keep</option> or
+ <option>--changes</option> option.
+ This is intended for test purposes only and gives no useful information
+ about the <command>routino</command> routing database.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>
+ Prints usage information
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ Sets the directory name in which to read the local database.
+ Defaults to the current directory.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prefix</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename prefix for the files in the local database.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dump</option></term>
+ <listitem>
+ <para>
+ Dumps the complete set of data in the intermediate files that are
+ written by
+ <citerefentry>
+ <refentrytitle>planetsplitter</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+ using the <option>--keep</option> or <option>--changes</option>
+ options.
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--nodes</option></term>
+ <listitem>
+ <para>
+ Dumps the node data.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--ways</option></term>
+ <listitem>
+ <para>
+ Dumps the way data.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--route-relations</option></term>
+ <listitem>
+ <para>
+ Dumps the route relation data.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--turn-relations</option></term>
+ <listitem>
+ <para>
+ Dumps the turn relation data.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+ <refsect1 id='see-also'>
+ <title>SEE ALSO</title>
+
+ <citerefentry>
+ <refentrytitle>filedumper</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>,
+
+ <citerefentry>
+ <refentrytitle>planetsplitter</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/planetsplitter-slim.1.xml b/debian/man/planetsplitter-slim.1.xml
new file mode 100644
index 0000000..5bfdf1d
--- /dev/null
+++ b/debian/man/planetsplitter-slim.1.xml
@@ -0,0 +1,346 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='planetsplitter-slim'>
+
+ <refmeta>
+ <refentrytitle>planetsplitter-slim</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>planetsplitter-slim</refname>
+ <refpurpose>split OSM XML data into routino database</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>planetsplitter-slim</command>
+ <arg choice='opt'><option>--help</option></arg>
+ <arg choice='opt'><option>--dir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--prefix=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--sort-ram-size=<replaceable>size</replaceable></option></arg>
+ <arg choice='opt'><option>--sort-threads=<replaceable>number</replaceable></option></arg>
+ <arg choice='opt'><option>--tmpdir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--tagging=<replaceable>filename</replaceable></option></arg>
+ <arg choice='opt'><option>--loggable</option></arg>
+ <arg choice='opt'><option>--logtime</option></arg>
+ <arg choice='opt'><option>--logmemory</option></arg>
+ <arg choice='opt'><option>--errorlog<arg choice='opt'>=<replaceable>name</replaceable></arg></option></arg>
+ <group>
+ <arg choice='opt'><option>--parse-only</option></arg>
+ <arg choice='opt'><option>--process-only</option></arg>
+ </group>
+ <arg choice='opt'><option>--append</option></arg>
+ <arg choice='opt'><option>--keep</option></arg>
+ <arg choice='opt'><option>--changes</option></arg>
+ <arg choice='opt'><option>--max-iterations=<replaceable>number</replaceable></option></arg>
+ <arg choice='opt'><option>--prune-none</option></arg>
+ <arg choice='opt'><option>--prune-isolated=<replaceable>len</replaceable></option></arg>
+ <arg choice='opt'><option>--prune-short=<replaceable>len</replaceable></option></arg>
+ <arg choice='opt'><option>--prune-straight=<replaceable>len</replaceable></option></arg>
+ <group>
+ <arg choice='opt'><replaceable>filename.osm</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.osc</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.pbf</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.o5m</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.o5c</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.(o5m|osc|os5m|o5c).bz2</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.(o5m|osc|os5m|o5c).gz</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.(o5m|osc|os5m|o5c).xz</replaceable> ...</arg>
+ </group>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>planetsplitter-slim</command> reads in the OSM format XML file and
+ splits it up to create the <command>routino</command> database that is
+ for routing.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>
+ Prints usage information
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ Sets the directory name in which to save the results.
+ Defaults to the current directory.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prefix</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename prefix for the files that are created.
+ Defaults to no prefix.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--sort-ram-size</option>=<replaceable>size</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the amount of RAM (in MB) to use for sorting the data.
+ If not specified then 64 MB will be used in slim mode or 256 MB
+ otherwise.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--sort-threads</option>=<replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ The number of threads to use for data sorting (the sorting memory
+ is shared between the threads \- too many threads and not enough
+ memory will reduce the performance).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--tmpdir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the name of the directory to store the temporary disk
+ files.
+ If not specified then it defaults to either the value of the
+ <option>--dir</option> option or the current directory.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--tagging</option>=<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename containing the list of tagging rules in XML
+ format for the parsing the input files.
+ If the file doesn't exist then
+ <replaceable>dirname</replaceable>,
+ <replaceable>prefix</replaceable> and "profiles.xml" will be
+ combined and used, if that doesn't exist then the file
+ <filename>/usr/share/routino/profiles.xml</filename>
+ will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--loggable</option></term>
+ <listitem>
+ <para>
+ Print progress messages that are suitable for logging to a file;
+ normally an incrementing counter is printed which is more suitable
+ for real-time display than logging.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--logtime</option>></term>
+ <listitem>
+ <para>
+ Print the elapsed time for each processing step
+ (minutes, seconds and milliseconds).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--logmemory</option></term>
+ <listitem>
+ <para>
+ Print the maximum allocated and mapped memory for each processing
+ step (MBytes).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--errorlog[=<replaceable>name</replaceable>]</option></term>
+ <listitem>
+ <para>
+ Log OSM parsing and processing errors to
+ <filename>error.log</filename> or the specified file name
+ (the <option>--dir</option> and <option>--prefix</option> options
+ are applied).
+ If the <option>--append</option> option is used then the existing
+ log file will be appended, otherwise a new one will be created.
+ If the <option>--keep</option> option is also used a geographically
+ searchable database of error logs is created for use in the
+ visualiser.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--parse-only</option></term>
+ <listitem>
+ <para>
+ Parse the input files and store the data in intermediate files but
+ don't process the data into a routing database.
+ This option must be used with the <option>--append</option> option
+ for all except the first file.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--process-only</option></term>
+ <listitem>
+ <para>
+ Don't read in any files but process the existing intermediate files
+ created by using the <option>--parse-only</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--append</option></term>
+ <listitem>
+ <para>
+ Parse the input file and append the result to the existing
+ intermediate files; the appended file can be either an OSM
+ file or an OSC change file.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--keep</option></term>
+ <listitem>
+ <para>
+ Store a set of intermediate files after parsing the OSM files,
+ sorting and removing duplicates; this allows appending an OSC
+ file and re-processing later.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--changes</option></term>
+ <listitem>
+ <para>
+ This option indicates that the data being processed contains one or
+ more OSC (OSM changes) files, they must be applied in time sequence
+ if more than one is used.
+ This option implies <option>--append</option> when parsing data
+ files and <option>--keep</option> when processing data.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--max-iterations</option>=<replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ The maximum number of iterations to use when generating super-nodes
+ and super-segments.
+ Defaults to 5 which is normally enough.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prune-none</option></term>
+ <listitem>
+ <para>
+ Disable the prune options below, they can be re-enabled by adding
+ them to the command line after this option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prune-isolated</option>=<replaceable>length</replaceable></term>
+ <listitem>
+ <para>
+ Remove the access permissions for a transport type from small
+ disconnected groups of segments and remove the segments if they
+ end up with no access permission (defaults to removing groups
+ under 500m).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prune-short</option>=<replaceable>length</replaceable></term>
+ <listitem>
+ <para>
+ Remove short segments (defaults to removing segments up to a
+ maximum length of 5m).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prune-straight=</option>=<replaceable>length</replaceable></term>
+ <listitem>
+ <para>
+ Remove nodes in almost straight highways (defaults to removing
+ nodes up to 3m offset from a straight line).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><filename>filename.osm</filename></term>
+ <term><filename>filename.osc</filename></term>
+ <term><filename>filename.pbf</filename></term>
+ <term><filename>filename.o5m</filename></term>
+ <term><filename>filename.o5c</filename></term>
+ <listitem>
+ <para>
+ Specifies the filename(s) to read data from.
+ Filenames ending '.pbf' will be read as PBF, filenames ending in
+ '.o5m' or '.o5c' will be read as O5M/O5C, otherwise as XML.
+ Filenames ending '.bz2' will be bzip2 uncompressed
+ (if bzip2 support compiled in).
+ Filenames ending '.gz' will be gzip uncompressed
+ (if gzip support compiled in).
+ Filenames ending '.xz' will be xz uncompressed
+ (if xz support compiled in).
+ </para>
+ <para>
+ Note: In version 2.5 of Routino the ability to read data from the
+ standard input has been removed.
+ This is because there is now the ability to read compressed files
+ (bzip2, gzip, xz) and PBF files directly.
+ Also using standard input the file type cannot be auto-detected
+ from the filename.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+ <refsect1 id='see-also'>
+ <title>SEE ALSO</title>
+
+ <citerefentry>
+ <refentrytitle>planetsplitter</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/planetsplitter.1.xml b/debian/man/planetsplitter.1.xml
new file mode 100644
index 0000000..fa81569
--- /dev/null
+++ b/debian/man/planetsplitter.1.xml
@@ -0,0 +1,405 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='planetsplitter'>
+
+ <refmeta>
+ <refentrytitle>planetsplitter</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>planetsplitter</refname>
+ <refpurpose>split OSM XML data into routino database</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>planetsplitter</command>
+ <arg choice='opt'><option>--help</option></arg>
+ <arg choice='opt'><option>--dir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--prefix=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--sort-ram-size=<replaceable>size</replaceable></option></arg>
+ <arg choice='opt'><option>--sort-threads=<replaceable>number</replaceable></option></arg>
+ <arg choice='opt'><option>--tmpdir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--tagging=<replaceable>filename</replaceable></option></arg>
+ <arg choice='opt'><option>--loggable</option></arg>
+ <arg choice='opt'><option>--logtime</option></arg>
+ <arg choice='opt'><option>--logmemory</option></arg>
+ <arg choice='opt'><option>--errorlog<arg choice='opt'>=<replaceable>name</replaceable></arg></option></arg>
+ <group>
+ <arg choice='opt'><option>--parse-only</option></arg>
+ <arg choice='opt'><option>--process-only</option></arg>
+ </group>
+ <arg choice='opt'><option>--append</option></arg>
+ <arg choice='opt'><option>--keep</option></arg>
+ <arg choice='opt'><option>--changes</option></arg>
+ <arg choice='opt'><option>--max-iterations=<replaceable>number</replaceable></option></arg>
+ <arg choice='opt'><option>--prune-none</option></arg>
+ <arg choice='opt'><option>--prune-isolated=<replaceable>len</replaceable></option></arg>
+ <arg choice='opt'><option>--prune-short=<replaceable>len</replaceable></option></arg>
+ <arg choice='opt'><option>--prune-straight=<replaceable>len</replaceable></option></arg>
+ <group>
+ <arg choice='opt'><replaceable>filename.osm</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.osc</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.pbf</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.o5m</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.o5c</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.(o5m|osc|os5m|o5c).bz2</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.(o5m|osc|os5m|o5c).gz</replaceable> ...</arg>
+ <arg choice='opt'><replaceable>filename.(o5m|osc|os5m|o5c).xz</replaceable> ...</arg>
+ </group>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>planetsplitter</command> reads in the OSM format XML file and
+ splits it up to create the <command>routino</command> database that is
+ for routing.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>
+ Prints usage information
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ Sets the directory name in which to save the results.
+ Defaults to the current directory.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prefix</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename prefix for the files that are created.
+ Defaults to no prefix.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--sort-ram-size</option>=<replaceable>size</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the amount of RAM (in MB) to use for sorting the data.
+ If not specified then 64 MB will be used in slim mode or 256 MB
+ otherwise.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--sort-threads</option>=<replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ The number of threads to use for data sorting (the sorting memory
+ is shared between the threads \- too many threads and not enough
+ memory will reduce the performance).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--tmpdir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the name of the directory to store the temporary disk
+ files.
+ If not specified then it defaults to either the value of the
+ <option>--dir</option> option or the current directory.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--tagging</option>=<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename containing the list of tagging rules in XML
+ format for the parsing the input files.
+ If the file doesn't exist then
+ <replaceable>dirname</replaceable>,
+ <replaceable>prefix</replaceable> and "profiles.xml" will be
+ combined and used, if that doesn't exist then the file
+ <filename>/usr/share/routino/profiles.xml</filename>
+ will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--loggable</option></term>
+ <listitem>
+ <para>
+ Print progress messages that are suitable for logging to a file;
+ normally an incrementing counter is printed which is more suitable
+ for real-time display than logging.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--logtime</option>></term>
+ <listitem>
+ <para>
+ Print the elapsed time for each processing step
+ (minutes, seconds and milliseconds).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--logmemory</option></term>
+ <listitem>
+ <para>
+ Print the maximum allocated and mapped memory for each processing
+ step (MBytes).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--errorlog[=<replaceable>name</replaceable>]</option></term>
+ <listitem>
+ <para>
+ Log OSM parsing and processing errors to
+ <filename>error.log</filename> or the specified file name
+ (the <option>--dir</option> and <option>--prefix</option> options
+ are applied).
+ If the <option>--append</option> option is used then the existing
+ log file will be appended, otherwise a new one will be created.
+ If the <option>--keep</option> option is also used a geographically
+ searchable database of error logs is created for use in the
+ visualiser.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--parse-only</option></term>
+ <listitem>
+ <para>
+ Parse the input files and store the data in intermediate files but
+ don't process the data into a routing database.
+ This option must be used with the <option>--append</option> option
+ for all except the first file.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--process-only</option></term>
+ <listitem>
+ <para>
+ Don't read in any files but process the existing intermediate files
+ created by using the <option>--parse-only</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--append</option></term>
+ <listitem>
+ <para>
+ Parse the input file and append the result to the existing
+ intermediate files; the appended file can be either an OSM
+ file or an OSC change file.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--keep</option></term>
+ <listitem>
+ <para>
+ Store a set of intermediate files after parsing the OSM files,
+ sorting and removing duplicates; this allows appending an OSC
+ file and re-processing later.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--changes</option></term>
+ <listitem>
+ <para>
+ This option indicates that the data being processed contains one or
+ more OSC (OSM changes) files, they must be applied in time sequence
+ if more than one is used.
+ This option implies <option>--append</option> when parsing data
+ files and <option>--keep</option> when processing data.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--max-iterations</option>=<replaceable>number</replaceable></term>
+ <listitem>
+ <para>
+ The maximum number of iterations to use when generating super-nodes
+ and super-segments.
+ Defaults to 5 which is normally enough.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prune-none</option></term>
+ <listitem>
+ <para>
+ Disable the prune options below, they can be re-enabled by adding
+ them to the command line after this option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prune-isolated</option>=<replaceable>length</replaceable></term>
+ <listitem>
+ <para>
+ Remove the access permissions for a transport type from small
+ disconnected groups of segments and remove the segments if they
+ end up with no access permission (defaults to removing groups
+ under 500m).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prune-short</option>=<replaceable>length</replaceable></term>
+ <listitem>
+ <para>
+ Remove short segments (defaults to removing segments up to a
+ maximum length of 5m).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prune-straight=</option>=<replaceable>length</replaceable></term>
+ <listitem>
+ <para>
+ Remove nodes in almost straight highways (defaults to removing
+ nodes up to 3m offset from a straight line).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><filename>filename.osm</filename></term>
+ <term><filename>filename.osc</filename></term>
+ <term><filename>filename.pbf</filename></term>
+ <term><filename>filename.o5m</filename></term>
+ <term><filename>filename.o5c</filename></term>
+ <listitem>
+ <para>
+ Specifies the filename(s) to read data from.
+ Filenames ending '.pbf' will be read as PBF, filenames ending in
+ '.o5m' or '.o5c' will be read as O5M/O5C, otherwise as XML.
+ Filenames ending '.bz2' will be bzip2 uncompressed
+ (if bzip2 support compiled in).
+ Filenames ending '.gz' will be gzip uncompressed
+ (if gzip support compiled in).
+ Filenames ending '.xz' will be xz uncompressed
+ (if xz support compiled in).
+ </para>
+ <para>
+ Note: In version 2.5 of Routino the ability to read data from the
+ standard input has been removed.
+ This is because there is now the ability to read compressed files
+ (bzip2, gzip, xz) and PBF files directly.
+ Also using standard input the file type cannot be auto-detected
+ from the filename.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+ <refsect1 id='examples'>
+ <title>EXAMPLES</title>
+
+ <example>
+ <para>
+ Example usage 1:
+ </para>
+ <screen>
+<command>planetsplitter</command> <option>--dir</option>=<filename>data</filename> <option>--prefix</option>=gb <filename>great_britain.osm</filename>
+ </screen>
+ <para>
+ This will generate the output files
+ <filename>data/gb-nodes.mem</filename>,
+ <filename>data/gb-segments.mem</filename> and
+ <filename>data/gb-ways.mem</filename>.
+ Multiple filenames can be specified on the command line and they will
+ all be read in, combined and processed together.
+ </para>
+ </example>
+
+ <example>
+ <para>
+ Example usage 2:
+ </para>
+ <screen>
+<command>planetsplitter</command> <option>--dir</option>=data <option>--prefix</option>=gb <option>--parse-only</option> <filename>great_britain_part1.osm</filename>
+<command>planetsplitter</command> <option>--dir</option>=data <option>--prefix</option>=gb <option>--parse-only</option> <option>--append</option> <filename>great_britain_part2.osm</filename>
+<command>planetsplitter</command> <option>--dir</option>=data <option>--prefix</option>=gb <option>--parse-only</option> <option>--append</option> ...
+<command>planetsplitter</command> <option>--dir</option>=data <option>--prefix</option>=gb <option>--process-only</option>
+ </screen>
+ <para>
+ This will generate the same output files as the first example but
+ parsing the input files is performed separately from the data
+ processing.
+ The first file read in must not use the <option>--append</option>
+ option but the later ones must.
+ </para>
+ </example>
+
+ <example>
+ <para>
+ Example usage 3:
+ </para>
+ <screen>
+<command>planetsplitter</command> <option>--dir</option>=<filename>data</filename> <option>--prefix</option>=gb <option>--keep</option> <filename>great_britain.osm</filename>
+
+<command>planetsplitter</command> <option>--dir</option>=<filename>data</filename> <option>--prefix</option>=gb <option>--changes</option> <filename>great_britain.osc</filename>
+ </screen>
+ <para>
+ This will generate the same output files as the first example.
+ The first command will process the complete file and keep some
+ intermediate data for later.
+ The second command will apply a set of changes to the stored
+ intermediate data and keep the updated intermediate files for
+ repeating this step later with more change data.
+ </para>
+ <para>
+ The parsing and processing can be split into multiple commands
+ as it was in example 2 with the <option>--keep</option> option
+ used with <option>--process-only</option> for the initial OSM
+ file(s) and the <option>--changes</option> option used with
+ <option>--parse-only</option> or <option>--process-only</option>
+ for every OSC file.
+ </para>
+ </example>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/routino-router-slim.1.xml b/debian/man/routino-router-slim.1.xml
new file mode 100644
index 0000000..a7042d5
--- /dev/null
+++ b/debian/man/routino-router-slim.1.xml
@@ -0,0 +1,696 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='routino-router-slim'>
+
+ <refmeta>
+ <refentrytitle>routino-router-slim</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>routino-router-slim</refname>
+ <refpurpose>calculate routes using the routino database</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>routino-router-slim</command>
+ <group>
+ <arg choice='opt'><option>--help</option></arg>
+ <arg choice='opt'><option>--help-profile-xml</option></arg>
+ <arg choice='opt'><option>--help-profile-json</option></arg>
+ <arg choice='opt'><option>--help-profile-perl</option></arg>
+ </group>
+ <arg choice='opt'><option>--dir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--prefix=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--profiles=<replaceable>filename</replaceable></option></arg>
+ <arg choice='opt'><option>--translations=<replaceable>filename</replaceable></option></arg>
+ <arg choice='opt'><option>--exact-nodes-only</option></arg>
+ <arg choice='opt'><option>--quiet</option></arg>
+ <arg choice='opt'><option>--loggable</option></arg>
+ <arg choice='opt'><option>--logtime</option></arg>
+ <arg choice='opt'><option>--logmemory</option></arg>
+ <arg choice='opt'><option>--output-html</option></arg>
+ <arg choice='opt'><option>--output-gpx-track</option></arg>
+ <arg choice='opt'><option>--output-text-all</option></arg>
+ <arg choice='opt'><option>--output-none</option></arg>
+ <arg choice='opt'><option>--output-stdout</option></arg>
+ <arg choice='opt'><option>--profile=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--transport=<replaceable>transport</replaceable></option></arg>
+ <group>
+ <arg choice='opt'><option>--shortest</option></arg>
+ <arg choice='opt'><option>--quickest</option></arg>
+ </group>
+ <arg choice='plain'><option>--lon1=<replaceable>longitude</replaceable></option> <option>--lat1=<replaceable>latitude</replaceable></option></arg>
+ <arg choice='plain'><option>--lon2=<replaceable>longitude</replaceable></option> <option>--lat2=<replaceable>latitude</replaceable></option></arg>
+ <arg choice='opt'>... <option>--lon99=<replaceable>longitude</replaceable></option> <option>--lat99=<replaceable>latitude</replaceable></option></arg>
+ <arg choice='opt'><option>--reverse</option></arg>
+ <arg choice='opt'><option>--loop</option></arg>
+ <arg choice='opt'><option>--heading=<replaceable>bearing</replaceable></option></arg>
+ <arg choice='opt'><option>--highway-<highway>=<replaceable>preference</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--speed-<highway>=<replaceable>speed</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--property-<property>=<replaceable>preference</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--oneway=<replaceable>0|1</replaceable></option></arg>
+ <arg choice='opt'><option>--turns=<replaceable>0|1</replaceable></option></arg>
+ <arg choice='opt'><option>--weight=<replaceable>weight</replaceable></option></arg>
+ <arg choice='opt'><option>--height=<replaceable>height</replaceable></option></arg>
+ <arg choice='opt'><option>--width=<replaceable>width</replaceable></option></arg>
+ <arg choice='opt'><option>--length=<replaceable>length</replaceable></option></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>routino-router-slim</command> performs the calculation of the
+ optimum routes using the database generated by the
+ <citerefentry>
+ <refentrytitle>planetsplitter</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ program.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>
+ Prints out the help information.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--help-profile</option></term>
+ <listitem>
+ <para>
+ Prints out the selected transport profile
+ (type, speed limits, highway preferences etc.)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--help-profile-xml</option></term>
+ <listitem>
+ <para>
+ Prints out all the loaded profiles as an XML file in the same
+ format that can be loaded in.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--help-profile-json</option></term>
+ <listitem>
+ <para>
+ Prints out all the loaded profiles in JavaScript Object Notation
+ (JSON) format for use in the interactive webpage.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--help-profile-perl</option></term>
+ <listitem>
+ <para>
+ Prints out all the loaded profiles as a Perl object for use in
+ the router CGI.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ Sets the directory name in which to read the local database.
+ Defaults to the current directory.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prefix</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename prefix for the files in the local database.
+ Defaults to no prefix.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--profiles</option>=<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename containing the list of routing profiles in XML
+ format.
+ If the file doesn't exist then <option>--dirname</option>,
+ <option>--prefix</option> and "profiles.xml" will be combined and
+ used, if that doesn't exist then the file
+ <filename>/usr/share/routino/profiles.xml</filename>
+ (or custom installation location) will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--translations</option>=<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename containing the list of translations in XML
+ format for the output files.
+ If the file doesn't exist then <option>--dirname</option>,
+ <option>--prefix</option> and "translations.xml" will be combined
+ and used, if that doesn't exist then the file
+ <filename>/usr/share/routino/translations.xml</filename>
+ (or custom installation location) will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--exact-nodes-only</option></term>
+ <listitem>
+ <para>
+ When processing the specified latitude and longitude points only
+ select the nearest node instead of finding the nearest point
+ within a segment (quicker but less accurate unless the points are
+ already near nodes).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--quiet</option></term>
+ <listitem>
+ <para>
+ Don't generate any screen output while running
+ (useful for running in a script).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--loggable</option></term>
+ <listitem>
+ <para>
+ Print progress messages that are suitable for logging to a file;
+ normally an incrementing counter is printed which is more suitable
+ for real-time display than logging.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--logtime</option></term>
+ <listitem>
+ <para>
+ Print the elapsed time for each processing step
+ (minutes, seconds and milliseconds).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--logmemory</option></term>
+ <listitem>
+ <para>
+ Print the maximum allocated and mapped memory for each processing
+ step (MBytes).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--language</option>=<replaceable>lang</replaceable></term>
+ <listitem>
+ <para>
+ Select the language specified from the file of translations.
+ If this option is not given and the file exists then the first
+ language in the file will be used.
+ If this option is not given and no file exists the compiled-in
+ default language (English) will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--output-html</option></term>
+ <term><option>--output-gpx-track</option></term>
+ <term><option>--output-gpx-route</option></term>
+ <term><option>--output-text</option></term>
+ <term><option>--output-text-all</option></term>
+ <listitem>
+ <para>
+ Generate the selected output file formats (HTML, GPX track file,
+ GPX route file, plain text route and/or plain text with all nodes).
+ If no output is specified then all are generated, specifying any
+ automatically disables those not specified.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--output-none</option></term>
+ <listitem>
+ <para>
+ Do not generate any output or read in any translations files.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--output-stdout</option></term>
+ <listitem>
+ <para>
+ Write to stdout instead of a file (requires exactly one output
+ format option, implies <option>--quiet</option>).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--profile</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the name of the profile to use.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--transport</option>=<replaceable>transport</replaceable></term>
+ <listitem>
+ <para>
+ Select the type of transport to use, <replaceable>transport</replaceable> can be set to:
+ <informaltable frame='none' colsep='0' rowsep='0'>
+ <tgroup cols='3'>
+ <tbody>
+ <row>
+ <entry>foot</entry>
+ <entry>=</entry>
+ <entry>Foot</entry>
+ </row>
+ <row>
+ <entry>horse</entry>
+ <entry>=</entry>
+ <entry>Horse</entry>
+ </row>
+ <row>
+ <entry>wheelchair</entry>
+ <entry>=</entry>
+ <entry>Wheelchair</entry>
+ </row>
+ <row>
+ <entry>bicycle</entry>
+ <entry>=</entry>
+ <entry>Bicycle</entry>
+ </row>
+ <row>
+ <entry>moped</entry>
+ <entry>=</entry>
+ <entry>Moped (Small motorcycle, limited speed)</entry>
+ </row>
+ <row>
+ <entry>motorcycle</entry>
+ <entry>=</entry>
+ <entry>Motorcycle</entry>
+ </row>
+ <row>
+ <entry>motorcar</entry>
+ <entry>=</entry>
+ <entry>Motorcar</entry>
+ </row>
+ <row>
+ <entry>goods</entry>
+ <entry>=</entry>
+ <entry>Goods (Small lorry, van)</entry>
+ </row>
+ <row>
+ <entry>hgv</entry>
+ <entry>=</entry>
+ <entry>HGV (Heavy Goods Vehicle \- large lorry)</entry>
+ </row>
+ <row>
+ <entry>psv</entry>
+ <entry>=</entry>
+ <entry>PSV (Public Service Vehicle \- bus, coach)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Defaults to 'motorcar', this option also selects the default
+ profile information if the <option>--profile</option> option is
+ not given and a profile matching the transport name is found.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--shortest</option></term>
+ <listitem>
+ <para>
+ Find the shortest route between the waypoints.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--quickest</option></term>
+ <listitem>
+ <para>
+ Find the quickest route between the waypoints.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lon1</option>=<replaceable>longitude</replaceable></term>
+ <term><option>--lat1</option>=<replaceable>latitude</replaceable></term>
+ <term><option>--lon2</option>=<replaceable>longitude</replaceable></term>
+ <term><option>--lat2</option>=<replaceable>latitude</replaceable></term>
+ <term>... <option>--lon99</option>=<replaceable>longitude</replaceable></term>
+ <term><option>--lat99</option>=<replaceable>latitude</replaceable></term>
+ <listitem>
+ <para>
+ The location of the waypoints that make up the start, middle and
+ end points of the route. Up to 99 waypoints can be specified and
+ the route will pass through each of the specified ones in sequence.
+ The algorithm will use the closest node or point within a segment
+ that allows the specified traffic type.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--reverse</option></term>
+ <listitem>
+ <para>
+ Find a route between the waypoints in reverse order.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--loop</option></term>
+ <listitem>
+ <para>
+ Find a route that returns to the first waypoint after the last one.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--heading</option>=<replaceable>bearing</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the initial direction of travel at the start of the
+ route (from the lowest numbered waypoint) as a compass bearing
+ from 0 to 360 degrees.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--highway-<highway></option>=<replaceable>preference</replaceable></term>
+ <listitem>
+ <para>
+ Selects the percentage preference for using each particular type
+ of highway.
+ The value of <replaceable>highway</replaceable> can be selected
+ from:
+ <informaltable frame='none' colsep='0' rowsep='0'>
+ <tgroup cols='3'>
+ <tbody>
+ <row>
+ <entry>motorway</entry>
+ <entry>=</entry>
+ <entry>Motorway</entry>
+ </row>
+ <row>
+ <entry>trunk</entry>
+ <entry>=</entry>
+ <entry>Trunk</entry>
+ </row>
+ <row>
+ <entry>primary</entry>
+ <entry>=</entry>
+ <entry>Primary</entry>
+ </row>
+ <row>
+ <entry>secondary</entry>
+ <entry>=</entry>
+ <entry>Secondary</entry>
+ </row>
+ <row>
+ <entry>tertiary</entry>
+ <entry>=</entry>
+ <entry>Tertiary</entry>
+ </row>
+ <row>
+ <entry>unclassified</entry>
+ <entry>=</entry>
+ <entry>Unclassified</entry>
+ </row>
+ <row>
+ <entry>residential</entry>
+ <entry>=</entry>
+ <entry>Residential</entry>
+ </row>
+ <row>
+ <entry>service</entry>
+ <entry>=</entry>
+ <entry>Service</entry>
+ </row>
+ <row>
+ <entry>track</entry>
+ <entry>=</entry>
+ <entry>Track</entry>
+ </row>
+ <row>
+ <entry>cycleway</entry>
+ <entry>=</entry>
+ <entry>Cycleway</entry>
+ </row>
+ <row>
+ <entry>path</entry>
+ <entry>=</entry>
+ <entry>Path</entry>
+ </row>
+ <row>
+ <entry>steps</entry>
+ <entry>=</entry>
+ <entry>Steps</entry>
+ </row>
+ <row>
+ <entry>ferry</entry>
+ <entry>=</entry>
+ <entry>Ferry</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--speed-<highway></option>=<replaceable>speed</replaceable></term>
+ <listitem>
+ <para>
+ Selects the speed limit in km/hour for each type of highway.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--property-<property></option>=<replaceable>preference</replaceable></term>
+ <listitem>
+ <para>
+ Selects the percentage preference for using each particular
+ highway property.
+ The value of <replaceable>property</replaceable> can be selected
+ from:
+ <informaltable frame='none' colsep='0' rowsep='0'>
+ <tgroup cols='3'>
+ <tbody>
+ <row>
+ <entry>paved</entry>
+ <entry>=</entry>
+ <entry>Paved (suitable for normal wheels)</entry>
+ </row>
+ <row>
+ <entry>multilane</entry>
+ <entry>=</entry>
+ <entry>Multiple lanes</entry>
+ </row>
+ <row>
+ <entry>bridge</entry>
+ <entry>=</entry>
+ <entry>Bridge</entry>
+ </row>
+ <row>
+ <entry>tunnel</entry>
+ <entry>=</entry>
+ <entry>Tunnel</entry>
+ </row>
+ <row>
+ <entry>footroute</entry>
+ <entry>=</entry>
+ <entry>A route marked for foot travel</entry>
+ </row>
+ <row>
+ <entry>bicycleroute</entry>
+ <entry>=</entry>
+ <entry>A route marked for bicycle travel</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--oneway=</option>=<replaceable>0|1</replaceable></term>
+ <listitem>
+ <para>
+ Selects if the direction of oneway streets are to be obeyed
+ (useful to not obey them when walking).
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--turns=</option>=<replaceable>0|1</replaceable></term>
+ <listitem>
+ <para>
+ Selects if turn restrictions are to be obeyed (useful to not obey
+ them when walking).
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--weight</option>=<replaceable>weight</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the weight of the mode of transport in tonnes; ensures
+ that the weight limit on the highway is not exceeded.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--height</option>=<replaceable>height</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the height of the mode of transport in metres; ensures
+ that the height limit on the highway is not exceeded.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--width</option>=<replaceable>width</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the width of the mode of transport in metres; ensures
+ that the width limit on the highway is not exceeded.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--length</option>=<replaceable>length</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the length of the mode of transport in metres; ensures
+ that the length limit on the highway is not exceeded.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ The meaning of the <replaceable>preference</replaceable> parameter in
+ the command line options is slightly different for the highway
+ preferences and the property preferences.
+ For the highway preference consider the choice between two possible
+ highways between the start and finish when looking for the shortest
+ route.
+ If highway A has a preference of 100% and highway B has a preference of
+ 90% then highway A will be chosen even if it is up to 11% longer
+ (100/90 = 111%).
+ For the highway properties each highway either has a particular property
+ or not.
+ If the preference for the property is 60% then a highway with the
+ property has a preference of 77% (sqrt(60%)) and one without has a
+ preference of 63% (sqrt(100-60%)).
+ A highway with the property will be chosen even if it is up to 22%
+ longer than one without the property (77/63 = 122%).
+ The overall preference for each highway segment is the product of the
+ preference for the highway type and all of the preferences for the
+ highway properties.
+ </para>
+
+ </refsect1>
+
+ <refsect1 id='examples'>
+ <title>EXAMPLES</title>
+
+ <example>
+ <para>
+ Example usage (motorcycle journey, scenic route, not very fast):
+ </para>
+ <screen>
+<command>routino-router-slim</command> <option>--dir</option>=<filename>data</filename> <option>--prefix</option>=gb <option>--transport</option>=motorcycle \
+ <option>--highway-motorway</option>=0 <option>--highway-trunk</option>=0 \
+ <option>--speed-primary</option>=80 <option>--speed-secondary</option>=80 \
+ <option>--quickest</option>
+ </screen>
+ <para>
+ This will use the files
+ <filename>data/gb-nodes.mem</filename>,
+ <filename>data/gb-segments.mem</filename> and
+ <filename>data/gb-ways.mem</filename> to find the quickest route by
+ motorcycle not using motorways or trunk roads and not exceeding 80
+ km/hr.
+ </para>
+ </example>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/man/routino-router.1.xml b/debian/man/routino-router.1.xml
new file mode 100644
index 0000000..0aaa876
--- /dev/null
+++ b/debian/man/routino-router.1.xml
@@ -0,0 +1,696 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd">
+<refentry id='routino-router'>
+
+ <refmeta>
+ <refentrytitle>routino-router</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>routino-router</refname>
+ <refpurpose>calculate routes using the routino database</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>routino-router</command>
+ <group>
+ <arg choice='opt'><option>--help</option></arg>
+ <arg choice='opt'><option>--help-profile-xml</option></arg>
+ <arg choice='opt'><option>--help-profile-json</option></arg>
+ <arg choice='opt'><option>--help-profile-perl</option></arg>
+ </group>
+ <arg choice='opt'><option>--dir=<replaceable>dirname</replaceable></option></arg>
+ <arg choice='opt'><option>--prefix=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--profiles=<replaceable>filename</replaceable></option></arg>
+ <arg choice='opt'><option>--translations=<replaceable>filename</replaceable></option></arg>
+ <arg choice='opt'><option>--exact-nodes-only</option></arg>
+ <arg choice='opt'><option>--quiet</option></arg>
+ <arg choice='opt'><option>--loggable</option></arg>
+ <arg choice='opt'><option>--logtime</option></arg>
+ <arg choice='opt'><option>--logmemory</option></arg>
+ <arg choice='opt'><option>--output-html</option></arg>
+ <arg choice='opt'><option>--output-gpx-track</option></arg>
+ <arg choice='opt'><option>--output-text-all</option></arg>
+ <arg choice='opt'><option>--output-none</option></arg>
+ <arg choice='opt'><option>--output-stdout</option></arg>
+ <arg choice='opt'><option>--profile=<replaceable>name</replaceable></option></arg>
+ <arg choice='opt'><option>--transport=<replaceable>transport</replaceable></option></arg>
+ <group>
+ <arg choice='opt'><option>--shortest</option></arg>
+ <arg choice='opt'><option>--quickest</option></arg>
+ </group>
+ <arg choice='plain'><option>--lon1=<replaceable>longitude</replaceable></option> <option>--lat1=<replaceable>latitude</replaceable></option></arg>
+ <arg choice='plain'><option>--lon2=<replaceable>longitude</replaceable></option> <option>--lat2=<replaceable>latitude</replaceable></option></arg>
+ <arg choice='opt'>... <option>--lon99=<replaceable>longitude</replaceable></option> <option>--lat99=<replaceable>latitude</replaceable></option></arg>
+ <arg choice='opt'><option>--reverse</option></arg>
+ <arg choice='opt'><option>--loop</option></arg>
+ <arg choice='opt'><option>--heading=<replaceable>bearing</replaceable></option></arg>
+ <arg choice='opt'><option>--highway-<highway>=<replaceable>preference</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--speed-<highway>=<replaceable>speed</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--property-<property>=<replaceable>preference</replaceable></option> ...</arg>
+ <arg choice='opt'><option>--oneway=<replaceable>0|1</replaceable></option></arg>
+ <arg choice='opt'><option>--turns=<replaceable>0|1</replaceable></option></arg>
+ <arg choice='opt'><option>--weight=<replaceable>weight</replaceable></option></arg>
+ <arg choice='opt'><option>--height=<replaceable>height</replaceable></option></arg>
+ <arg choice='opt'><option>--width=<replaceable>width</replaceable></option></arg>
+ <arg choice='opt'><option>--length=<replaceable>length</replaceable></option></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>routino-router</command> performs the calculation of the
+ optimum routes using the database generated by the
+ <citerefentry>
+ <refentrytitle>planetsplitter</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </citerefentry>
+ program.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>
+ Prints out the help information.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--help-profile</option></term>
+ <listitem>
+ <para>
+ Prints out the selected transport profile
+ (type, speed limits, highway preferences etc.)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--help-profile-xml</option></term>
+ <listitem>
+ <para>
+ Prints out all the loaded profiles as an XML file in the same
+ format that can be loaded in.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--help-profile-json</option></term>
+ <listitem>
+ <para>
+ Prints out all the loaded profiles in JavaScript Object Notation
+ (JSON) format for use in the interactive webpage.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--help-profile-perl</option></term>
+ <listitem>
+ <para>
+ Prints out all the loaded profiles as a Perl object for use in
+ the router CGI.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--dir</option>=<replaceable>dirname</replaceable></term>
+ <listitem>
+ <para>
+ Sets the directory name in which to read the local database.
+ Defaults to the current directory.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prefix</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename prefix for the files in the local database.
+ Defaults to no prefix.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--profiles</option>=<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename containing the list of routing profiles in XML
+ format.
+ If the file doesn't exist then <option>--dirname</option>,
+ <option>--prefix</option> and "profiles.xml" will be combined and
+ used, if that doesn't exist then the file
+ <filename>/usr/share/routino/profiles.xml</filename>
+ (or custom installation location) will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--translations</option>=<replaceable>filename</replaceable></term>
+ <listitem>
+ <para>
+ Sets the filename containing the list of translations in XML
+ format for the output files.
+ If the file doesn't exist then <option>--dirname</option>,
+ <option>--prefix</option> and "translations.xml" will be combined
+ and used, if that doesn't exist then the file
+ <filename>/usr/share/routino/translations.xml</filename>
+ (or custom installation location) will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--exact-nodes-only</option></term>
+ <listitem>
+ <para>
+ When processing the specified latitude and longitude points only
+ select the nearest node instead of finding the nearest point
+ within a segment (quicker but less accurate unless the points are
+ already near nodes).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--quiet</option></term>
+ <listitem>
+ <para>
+ Don't generate any screen output while running
+ (useful for running in a script).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--loggable</option></term>
+ <listitem>
+ <para>
+ Print progress messages that are suitable for logging to a file;
+ normally an incrementing counter is printed which is more suitable
+ for real-time display than logging.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--logtime</option></term>
+ <listitem>
+ <para>
+ Print the elapsed time for each processing step
+ (minutes, seconds and milliseconds).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--logmemory</option></term>
+ <listitem>
+ <para>
+ Print the maximum allocated and mapped memory for each processing
+ step (MBytes).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--language</option>=<replaceable>lang</replaceable></term>
+ <listitem>
+ <para>
+ Select the language specified from the file of translations.
+ If this option is not given and the file exists then the first
+ language in the file will be used.
+ If this option is not given and no file exists the compiled-in
+ default language (English) will be used.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--output-html</option></term>
+ <term><option>--output-gpx-track</option></term>
+ <term><option>--output-gpx-route</option></term>
+ <term><option>--output-text</option></term>
+ <term><option>--output-text-all</option></term>
+ <listitem>
+ <para>
+ Generate the selected output file formats (HTML, GPX track file,
+ GPX route file, plain text route and/or plain text with all nodes).
+ If no output is specified then all are generated, specifying any
+ automatically disables those not specified.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--output-none</option></term>
+ <listitem>
+ <para>
+ Do not generate any output or read in any translations files.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--output-stdout</option></term>
+ <listitem>
+ <para>
+ Write to stdout instead of a file (requires exactly one output
+ format option, implies <option>--quiet</option>).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--profile</option>=<replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the name of the profile to use.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--transport</option>=<replaceable>transport</replaceable></term>
+ <listitem>
+ <para>
+ Select the type of transport to use, <replaceable>transport</replaceable> can be set to:
+ <informaltable frame='none' colsep='0' rowsep='0'>
+ <tgroup cols='3'>
+ <tbody>
+ <row>
+ <entry>foot</entry>
+ <entry>=</entry>
+ <entry>Foot</entry>
+ </row>
+ <row>
+ <entry>horse</entry>
+ <entry>=</entry>
+ <entry>Horse</entry>
+ </row>
+ <row>
+ <entry>wheelchair</entry>
+ <entry>=</entry>
+ <entry>Wheelchair</entry>
+ </row>
+ <row>
+ <entry>bicycle</entry>
+ <entry>=</entry>
+ <entry>Bicycle</entry>
+ </row>
+ <row>
+ <entry>moped</entry>
+ <entry>=</entry>
+ <entry>Moped (Small motorcycle, limited speed)</entry>
+ </row>
+ <row>
+ <entry>motorcycle</entry>
+ <entry>=</entry>
+ <entry>Motorcycle</entry>
+ </row>
+ <row>
+ <entry>motorcar</entry>
+ <entry>=</entry>
+ <entry>Motorcar</entry>
+ </row>
+ <row>
+ <entry>goods</entry>
+ <entry>=</entry>
+ <entry>Goods (Small lorry, van)</entry>
+ </row>
+ <row>
+ <entry>hgv</entry>
+ <entry>=</entry>
+ <entry>HGV (Heavy Goods Vehicle \- large lorry)</entry>
+ </row>
+ <row>
+ <entry>psv</entry>
+ <entry>=</entry>
+ <entry>PSV (Public Service Vehicle \- bus, coach)</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Defaults to 'motorcar', this option also selects the default
+ profile information if the <option>--profile</option> option is
+ not given and a profile matching the transport name is found.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--shortest</option></term>
+ <listitem>
+ <para>
+ Find the shortest route between the waypoints.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--quickest</option></term>
+ <listitem>
+ <para>
+ Find the quickest route between the waypoints.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--lon1</option>=<replaceable>longitude</replaceable></term>
+ <term><option>--lat1</option>=<replaceable>latitude</replaceable></term>
+ <term><option>--lon2</option>=<replaceable>longitude</replaceable></term>
+ <term><option>--lat2</option>=<replaceable>latitude</replaceable></term>
+ <term>... <option>--lon99</option>=<replaceable>longitude</replaceable></term>
+ <term><option>--lat99</option>=<replaceable>latitude</replaceable></term>
+ <listitem>
+ <para>
+ The location of the waypoints that make up the start, middle and
+ end points of the route. Up to 99 waypoints can be specified and
+ the route will pass through each of the specified ones in sequence.
+ The algorithm will use the closest node or point within a segment
+ that allows the specified traffic type.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--reverse</option></term>
+ <listitem>
+ <para>
+ Find a route between the waypoints in reverse order.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--loop</option></term>
+ <listitem>
+ <para>
+ Find a route that returns to the first waypoint after the last one.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--heading</option>=<replaceable>bearing</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the initial direction of travel at the start of the
+ route (from the lowest numbered waypoint) as a compass bearing
+ from 0 to 360 degrees.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--highway-<highway></option>=<replaceable>preference</replaceable></term>
+ <listitem>
+ <para>
+ Selects the percentage preference for using each particular type
+ of highway.
+ The value of <replaceable>highway</replaceable> can be selected
+ from:
+ <informaltable frame='none' colsep='0' rowsep='0'>
+ <tgroup cols='3'>
+ <tbody>
+ <row>
+ <entry>motorway</entry>
+ <entry>=</entry>
+ <entry>Motorway</entry>
+ </row>
+ <row>
+ <entry>trunk</entry>
+ <entry>=</entry>
+ <entry>Trunk</entry>
+ </row>
+ <row>
+ <entry>primary</entry>
+ <entry>=</entry>
+ <entry>Primary</entry>
+ </row>
+ <row>
+ <entry>secondary</entry>
+ <entry>=</entry>
+ <entry>Secondary</entry>
+ </row>
+ <row>
+ <entry>tertiary</entry>
+ <entry>=</entry>
+ <entry>Tertiary</entry>
+ </row>
+ <row>
+ <entry>unclassified</entry>
+ <entry>=</entry>
+ <entry>Unclassified</entry>
+ </row>
+ <row>
+ <entry>residential</entry>
+ <entry>=</entry>
+ <entry>Residential</entry>
+ </row>
+ <row>
+ <entry>service</entry>
+ <entry>=</entry>
+ <entry>Service</entry>
+ </row>
+ <row>
+ <entry>track</entry>
+ <entry>=</entry>
+ <entry>Track</entry>
+ </row>
+ <row>
+ <entry>cycleway</entry>
+ <entry>=</entry>
+ <entry>Cycleway</entry>
+ </row>
+ <row>
+ <entry>path</entry>
+ <entry>=</entry>
+ <entry>Path</entry>
+ </row>
+ <row>
+ <entry>steps</entry>
+ <entry>=</entry>
+ <entry>Steps</entry>
+ </row>
+ <row>
+ <entry>ferry</entry>
+ <entry>=</entry>
+ <entry>Ferry</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--speed-<highway></option>=<replaceable>speed</replaceable></term>
+ <listitem>
+ <para>
+ Selects the speed limit in km/hour for each type of highway.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--property-<property></option>=<replaceable>preference</replaceable></term>
+ <listitem>
+ <para>
+ Selects the percentage preference for using each particular
+ highway property.
+ The value of <replaceable>property</replaceable> can be selected
+ from:
+ <informaltable frame='none' colsep='0' rowsep='0'>
+ <tgroup cols='3'>
+ <tbody>
+ <row>
+ <entry>paved</entry>
+ <entry>=</entry>
+ <entry>Paved (suitable for normal wheels)</entry>
+ </row>
+ <row>
+ <entry>multilane</entry>
+ <entry>=</entry>
+ <entry>Multiple lanes</entry>
+ </row>
+ <row>
+ <entry>bridge</entry>
+ <entry>=</entry>
+ <entry>Bridge</entry>
+ </row>
+ <row>
+ <entry>tunnel</entry>
+ <entry>=</entry>
+ <entry>Tunnel</entry>
+ </row>
+ <row>
+ <entry>footroute</entry>
+ <entry>=</entry>
+ <entry>A route marked for foot travel</entry>
+ </row>
+ <row>
+ <entry>bicycleroute</entry>
+ <entry>=</entry>
+ <entry>A route marked for bicycle travel</entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ <para>
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--oneway=</option>=<replaceable>0|1</replaceable></term>
+ <listitem>
+ <para>
+ Selects if the direction of oneway streets are to be obeyed
+ (useful to not obey them when walking).
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--turns=</option>=<replaceable>0|1</replaceable></term>
+ <listitem>
+ <para>
+ Selects if turn restrictions are to be obeyed (useful to not obey
+ them when walking).
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--weight</option>=<replaceable>weight</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the weight of the mode of transport in tonnes; ensures
+ that the weight limit on the highway is not exceeded.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--height</option>=<replaceable>height</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the height of the mode of transport in metres; ensures
+ that the height limit on the highway is not exceeded.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--width</option>=<replaceable>width</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the width of the mode of transport in metres; ensures
+ that the width limit on the highway is not exceeded.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--length</option>=<replaceable>length</replaceable></term>
+ <listitem>
+ <para>
+ Specifies the length of the mode of transport in metres; ensures
+ that the length limit on the highway is not exceeded.
+ Default value depends on the profile selected by the
+ <option>--transport</option> option.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ The meaning of the <replaceable>preference</replaceable> parameter in
+ the command line options is slightly different for the highway
+ preferences and the property preferences.
+ For the highway preference consider the choice between two possible
+ highways between the start and finish when looking for the shortest
+ route.
+ If highway A has a preference of 100% and highway B has a preference of
+ 90% then highway A will be chosen even if it is up to 11% longer
+ (100/90 = 111%).
+ For the highway properties each highway either has a particular property
+ or not.
+ If the preference for the property is 60% then a highway with the
+ property has a preference of 77% (sqrt(60%)) and one without has a
+ preference of 63% (sqrt(100-60%)).
+ A highway with the property will be chosen even if it is up to 22%
+ longer than one without the property (77/63 = 122%).
+ The overall preference for each highway segment is the product of the
+ preference for the highway type and all of the preferences for the
+ highway properties.
+ </para>
+
+ </refsect1>
+
+ <refsect1 id='examples'>
+ <title>EXAMPLES</title>
+
+ <example>
+ <para>
+ Example usage (motorcycle journey, scenic route, not very fast):
+ </para>
+ <screen>
+<command>routino-router</command> <option>--dir</option>=<filename>data</filename> <option>--prefix</option>=gb <option>--transport</option>=motorcycle \
+ <option>--highway-motorway</option>=0 <option>--highway-trunk</option>=0 \
+ <option>--speed-primary</option>=80 <option>--speed-secondary</option>=80 \
+ <option>--quickest</option>
+ </screen>
+ <para>
+ This will use the files
+ <filename>data/gb-nodes.mem</filename>,
+ <filename>data/gb-segments.mem</filename> and
+ <filename>data/gb-ways.mem</filename> to find the quickest route by
+ motorcycle not using motorways or trunk roads and not exceeding 80
+ km/hr.
+ </para>
+ </example>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/routino.manpages b/debian/routino.manpages
new file mode 100644
index 0000000..13cdaf4
--- /dev/null
+++ b/debian/routino.manpages
@@ -0,0 +1 @@
+debian/man/*.1
diff --git a/debian/rules b/debian/rules
index 645364a..c4d9397 100755
--- a/debian/rules
+++ b/debian/rules
@@ -9,9 +9,23 @@
# Uncomment this to turn on verbose mode.
#export DH_VERBOSE=1
+MANPAGES:=$(wildcard debian/man/*.*.xml)
+
%:
dh $@
+override_dh_clean:
+ dh_clean debian/man/*.1
+
+override_dh_auto_build-arch:
+ # Create man pages from DocBook XML
+ for x in $(MANPAGES) ; do \
+ docbook2x-man $$x ; \
+ mv `basename $$x | sed 's/.xml$$//'` `dirname $$x` ; \
+ done
+
+ dh_auto_build
+
override_dh_auto_install:
dh_auto_install
install -d $(CURDIR)/debian/tmp/usr/share/routino/www
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/routino.git
More information about the Pkg-grass-devel
mailing list