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

[Bas Couwenberg]

The following commit has been merged in the master branch:
commit 7526aebb312782e138f689f15c96bfd63d3dba71
Author: Bas Couwenberg <sebastic at xs4all.nl>
Date:   Mon Sep 16 02:50:13 2013 +0200

    Add man page for: osgearth_tfs.

diff --git a/debian/changelog b/debian/changelog
index 23b555d..d34f5ef 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -26,6 +26,7 @@ osgearth (2.4.0+dfsg-4) UNRELEASED; urgency=low
     - osgearth_version
     - osgearth_cache
     - osgearth_package
+    - osgearth_tfs
 
  -- Bas Couwenberg <sebastic at xs4all.nl>  Fri, 13 Sep 2013 15:14:27 +0200
 
diff --git a/debian/man/osgearth_tfs.1.xml b/debian/man/osgearth_tfs.1.xml
new file mode 100644
index 0000000..4cb6c3b
--- /dev/null
+++ b/debian/man/osgearth_tfs.1.xml
@@ -0,0 +1,140 @@
+<?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_tfs'>
+
+  <refmeta>
+    <refentrytitle>osgearth_tfs</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>osgearth_tfs</refname>
+    <refpurpose>generate a TFS dataset from a feature source</refpurpose>
+  </refnamediv>
+
+  <refsynopsisdiv id='synopsis'>
+    <cmdsynopsis>
+      <command>osgearth_tfs</command>
+      <arg choice='plain'><replaceable>filename</replaceable></arg>
+      <group>
+        <arg choice='opt'><option>--first-level</option> <replaceable>level</replaceable></arg>
+        <arg choice='opt'><option>--max-level</option> <replaceable>level</replaceable></arg>
+        <arg choice='opt'><option>--max-features</option> <replaceable>number</replaceable></arg>
+        <arg choice='opt'><option>--out</option> <replaceable>path</replaceable></arg>
+        <arg choice='opt'><option>--layer</option> <replaceable>layer</replaceable></arg>
+        <arg choice='opt'><option>--description</option> <replaceable>description</replaceable></arg>
+        <arg choice='opt'><option>--expression</option> <replaceable>expression</replaceable></arg>
+        <arg choice='opt'><option>--order-by</option> <replaceable>order</replaceable></arg>
+        <arg choice='opt'><option>--crop</option></arg>
+        <arg choice='opt'><option>--dest-srs</option> <replaceable>SRS</replaceable></arg>
+      </group>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1 id='description'>
+    <title>DESCRIPTION</title>
+    <para>
+      <command>osgearth_tfs</command> generates a TFS dataset from a feature
+      source such as a shapefile. By pre-processing your features into the
+      gridded structure provided by TFS you can significantly increase
+      performance of large datasets. In addition, the TFS package generated
+      can be served by any standard web server, web enabling your dataset.
+    </para>
+  </refsect1>
+
+  <refsect1 id='options'>
+    <title>OPTIONS</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><replaceable>filename</replaceable></term>
+        <listitem>
+          <para>Shapefile (or other feature source data file)</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--first-level</option> <replaceable>level</replaceable></term>
+        <listitem>
+          <para>The first level where features will be added to the quadtree</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--max-level</option> <replaceable>level</replaceable></term>
+        <listitem>
+          <para>The maximum level of the feature quadtree</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--max-features</option> <replaceable>number</replaceable></term>
+        <listitem>
+          <para>The maximum number of features per tile</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--out</option> <replaceable>path</replaceable></term>
+        <listitem>
+          <para>The destination directory</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--layer</option> <replaceable>layer</replaceable></term>
+        <listitem>
+          <para>The name of the layer to be written to the metadata document</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--description</option> <replaceable>description</replaceable></term>
+        <listitem>
+          <para>The abstract/description of the layer to be written to the metadata document</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--expression</option> <replaceable>expression</replaceable></term>
+        <listitem>
+          <para>The expression to run on the feature source, specific to the feature source</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--order-by</option> <replaceable>order</replaceable></term>
+        <listitem>
+          <para>
+            Sort the features, if not already included in the expression.
+            Append DESC for descending order!
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--crop</option></term>
+        <listitem>
+          <para>
+            Crops features instead of doing a centroid check. Features can be
+            added to multiple tiles when cropping is enabled.
+          </para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>--dest-srs</option> <replaceable>SRS</replaceable></term>
+        <listitem>
+          <para>
+            The destination SRS string in any format osgEarth can understand
+            (wkt, proj4, epsg). If none is specific the source data SRS will
+            be used.
+          </para>
+        </listitem>
+      </varlistentry>
+
+    </variablelist>
+
+  </refsect1>
+
+</refentry>
diff --git a/debian/osgearth.manpages b/debian/osgearth.manpages
index ca7d18c..2ae5338 100644
--- a/debian/osgearth.manpages
+++ b/debian/osgearth.manpages
@@ -2,3 +2,4 @@ debian/man/osgearth_viewer.1
 debian/man/osgearth_version.1
 debian/man/osgearth_cache.1
 debian/man/osgearth_package.1
+debian/man/osgearth_tfs.1

-- 
osgEarth terrain rendering toolkit