[saga] 01/02: Add updated manfiles

[Johan Van de Wauw]

This is an automated email from the git hooks/post-receive script.

johanvdw-guest pushed a commit to branch master
in repository saga.

commit 3e6620afd6028d8914f876caa7181b5f20ac7231
Author: Johan Van de Wauw <johan.vandewauw at gmail.com>
Date:   Fri Oct 31 16:45:40 2014 +0100

    Add updated manfiles
    
    This reverts commit bf553c528fdf0d39f50a67296cae03b13d628a77.
    
    Conflicts:
    	debian/rules
---
 debian/rules         |  7 ++++++
 debian/saga.manpages |  1 +
 debian/saga_cmd.pod  | 63 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 debian/saga_gui.pod  | 24 ++++++++++++++++++++
 4 files changed, 95 insertions(+)

diff --git a/debian/rules b/debian/rules
index ba1066e..d76bff1 100755
--- a/debian/rules
+++ b/debian/rules
@@ -16,12 +16,19 @@ UPSTREAM_VERSION ?=$(shell uscan --dehs | sed -n 's/.*<upstream-version>\(.*\)<\
 debian/% :: debian/%.in
 	sed -e 's/@VERSION@/$(VERSION)/' $< >$@
 
+override_dh_build:
+	dh_build
+	pod2man --section=1 --release=$(VERSION) --center " " debian/saga_cmd.pod >saga_cmd.1
+	pod2man --section=1 --release=$(VERSION) --center " " debian/saga_gui.pod >saga_gui.1
+
 override_dh_python2:
 	dh_python2 --no-guessing-versions
 
 override_dh_clean:
 	dh_clean
 	rm -f src/saga_core/saga_api/saga_api.py
+	rm -f saga_cmd.1
+	rm -f saga_gui.1
 
 override_dh_makeshlibs:
 	dh_makeshlibs -Xpython-saga
diff --git a/debian/saga.manpages b/debian/saga.manpages
new file mode 100644
index 0000000..4cf2b61
--- /dev/null
+++ b/debian/saga.manpages
@@ -0,0 +1 @@
+saga_gui.1
diff --git a/debian/saga_cmd.pod b/debian/saga_cmd.pod
new file mode 100644
index 0000000..80768d3
--- /dev/null
+++ b/debian/saga_cmd.pod
@@ -0,0 +1,63 @@
+=head1 NAME
+
+B<saga_cmd> - command-line interface to the System for Automated Geoscientific Analyses
+ 
+=head1 SYNOPSIS
+
+B<saga_cmd> [-d, --docs]
+[B<SAGA_MLB>=I<dirname>] B<saga_cmd> I<LIBRARY> [I<MODULE>] [B<-silent>] <module specific options...>
+
+B<saga_cmd> [B<-h, --help>]
+
+=head1 DESCRIPTION
+
+Command line interface to the System for Automated Geoscientific Analyses (SAGA). When run without arguments, the module libraries in the current module library are listed. This can be specified by setting the environment variable I<SAGA_MLB>. If this is not specified, the current working directory is used.
+
+SAGA GIS (System for Automated Geoscientific Analysis) is a free and open source geographic information system used for editing and analysing spatial data. It includes a large number of modules for the analysis of vector, table, grid and image data.
+
+=head1 OPTIONS
+
+=over 8
+
+=item [I<SAGA_MLB>=dirname]
+ 
+Module libraries are expected to be located in the directory that is specified by the environment variable 'SAGA_MLB'. If this is not found the current working directory will be searched for instead.
+
+To use the default modules, the environment variable can be set to I</usr/lib/saga>
+
+=item I<LIBRARY> [I<MODULE>] 
+
+Specify the library (ie ta_morphometry) and the module (number or name). If no module is specified the different modules of a library are listed.
+
+=item B<-h, --help>
+
+Display help and exit
+
+=item B<-d, --docs>
+
+Create tool documentation in the current working directory
+
+=back
+
+=head1 EXAMPLE
+
+export SAGA_MLB=/usr/lib/saga
+
+B<saga_cmd> ta_morphometry "Local Morphometry" -ELEVATION dem.sgrd -SLOPE slope.sgrd -ASPECT aspect.sgrd -METHOD 1
+
+Multiple input files can be specified by seperating them by a semicolon (;).
+
+B<saga_cmd> libgrid_tools Merging -GRIDS test1.sgrd\;test2.sgrd -GRID_TARGET merged.sgrd
+
+=head1 BUGS
+
+On the website of I<http://www.saga-gis.org>, a list of known bugs can be found and new bug reports can be submitted.
+
+=head1 AUTHORS
+
+B<SAGA> was written by Olaf Conrad with help from a large number of contributers. This manual page was written by Johan Van de Wauw.
+Both are released under the GNU General Public License v2.
+
+More info  I<http://www.saga-gis.org>
+
+=cut
diff --git a/debian/saga_gui.pod b/debian/saga_gui.pod
new file mode 100644
index 0000000..b1c17e3
--- /dev/null
+++ b/debian/saga_gui.pod
@@ -0,0 +1,24 @@
+=head1 NAME
+
+B<saga_gui> - graphical user interface to the System for Automated Geoscientific Analyses
+ 
+=head1 SYNOPSIS
+
+B<saga_gui> [I<filename(.sprj,.sgrd,.shp)>]
+
+=head1 DESCRIPTION
+
+Graphical user interface to the System for Automated Geoscientific Analyses, a free and open source geographic information system used for editing and analysing spatial data. It includes a large number of modules for the analysis of vector, table, grid and image data.
+
+=head1 BUGS
+
+On the project website: I<http://www.saga-gis.org>, a list of known bugs can be found and new bug reports can be submitted.
+
+=head1 AUTHORS
+
+B<SAGA> was written by Olaf Conrad with help from a large number of contributers. This manual page was written by Johan Van de Wauw.
+Both are released under the GNU General Public License v2.
+
+More info  I<http://www.saga-gis.org>
+
+=cut

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-grass/saga.git