The following commit has been merged in the master branch: commit 165e2f9467e0db6ff79914eba17246ebe8d46310 Author: Bas Couwenberg <sebas...@xs4all.nl> Date: Mon Sep 16 01:30:51 2013 +0200
Add man page for: osgearth_viewer. diff --git a/debian/changelog b/debian/changelog index 0aa2556..0d595d7 100644 --- a/debian/changelog +++ b/debian/changelog @@ -21,6 +21,8 @@ osgearth (2.4.0+dfsg-4) UNRELEASED; urgency=low * Update copyright using DEP5 format. * Bump Standards-Version to 3.9.4; changes to copyright, shared libraries, Vcs-* fields. + * Add man page for osgEarth tools: + - osgearth_viewer -- Bas Couwenberg <sebas...@xs4all.nl> Fri, 13 Sep 2013 15:14:27 +0200 diff --git a/debian/control b/debian/control index 64429d4..bc02233 100644 --- a/debian/control +++ b/debian/control @@ -7,7 +7,8 @@ Build-Depends: debhelper (>= 9), dpkg-dev (>= 1.16.1.1), cmake (>= 2.6.2), libopenscenegraph-dev (>= 2.8.0), openscenegraph (>= 2.8.0), libgdal-dev, libgeos-dev, libexpat1-dev (>= 2.0.1), libcurl4-gnutls-dev, libzip-dev, libsqlite3-dev, - libqt4-dev, libqt4-opengl-dev, pkg-kde-tools + libqt4-dev, libqt4-opengl-dev, pkg-kde-tools, + docbook2x, docbook-xsl, docbook-xml, xsltproc Standards-Version: 3.9.4 Homepage: http://osgearth.org/ Vcs-Git: git://anonscm.debian.org/pkg-grass/osgearth.git diff --git a/debian/man/osgearth_viewer.1.xml b/debian/man/osgearth_viewer.1.xml new file mode 100644 index 0000000..5ba1397 --- /dev/null +++ b/debian/man/osgearth_viewer.1.xml @@ -0,0 +1,144 @@ +<?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='osgearth_viewer'> + + <refmeta> + <refentrytitle>osgearth_viewer</refentrytitle> + <manvolnum>1</manvolnum> + </refmeta> + + <refnamediv> + <refname>osgearth_viewer</refname> + <refpurpose>load and display a map</refpurpose> + </refnamediv> + + <refsynopsisdiv id='synopsis'> + <cmdsynopsis> + <command>osgearth_viewer</command> + <arg choice='plain'><replaceable>earthfile.earth</replaceable></arg> + <group> + <arg choice='opt'><option>--sky</option></arg> + <arg choice='opt'><option>--ocean</option></arg> + <arg choice='opt'><option>--kml</option> <replaceable>file.kml</replaceable></arg> + <arg choice='opt'><option>--coords</option></arg> + <arg choice='opt'><option>--dms</option></arg> + <arg choice='opt'><option>--dd</option> <replaceable></replaceable></arg> + <arg choice='opt'><option>--mgrs</option> <replaceable></replaceable></arg> + <arg choice='opt'><option>--ortho</option> <replaceable></replaceable></arg> + <arg choice='opt'><option>--autoclip</option> <replaceable></replaceable></arg> + <arg choice='opt'><option>--images</option> <replaceable>path</replaceable></arg> + <arg choice='opt'><option>--image-extensions</option> <replaceable>*</replaceable></arg> + <arg choice='opt'><option>--out-earth</option> <replaceable>out.earth</replaceable></arg> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <refsect1 id='description'> + <title>DESCRIPTION</title> + <para> + <command>osgearth_viewer</command> can load and display a map from the + command line. The osgEarth EarthManipulator is used to control the camera + and is optimized for viewing geospatial data. + </para> + </refsect1> + + <refsect1 id='options'> + <title>OPTIONS</title> + <variablelist> + + <varlistentry> + <term><replaceable>earthfile.earth</replaceable></term> + <listitem> + <para>Path to the earth file</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--sky</option></term> + <listitem> + <para>Installs a SkyNode (sun, moon, stars and atmosphere..globe only)</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--ocean</option></term> + <listitem> + <para>Installs a sample ocean surface node</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--kml</option> <replaceable>file.kml</replaceable></term> + <listitem> + <para>Loads a KML or KMZ file</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--coords</option></term> + <listitem> + <para>Displays map coords under mouse</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--dms</option></term> + <listitem> + <para>Displays map coords as degrees/mins/seconds</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--dd</option></term> + <listitem> + <para>Displays map coords as decimal degrees</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--mgrs</option></term> + <listitem> + <para>Displays map coords as MGRS</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--ortho</option></term> + <listitem> + <para>Installs an orthographic camera projection</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--autoclip</option></term> + <listitem> + <para>Installs an automatic clip plane handler</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--images</option> <replaceable>path</replaceable></term> + <listitem> + <para>Finds images in [path] and loads them as image layers</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--image-extensions</option> <replaceable>*</replaceable></term> + <listitem> + <para>With <option>--images</option>, only considers the listed extensions</para> + </listitem> + </varlistentry> + + <varlistentry> + <term><option>--out-earth</option> <replaceable>out.earth</replaceable></term> + <listitem> + <para>With <option>--images</option>, writes out an earth file</para> + </listitem> + </varlistentry> + + </variablelist> + + </refsect1> + +</refentry> diff --git a/debian/osgearth.manpages b/debian/osgearth.manpages new file mode 100644 index 0000000..ee4939d --- /dev/null +++ b/debian/osgearth.manpages @@ -0,0 +1 @@ +debian/man/osgearth_viewer.1 diff --git a/debian/rules b/debian/rules index f4413c1..26d7f52 100755 --- a/debian/rules +++ b/debian/rules @@ -15,6 +15,8 @@ CXXFLAGS += $(CPPFLAGS) PACKAGE := $(shell dpkg-parsechangelog | sed -n 's/^Source: //p') VERSION := $(shell dpkg-parsechangelog | sed -ne 's/^Version: \(.*\)-.*/\1/p' | sed -e 's/\+.*//') +MANPAGES:=$(wildcard debian/man/*.*.xml) + MAKE_VERBOSE=1 %: @@ -31,6 +33,7 @@ override_dh_clean: -$(RM) -rf $(CURDIR)/debian/files -$(RM) -f $(CURDIR)/debian/*.debhelper.log + -$(RM) -f $(CURDIR)/debian/man/*.1 override_dh_auto_configure: mkdir -p build && cd build && cmake .. -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr -DLIB_POSTFIX="" @@ -38,6 +41,12 @@ override_dh_auto_configure: override_dh_auto_build: dh_testdir + # Create man pages from DocBook XML + for x in $(MANPAGES) ; do \ + docbook2x-man $$x ; \ + mv `basename $$x | sed 's/.xml$$//'` `dirname $$x` ; \ + done + $(MAKE) -C build VERBOSE=$(MAKE_VERBOSE) override_dh_auto_install: -- osgEarth terrain rendering toolkit _______________________________________________ Pkg-grass-devel mailing list Pkg-grass-devel@lists.alioth.debian.org http://lists.alioth.debian.org/cgi-bin/mailman/listinfo/pkg-grass-devel