[gnome-software] Include a skeleton man page for gnome-software

[Richard Hughes <rhughes src gnome org>]

commit 6fbfd75a3d6d941d01e018c6d1e6d06a13496a2b
Author: Richard Hughes <richard hughsie com>
Date:   Wed Aug 28 20:23:04 2013 +0100

    Include a skeleton man page for gnome-software

 configure.ac                   |    1 +
 contrib/gnome-software.spec.in |    2 +
 src/Makefile.am                |   14 +++++++-
 src/gnome-software.sgml        |   74 ++++++++++++++++++++++++++++++++++++++++
 4 files changed, 90 insertions(+), 1 deletions(-)
---
diff --git a/configure.ac b/configure.ac
index 46e3da8..e48130a 100644
--- a/configure.ac
+++ b/configure.ac
@@ -75,6 +75,7 @@ dnl ---------------------------------------------------------------------------
 PKG_CHECK_MODULES(GTK, gtk+-3.0 >= 3.9.12)
 PKG_CHECK_MODULES(PACKAGEKIT, packagekit-glib2 >= 0.8.10)
 PKG_CHECK_MODULES(SQLITE, sqlite3)
+AC_PATH_PROG(DOCBOOK2MAN, docbook2man)
 
 dnl ---------------------------------------------------------------------------
 dnl - Makefiles, etc.
diff --git a/contrib/gnome-software.spec.in b/contrib/gnome-software.spec.in
index f135dde..e18ca3b 100644
--- a/contrib/gnome-software.spec.in
+++ b/contrib/gnome-software.spec.in
@@ -14,6 +14,7 @@ Requires:  gnome-icon-theme
 BuildRequires: gtk3-devel >= 3.0.0
 BuildRequires: gettext
 BuildRequires: intltool
+BuildRequires: docbook-utils
 BuildRequires: glib2-devel >= 2.25.9-2
 
 Requires(post):   /usr/bin/gtk-update-icon-cache
@@ -66,6 +67,7 @@ glib-compile-schemas %{_datadir}/glib-2.0/schemas &> /dev/null || :
 #%{_datadir}/icons/hicolor/scalable/*/*.svg*
 %{_datadir}/applications/gnome-software.desktop
 %{_datadir}/gnome-software/*.png
+%{_mandir}/man1/gnome-software.1.gz
 %{_libdir}/gs-plugins/*.so
 
 %changelog
diff --git a/src/Makefile.am b/src/Makefile.am
index c99b1a5..3c0ce4a 100644
--- a/src/Makefile.am
+++ b/src/Makefile.am
@@ -103,14 +103,26 @@ TESTS = gs-self-test
 
 EXTRA_DIST =                                           \
        gnome-software.gresource.xml                    \
+       gnome-software.sgml                             \
        gtk-style.css                                   \
        $(desktop_in_files)                             \
        $(UI_FILES)
 
+man_MANS =                                             \
+       gnome-software.1
+
+gnome-software.1: gnome-software.sgml
+       docbook2man $? > /dev/null
+
 clean-local:
        rm -f *~
+       rm -f *.1
+       rm -f manpage.*
 
-CLEANFILES = $(BUILT_SOURCES)
+CLEANFILES =                                           \
+       $(BUILT_SOURCES)                                \
+       gnome-software.1                                \
+       manpage.*
 
 MAINTAINERCLEANFILES =                                 \
        *~                                              \
diff --git a/src/gnome-software.sgml b/src/gnome-software.sgml
new file mode 100644
index 0000000..26a683e
--- /dev/null
+++ b/src/gnome-software.sgml
@@ -0,0 +1,74 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY package     "gnome-software">
+  <!ENTITY gnu         "<acronym>GNU</acronym>">
+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
+]>
+
+<refentry>
+  <refentryinfo>
+    <address>
+      <email>richard hughsie com</email>;
+    </address>
+    <author>
+      <firstname>Richard</firstname>
+      <surname>Hughes</surname>
+    </author>
+    <copyright>
+      <year>2013</year>
+      <holder>Richard Hughes</holder>
+    </copyright>
+    &date;
+  </refentryinfo>
+  <refmeta>
+    <refentrytitle>gnome-software</refentrytitle>
+    <manvolnum>1</manvolnum>
+  </refmeta>
+  <refnamediv>
+    <refname>&package;</refname>
+    <refpurpose>GNOME PackageKit Software Log Viewer</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&package;</command>
+      <arg><option>--verbose</option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+    <para>
+      This manual page documents briefly the <command>&package;</command> command.
+    </para>
+    <para>
+      <command>&package;</command> allows you to add and remove applications and
+      update your system.
+    </para>
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+    <para>gnome-software (1).</para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+    <para>This manual page was written by Richard Hughes <email>richard hughsie com</email>.
+    </para>
+  </refsect1>
+</refentry>
+
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:2
+sgml-indent-data:t
+sgml-parent-document:nil
+sgml-default-dtd-file:nil
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+-->
+