From: Andy Spencer <andy753421@gmail.com>
Date: Mon, 8 Feb 2010 11:28:53 +0000 (+0000)
Subject: Add man page for gis-demo
X-Git-Tag: v0.4~70
X-Git-Url: http://pileus.org/git/?p=grits;a=commitdiff_plain;h=7636b76f01f9e0c4ba4088c3cba4fdfa33058e58

Add man page for gis-demo
---

diff --git a/docs/api/Makefile.am b/docs/api/Makefile.am
index 742a495..fce5ed9 100644
--- a/docs/api/Makefile.am
+++ b/docs/api/Makefile.am
@@ -1,6 +1,10 @@
 AM_CPPFLAGS=$(SOUP_CFLAGS) $(GLIB_CFLAGS) $(GTK_CFLAGS)
 
-GTKDOC_LIBS        = $(SOUP_LIBS) $(GLIB_LIBS) $(GTK_LIBS) $(top_srcdir)/src/libgis.la $(top_srcdir)/src/plugins/*.la
+
+# Gtk docs
+GTKDOC_LIBS        = $(SOUP_LIBS) $(GLIB_LIBS) $(GTK_LIBS) \
+		     $(top_srcdir)/src/libgis.la \
+		     $(top_srcdir)/src/plugins/*.la
 DOC_MODULE         = libgis
 DOC_SOURCE_DIR     = $(top_srcdir)/src/
 DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml
@@ -9,5 +13,13 @@ include $(top_srcdir)/gtk-doc.make
 
 CLEANFILES += libgis-sections.txt
 
+
+# Man pages 
+man_MANS = gis-demo.1
+%.1 : %.xml 
+	xsltproc -nonet http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
+BUILT_EXTRA_DIST = $(man_MANS)
+
+
 MAINTAINERCLEANFILES=\
 	tmpl/* Makefile.in libgis-overrides.txt libgis.types libgis-scan.*
diff --git a/docs/api/gis-demo.xml b/docs/api/gis-demo.xml
new file mode 100644
index 0000000..4e06338
--- /dev/null
+++ b/docs/api/gis-demo.xml
@@ -0,0 +1,48 @@
+<refentry id="gis-demo">
+<refmeta>
+	<refentrytitle>gis-demo</refentrytitle>
+	<manvolnum>1</manvolnum>
+</refmeta>
+
+<refnamediv>
+	<refname>gis-demo</refname>
+	<refpurpose>libgis demonstration program</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+	<cmdsynopsis>
+		<command>gis-demo [GTK_OPTIONS]</command>
+	</cmdsynopsis>
+</refsynopsisdiv>
+
+<refsect1><title>Description</title>
+	<para><command>gis-demo</command> TODO (short description)</para>
+	<para>
+		TODO (long description)
+	</para>
+</refsect1>
+
+<refsect1><title>Environment</title>
+	<variablelist>
+		<varlistentry>
+			<term>GIS_PLUGIN_PATH</term>
+			<listitem><para>
+				Secondary path to use when searching for
+				plugins.
+			</para></listitem>
+		</varlistentry>
+	</variablelist>
+</refsect1>
+
+<refsect1><title>Files</title>
+	<variablelist>
+		<varlistentry>
+			<term>$HOME/.config/libgis/config.ini</term>
+			<listitem><para>
+				Configuration file used to store loaded
+				plugins and a few other settings.
+			</para></listitem>
+		</varlistentry>
+	</variablelist>
+</refsect1>
+</refentry>
diff --git a/docs/api/libgis-docs.sgml b/docs/api/libgis-docs.sgml
index 0e5dc44..fe5763e 100644
--- a/docs/api/libgis-docs.sgml
+++ b/docs/api/libgis-docs.sgml
@@ -46,8 +46,7 @@
 
 	<chapter>
 		<title>Miscellaneous</title>
-		<xi:include href="xml/gis-demo.xml"/>
-		<xi:include href="xml/tile-test.xml"/>
+		<xi:include href="gis-demo.xml"/>
 	</chapter>
 
 	<index>