[osm2pgrouting] 01/01: Add manpage for osm2pgrouting.
Sebastiaan Couwenberg
sebastic at moszumanska.debian.org
Sun May 8 19:04:31 UTC 2016
This is an automated email from the git hooks/post-receive script.
sebastic pushed a commit to branch master
in repository osm2pgrouting.
commit 4f67310a4cfee144464fae8949d470e60a2e9e29
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date: Sun May 8 20:53:19 2016 +0200
Add manpage for osm2pgrouting.
---
debian/changelog | 6 ++
debian/control | 6 +-
debian/man/osm2pgrouting.1.xml | 199 +++++++++++++++++++++++++++++++++++++++++
debian/manpages | 1 +
debian/rules | 16 ++++
5 files changed, 227 insertions(+), 1 deletion(-)
diff --git a/debian/changelog b/debian/changelog
index 73d68f9..f08e300 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -1,3 +1,9 @@
+osm2pgrouting (2.1.0-2) UNRELEASED; urgency=medium
+
+ * Add manpage for osm2pgrouting.
+
+ -- Bas Couwenberg <sebastic at debian.org> Sun, 08 May 2016 20:53:02 +0200
+
osm2pgrouting (2.1.0-1) unstable; urgency=medium
* New upstream release.
diff --git a/debian/control b/debian/control
index 2d18a92..9d707b1 100644
--- a/debian/control
+++ b/debian/control
@@ -9,7 +9,11 @@ Build-Depends: debhelper (>= 9),
libboost-graph-dev,
libboost-program-options-dev,
libexpat1-dev,
- libpq-dev
+ libpq-dev,
+ docbook2x,
+ docbook-xsl,
+ docbook-xml,
+ xsltproc
Standards-Version: 3.9.8
Vcs-Browser: https://anonscm.debian.org/cgit/pkg-grass/osm2pgrouting.git
Vcs-Git: https://anonscm.debian.org/git/pkg-grass/osm2pgrouting.git
diff --git a/debian/man/osm2pgrouting.1.xml b/debian/man/osm2pgrouting.1.xml
new file mode 100644
index 0000000..5c02666
--- /dev/null
+++ b/debian/man/osm2pgrouting.1.xml
@@ -0,0 +1,199 @@
+<?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='osm2pgrouting'>
+
+ <refmeta>
+ <refentrytitle>osm2pgrouting</refentrytitle>
+ <manvolnum>1</manvolnum>
+ </refmeta>
+
+ <refnamediv>
+ <refname>osm2pgrouting</refname>
+ <refpurpose>import OpenStreetMap data into a pgRouting database</refpurpose>
+ </refnamediv>
+
+ <refsynopsisdiv id='synopsis'>
+ <cmdsynopsis>
+ <command>osm2pgrouting</command>
+ <arg choice='plain'><option>-f</option> <replaceable>file</replaceable></arg>
+ <arg choice='opt'><replaceable>OPTIONS</replaceable></arg>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+ <refsect1 id='description'>
+ <title>DESCRIPTION</title>
+ <para>
+ <command>osm2pgrouting</command> is a command line tool that makes it
+ easy to import OpenStreetMap data into a pgRouting database.
+ It builds the routing network topology automatically and creates tables
+ for feature types and road classes.
+ </para>
+ </refsect1>
+
+ <refsect1 id='options'>
+ <title>OPTIONS</title>
+
+ <para>
+ Help:
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>--help</option></term>
+ <listitem>
+ <para>
+ Produce help message for this version
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-v</option></term>
+ <term><option>--version</option></term>
+ <listitem>
+ <para>
+ Print version string
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ General:
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-f</option> <replaceable>file</replaceable></term>
+ <term><option>--file</option> <replaceable>file</replaceable></term>
+ <listitem>
+ <para>
+ Name of the OSM file (Required).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-c</option> <replaceable>file</replaceable></term>
+ <term><option>--conf</option> <replaceable>file</replaceable></term>
+ <listitem>
+ <para>
+ Name of the configuration XML file.
+ (default: /usr/share/osm2pgrouting/mapconfig.xml)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--schema</option> <replaceable>schema</replaceable></term>
+ <listitem>
+ <para>
+ Database schema to put tables.
+ blank:
+ defaults to default schema dictated by PostgreSQL search_path.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--prefix</option> <replaceable>prefix</replaceable></term>
+ <listitem>
+ <para>
+ Prefix added at the beginning of the table names.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--suffix</option> <replaceable>suffix</replaceable></term>
+ <listitem>
+ <para>
+ Suffix added at the end of the table names.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--addnodes</option></term>
+ <listitem>
+ <para>
+ Import the osm_nodes table.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>--clean</option></term>
+ <listitem>
+ <para>
+ Drop previously created tables.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ <para>
+ Database options:
+ </para>
+ <variablelist>
+
+ <varlistentry>
+ <term><option>-d</option> <replaceable>name</replaceable></term>
+ <term><option>--dbname</option> <replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Name of your database (Required).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-U</option> <replaceable>name</replaceable></term>
+ <term><option>--username</option> <replaceable>name</replaceable></term>
+ <listitem>
+ <para>
+ Name of the user, which have write access to the database.
+ (default: postgres)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-h</option> <replaceable>host</replaceable></term>
+ <term><option>--host</option> <replaceable>host</replaceable></term>
+ <listitem>
+ <para>
+ Host of your PostgreSQL database.
+ (default: localhost)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-p</option> <replaceable>port</replaceable></term>
+ <term><option>--port</option> <replaceable>port</replaceable></term>
+ <listitem>
+ <para>
+ Port of your database.
+ (default: 5432)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-W</option> <replaceable>password</replaceable></term>
+ <term><option>--password</option> <replaceable>password</replaceable></term>
+ <listitem>
+ <para>
+ Password for database access.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ </variablelist>
+
+ </refsect1>
+
+</refentry>
diff --git a/debian/manpages b/debian/manpages
new file mode 100644
index 0000000..13cdaf4
--- /dev/null
+++ b/debian/manpages
@@ -0,0 +1 @@
+debian/man/*.1
diff --git a/debian/rules b/debian/rules
index b307d6c..4622329 100755
--- a/debian/rules
+++ b/debian/rules
@@ -7,9 +7,25 @@
# Enable hardening build flags
export DEB_BUILD_MAINT_OPTIONS=hardening=+all
+BUILD_DATE=$(shell dpkg-parsechangelog | sed -ne 's/^Date: //p' | LC_ALL=C date -u "+%d %B %Y" -f -)
+
+MANPAGES := $(wildcard debian/man/*.*.xml)
+
%:
dh $@ --parallel
+override_dh_clean:
+ dh_clean debian/man/*.1
+
+override_dh_auto_build:
+ # Create man page from DocBook XML
+ for x in $(MANPAGES) ; do \
+ docbook2x-man --string-param header-3="$(BUILD_DATE)" $$x ; \
+ mv `basename $$x | sed 's/.xml$$//'` `dirname $$x` ; \
+ done
+
+ dh_auto_build
+
override_dh_auto_install:
dh_auto_install
--
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/osm2pgrouting.git
More information about the Pkg-grass-devel
mailing list