This is an automated email from the git hooks/post-receive script. sebastic pushed a commit to branch master in repository qlandkartegt.
commit e4c6ddfa9c0c0cbad87720c885a53312c79bf81a Author: Bas Couwenberg <sebas...@xs4all.nl> Date: Fri Feb 13 03:59:12 2015 +0100 Add man pages for helper utilities. --- debian/changelog | 1 + debian/control | 6 +- debian/man/cache2gtiff.1.xml | 96 ++++++++++++++++++++++ debian/man/map2gcm.1.xml | 115 ++++++++++++++++++++++++++ debian/man/map2jnx.1.xml | 188 +++++++++++++++++++++++++++++++++++++++++++ debian/man/map2rmap.1.xml | 84 +++++++++++++++++++ debian/man/map2rmp.1.xml | 129 +++++++++++++++++++++++++++++ debian/manpages | 1 + debian/rules | 14 ++++ 9 files changed, 633 insertions(+), 1 deletion(-) diff --git a/debian/changelog b/debian/changelog index 9c25bbd..3f825b4 100644 --- a/debian/changelog +++ b/debian/changelog @@ -15,6 +15,7 @@ qlandkartegt (1.8.0+ds-1) UNRELEASED; urgency=medium * Enable parallel builds. * Drop 04-fix_kfreebsd_build.patch, obsolete. * Add patch to add %F field code to Exec key in desktop file. + * Add man pages for helper utilities. -- Bas Couwenberg <sebas...@debian.org> Thu, 12 Feb 2015 22:24:18 +0100 diff --git a/debian/control b/debian/control index e0c3611..17ce893 100644 --- a/debian/control +++ b/debian/control @@ -16,7 +16,11 @@ Build-Depends: cmake, libproj-dev, libqt4-dev, libqt4-opengl-dev, - libqtwebkit-dev + libqtwebkit-dev, + docbook2x, + docbook-xsl, + docbook-xml, + xsltproc Standards-Version: 3.9.5 Vcs-Browser: http://anonscm.debian.org/cgit/pkg-grass/qlandkartegt.git Vcs-Git: git://anonscm.debian.org/pkg-grass/qlandkartegt.git diff --git a/debian/man/cache2gtiff.1.xml b/debian/man/cache2gtiff.1.xml new file mode 100644 index 0000000..f4ba83f --- /dev/null +++ b/debian/man/cache2gtiff.1.xml @@ -0,0 +1,96 @@ +<?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='cache2gtiff'> + + <refmeta> + <refentrytitle>cache2gtiff</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>cache2gtiff</refname> + <refpurpose>create geotiff from tile cache</refpurpose> + </refnamediv> + + <refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command>cache2gtiff</command> + <arg choice='plain'><option>-a</option> <replaceable>level</replaceable> <replaceable>lon1</replaceable> <replaceable>lat1</replaceable> <replaceable>lon2</replaceable> <replaceable>lat2</replaceable></arg> + <arg choice='plain'><option>-c</option> <replaceable>path</replaceable></arg> + <arg choice='plain'><option>-i</option> <replaceable>file|url</replaceable></arg> + <arg choice='plain'><option>-o</option> <replaceable>file</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + <command>cache2gtiff</command> is a helper utility for + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + to convert an area from the tile cache to geotiff. + </para> + </refsect1> + + <refsect1 id='options'> + <title>OPTIONS</title> + + <variablelist> + + <varlistentry> + <term><option>-a</option> <replaceable>level</replaceable> <replaceable>lon1</replaceable> <replaceable>lat1</replaceable> <replaceable>lon2</replaceable> <replaceable>lat2</replaceable></term> + <listitem> + <para> + The level and the area to export. + The level is an integer from 1..19. + All lon/lat values are in degree. + lon1, lat1 is the top left corner of the area. + lon2, lat2 is the bottom right corner of the area. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-c</option> <replaceable>path</replaceable></term> + <listitem> + <para> + The path to the tile cache. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-i</option> <replaceable>file|url</replaceable></term> + <listitem> + <para> + The xml definition or an url of the server. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-o</option> <replaceable>file</replaceable></term> + <listitem> + <para> + The target geotiff filename. + </para> + </listitem> + </varlistentry> + + </variablelist> + + </refsect1> + + <refsect1 id='see-also'> + <title>SEE ALSO</title> + + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + + </refsect1> + +</refentry> diff --git a/debian/man/map2gcm.1.xml b/debian/man/map2gcm.1.xml new file mode 100644 index 0000000..a49c47d --- /dev/null +++ b/debian/man/map2gcm.1.xml @@ -0,0 +1,115 @@ +<?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='map2gcm'> + + <refmeta> + <refentrytitle>map2gcm</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>map2gcm</refname> + <refpurpose>convert map to KMZ</refpurpose> + </refnamediv> + + <refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command>map2gcm</command> + <arg choice='plain'><option>-q</option> <replaceable>1..100</replaceable></arg> + <arg choice='plain'><option>-s</option> <replaceable>411|422|444</replaceable></arg> + <arg choice='plain'><option>-t</option> <replaceable>file</replaceable> <replaceable>file1</replaceable> <replaceable>file2</replaceable> ... <replaceable>fileN</replaceable></arg> + <arg choice='plain'><replaceable>outputfile</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + <command>map2gcm</command> is a helper utility for + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + to convert a map to KMZ format. + </para> + <para> + The list of selected tiles is a string in a file. + The index count startswith 0 at the top left corner and is incremented + for each element in a row. + A 2x2 tile selection will have the index string '0 1 2 3'. + </para> + <para> + The projection of the input files must have the same latitude along a + pixel row. + Mecator and Longitude/Latitude projections match this property. + Transversal Merkator or Lambert projections do not. + </para> + <para> + To rectify a geotiff map, you can use the + <citerefentry> + <refentrytitle>gdalwarp</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + command, e.g. + <screen> +<command>gdalwarp</command> <option>-t_srs</option> <replaceable>"EPSG:4326"</replaceable> <replaceable>inputfile</replaceable> <replaceable>outputfile</replaceable> + </screen> + </para> + </refsect1> + + <refsect1 id='options'> + <title>OPTIONS</title> + + <variablelist> + + <varlistentry> + <term><option>-q</option> <replaceable>1..100</replaceable></term> + <listitem> + <para> + The JPEG quality from 1 to 100. Default is 75 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-s</option> <replaceable>411|422|444</replaceable></term> + <listitem> + <para> + The chroma subsampling. Default is 411 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-t</option> <replaceable>file</replaceable> <replaceable>file1</replaceable> <replaceable>file2</replaceable> ... <replaceable>lonN</replaceable></term> + <listitem> + <para> + File with list of selected tile index + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><replaceable>outputfile</replaceable></term> + <listitem> + <para> + Path to KMZ output file + </para> + </listitem> + </varlistentry> + + </variablelist> + + </refsect1> + + <refsect1 id='see-also'> + <title>SEE ALSO</title> + + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + + </refsect1> + +</refentry> diff --git a/debian/man/map2jnx.1.xml b/debian/man/map2jnx.1.xml new file mode 100644 index 0000000..d017a91 --- /dev/null +++ b/debian/man/map2jnx.1.xml @@ -0,0 +1,188 @@ +<?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='map2jnx'> + + <refmeta> + <refentrytitle>map2jnx</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>map2jnx</refname> + <refpurpose>convert map to JNX</refpurpose> + </refnamediv> + + <refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command>map2jnx</command> + <arg choice='plain'><option>-q</option> <replaceable>1..100</replaceable></arg> + <arg choice='plain'><option>-s</option> <replaceable>411|422|444</replaceable></arg> + <arg choice='plain'><option>-p</option> <replaceable>0..</replaceable></arg> + <arg choice='plain'><option>-c</option> <replaceable>"copyright notice"</replaceable></arg> + <arg choice='plain'><option>-m</option> <replaceable>"BirdsEye"</replaceable></arg> + <arg choice='plain'><option>-n</option> <replaceable>"Unknown"</replaceable></arg> + <arg choice='plain'><option>-x</option> <replaceable>file1_scale,file2_scale,...,fileN_scale</replaceable></arg> + <arg choice='plain'><replaceable>file1</replaceable> <replaceable>file2</replaceable> ... <replaceable>fileN</replaceable></arg> + <arg choice='plain'><replaceable>outputfile</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + <command>map2jnx</command> is a helper utility for + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + to convert a map to JNX format. + </para> + <para> + The projection of the input files must have the same latitude along a + pixel row. + Mecator and Longitude/Latitude projections match this this property. + Transversal Merkator or Lambert projections do not. + </para> + <para> + To rectify a geotiff map, you can use the + <citerefentry> + <refentrytitle>gdalwarp</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + command, e.g. + <screen> +<command>gdalwarp</command> <option>-t_srs</option> <replaceable>"EPSG:4326"</replaceable> <replaceable>inputfile</replaceable> <replaceable>outputfile</replaceable> + </screen> + </para> + <para> + Scale levels must be pass in same order as level files pointed. + Empty and zero values equal to autodetect. + We can point only needed levels, like: + <screen> + <option>-x</option> <literal>45356,,,75;</literal> <option>-x</option> <literal>,,,,75</literal> + </screen> + </para> + <para> + Calculated levels table can be found: + <itemizedlist> + <listitem> + <para> + English: http://whiter.brinkster.net/en/JNX.shtml + </para> + </listitem> + <listitem> + <para> + Russian: http://whiter.brinkster.net/JNX.shtml + </para> + </listitem> + </itemizedlist> + </para> + <para> + Most common values for different map scales: +<programlisting> + JNX scale Map scale + ------------- --------- + 78125-31250 1:1 000 000 + 20834-7813 1:500 000 + 7813-3125 1:200 000 + 3125-2084 1:100 000 + 2084-782 1:50 000 + 782-32 1:25 000 + 32-21 1:10 000 + 21-14 1:5000, 1:2000 +</programlisting> + </para> + </refsect1> + + <refsect1 id='options'> + <title>OPTIONS</title> + + <variablelist> + + <varlistentry> + <term><option>-q</option> <replaceable>1..100</replaceable></term> + <listitem> + <para> + The JPEG quality from 1 to 100. Default is 75 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-s</option> <replaceable>411|422|444</replaceable></term> + <listitem> + <para> + The chroma subsampling. Default is 411 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-p</option> <replaceable>0..</replaceable></term> + <listitem> + <para> + The product ID. Default is 0 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-c</option> <replaceable>string</replaceable></term> + <listitem> + <para> + The copyright notice. Default is "Unknown" + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-m</option> <replaceable>string</replaceable></term> + <listitem> + <para> + The subscription product name. Default is "BirdsEye" + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-n</option> <replaceable>string</replaceable></term> + <listitem> + <para> + The map name. Default is "Unknown" + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-z</option> <replaceable>number</replaceable></term> + <listitem> + <para> + The z order (drawing order). Default is 25 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-x</option> <replaceable>file1_scale,file2_scale,...,fileN_scale</replaceable></term> + <listitem> + <para> + Override levels scale. Default: autodetect + </para> + </listitem> + </varlistentry> + + </variablelist> + + </refsect1> + + <refsect1 id='see-also'> + <title>SEE ALSO</title> + + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + + </refsect1> + +</refentry> diff --git a/debian/man/map2rmap.1.xml b/debian/man/map2rmap.1.xml new file mode 100644 index 0000000..806516d --- /dev/null +++ b/debian/man/map2rmap.1.xml @@ -0,0 +1,84 @@ +<?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='map2rmap'> + + <refmeta> + <refentrytitle>map2rmap</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>map2rmap</refname> + <refpurpose>convert map to RMAP</refpurpose> + </refnamediv> + + <refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command>map2rmap</command> + <arg choice='plain'><option>-q</option> <replaceable>1..100</replaceable></arg> + <arg choice='plain'><option>-s</option> <replaceable>411|422|444</replaceable></arg> + <arg choice='plain'><option>-epsg</option> <replaceable>number</replaceable></arg> + <arg choice='plain'><replaceable>file1</replaceable> <replaceable>file2</replaceable> ... <replaceable>fileN</replaceable></arg> + <arg choice='plain'><replaceable>outputfile</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + <command>map2rmap</command> is a helper utility for + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + to convert a map to RMAP format. + </para> + </refsect1> + + <refsect1 id='options'> + <title>OPTIONS</title> + + <variablelist> + + <varlistentry> + <term><option>-q</option> <replaceable>1..100</replaceable></term> + <listitem> + <para> + The JPEG quality from 1 to 100. Default is 75 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-s</option> <replaceable>411|422|444</replaceable></term> + <listitem> + <para> + The chroma subsampling. Default is 411 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-epsg</option> <replaceable>number</replaceable></term> + <listitem> + <para> + Enforce given projection for input files + </para> + </listitem> + </varlistentry> + + </variablelist> + + </refsect1> + + <refsect1 id='see-also'> + <title>SEE ALSO</title> + + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + + </refsect1> + +</refentry> diff --git a/debian/man/map2rmp.1.xml b/debian/man/map2rmp.1.xml new file mode 100644 index 0000000..ab47247 --- /dev/null +++ b/debian/man/map2rmp.1.xml @@ -0,0 +1,129 @@ +<?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='map2rmp'> + + <refmeta> + <refentrytitle>map2rmp</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>map2rmp</refname> + <refpurpose>convert map to RMP</refpurpose> + </refnamediv> + + <refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command>map2rmp</command> + <arg choice='plain'><option>-p</option> <replaceable>string</replaceable></arg> + <arg choice='plain'><option>-n</option> <replaceable>string</replaceable></arg> + <arg choice='plain'><option>-c</option> <replaceable>string</replaceable></arg> + <arg choice='plain'><option>-q</option> <replaceable>1..100</replaceable></arg> + <arg choice='plain'><option>-s</option> <replaceable>411|422|444</replaceable></arg> + <arg choice='plain'><option>-i</option></arg> + <arg choice='plain'><replaceable>file1</replaceable> <replaceable>file2</replaceable> ... <replaceable>fileN</replaceable></arg> + <arg choice='plain'><replaceable>outputfile</replaceable></arg> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + <command>map2rmp</command> is a helper utility for + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + to convert a map to RMP format. + </para> + <para> + NOTE: The projection of all input files must be EPSG4326. + You can use GDAL to convert your files. + Use '<command>gdalinfo</command> <replaceable>file</replaceable>' + to find out the size in pixel of your file. + Use + <citerefentry> + <refentrytitle>gdalwarp</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + to reproject your file: + <screen> +<command>gdalwarp</command> <option>-t_srs</option> <replaceable>"+init=epsg:4326"</replaceable> <option>-ts</option> <replaceable>width-in-pixel</replaceable> <replaceable>height-in-pixel</replaceable> <replaceable>file</replaceable> <replaceable>outputfile</replaceable> + </screen> + </para> + </refsect1> + + <refsect1 id='options'> + <title>OPTIONS</title> + + <variablelist> + + <varlistentry> + <term><option>-p</option> <replaceable>string</replaceable></term> + <listitem> + <para> + The map provider as string (mandatory) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-n</option> <replaceable>string</replaceable></term> + <listitem> + <para> + The map name as string (mandatory) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-c</option> <replaceable>string</replaceable></term> + <listitem> + <para> + The copyright notice (optional) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-q</option> <replaceable>1..100</replaceable></term> + <listitem> + <para> + The JPEG quality from 1 to 100. Default is 75 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-s</option> <replaceable>411|422|444</replaceable></term> + <listitem> + <para> + The chroma subsampling. Default is 411 + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>-i</option></term> + <listitem> + <para> + Add intermediate levels (optional) + </para> + </listitem> + </varlistentry> + + </variablelist> + + </refsect1> + + <refsect1 id='see-also'> + <title>SEE ALSO</title> + + <citerefentry> + <refentrytitle>qlandkartegt</refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry> + + </refsect1> + +</refentry> diff --git a/debian/manpages b/debian/manpages index 04ab73d..694a1d5 100644 --- a/debian/manpages +++ b/debian/manpages @@ -1 +1,2 @@ qlandkartegt.1 +debian/man/*.1 diff --git a/debian/rules b/debian/rules index 1168058..8ce3bf9 100755 --- a/debian/rules +++ b/debian/rules @@ -1,12 +1,26 @@ #!/usr/bin/make -f +MANPAGES := $(wildcard debian/man/*.*.xml) + # one ring to rule them all ... %: dh $@ --parallel +overrid_dh_clean: + dh_clean debian/man/*.1 + override_dh_auto_configure: dh_auto_configure -- -DGPX_EXTENSIONS:BOOL=TRUE +override_dh_auto_build: + # Create man page 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: # first do the regular job dh_auto_install -- Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/qlandkartegt.git _______________________________________________ Pkg-grass-devel mailing list Pkg-grass-devel@lists.alioth.debian.org http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-grass-devel