[gnome-documents/gnome-3-8] Add a man page

[Debarshi Ray <debarshir src gnome org>]

commit 3169b6969967e59beb6aa620b4ba0524fe3d8db3
Author: Debarshi Ray <debarshir gnome org>
Date:   Mon Jun 3 16:30:44 2013 +0200

    Add a man page
    
    https://bugzilla.gnome.org/show_bug.cgi?id=701532

 Makefile.am             |    2 +-
 configure.ac            |    3 ++
 man/Makefile.am         |   19 +++++++++++++
 man/gnome-documents.xml |   66 +++++++++++++++++++++++++++++++++++++++++++++++
 4 files changed, 89 insertions(+), 1 deletions(-)
---
diff --git a/Makefile.am b/Makefile.am
index d92dc8e..d77c23f 100644
--- a/Makefile.am
+++ b/Makefile.am
@@ -1,6 +1,6 @@
 ACLOCAL_AMFLAGS = -I m4 -I libgd ${ACLOCAL_FLAGS}
 
-SUBDIRS = libgd egg-list-box src data po
+SUBDIRS = libgd egg-list-box src data man po
 
 if ENABLE_GETTING_STARTED
 
diff --git a/configure.ac b/configure.ac
index f95e21e..7a2e169 100644
--- a/configure.ac
+++ b/configure.ac
@@ -70,6 +70,8 @@ TRACKER_MIN_VERSION=0.13.1
 ZAPOJIT_MIN_VERSION=0.0.2
 SOUP_MIN_VERSION=2.41.3
 
+AC_PATH_PROG([XSLTPROC], [xsltproc])
+
 PKG_CHECK_MODULES(DOCUMENTS,
                   evince-document-3.0 >= $EVINCE_MIN_VERSION
                   evince-view-3.0 >= $EVINCE_MIN_VERSION
@@ -124,6 +126,7 @@ data/Makefile
 data/icons/Makefile
 data/gnome-documents.desktop.in
 getting-started/Makefile
+man/Makefile
 po/Makefile.in
 ])
 
diff --git a/man/Makefile.am b/man/Makefile.am
new file mode 100644
index 0000000..309b362
--- /dev/null
+++ b/man/Makefile.am
@@ -0,0 +1,19 @@
+XSLTPROC_FLAGS = \
+        --nonet \
+        --stringparam man.output.quietly 1 \
+        --stringparam funcsynopsis.style ansi \
+        --stringparam man.th.extra1.suppress 1 \
+        --stringparam man.authors.section.enabled 0 \
+        --stringparam man.copyright.section.enabled 0
+
+.xml.1:
+       $(AM_V_GEN) $(XSLTPROC) $(XSLTPROC_FLAGS) 
http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl $<
+
+man_MANS = \
+       gnome-documents.1
+
+xml_files = $(man_MANS:.1=.xml)
+
+EXTRA_DIST = $(xml_files)
+
+DISTCLEANFILES = $(man_MANS)
diff --git a/man/gnome-documents.xml b/man/gnome-documents.xml
new file mode 100644
index 0000000..65777a3
--- /dev/null
+++ b/man/gnome-documents.xml
@@ -0,0 +1,66 @@
+<?xml version='1.0'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+        "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd";>
+
+<refentry id="gnome-documents">
+
+        <refentryinfo>
+                <title>gnome-documents</title>
+                <productname>GNOME</productname>
+
+                <authorgroup>
+                        <author>
+                                <contrib>Maintainer</contrib>
+                                <firstname>Cosimo</firstname>
+                                <surname>Cecchi</surname>
+                                <email>cosimoc gnome org</email>
+                        </author>
+                </authorgroup>
+
+        </refentryinfo>
+
+        <refmeta>
+                <refentrytitle>gnome-documents</refentrytitle>
+                <manvolnum>1</manvolnum>
+                <refmiscinfo class="manual">User Commands</refmiscinfo>
+        </refmeta>
+
+        <refnamediv>
+                <refname>gnome-documents</refname>
+                <refpurpose>A document manager application for GNOME</refpurpose>
+        </refnamediv>
+
+        <refsynopsisdiv>
+                <cmdsynopsis>
+                        <command>gnome-documents</command>
+                </cmdsynopsis>
+        </refsynopsisdiv>
+
+        <refsect1>
+                <title>Description</title>
+
+                <para><command>gnome-documents</command> is a document
+                manager application designed to work with GNOME 3. You
+                can view your local and online documents, search through
+                them, print or mark them as favorites. It's included in
+                the default set of core applications since GNOME 3.2.</para>
+        </refsect1>
+
+        <refsect1>
+                <title>Bugs</title>
+
+                <para>The bug tracker can be reached by visiting the
+                website <ulink 
url="https://bugzilla.gnome.org/buglist.cgi?product=gnome-documents";>https://bugzilla.gnome.org/buglist.cgi?product=gnome-documents</ulink>.
+                Before sending a bug report, please verify that you have
+                the latest version of gnome-documents. Many bugs (major and
+                minor) are fixed at each release, and if yours is out of
+                date, the problem may already have been solved.</para>
+        </refsect1>
+
+        <refsect1>
+                <title>Additional Information</title>
+
+                <para>For further information, visit the website
+                <ulink 
url="http://live.gnome.org/GnomeDocuments";>http://live.gnome.org/GnomeDocuments</ulink>.</para>
+        </refsect1>
+</refentry>