[SCM] osgearth branch, master, updated. debian/1.4.1-1-71-gecb0256

Bas Couwenberg sebastic at xs4all.nl
Wed Sep 18 11:46:05 UTC 2013


The following commit has been merged in the master branch:
commit 165e2f9467e0db6ff79914eba17246ebe8d46310
Author: Bas Couwenberg <sebastic at 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 <sebastic at 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



More information about the Pkg-grass-devel mailing list