Add man pages
authorYing-Chun Liu (PaulLiu) <grandpaul@gmail.com>
Sun, 20 Apr 2008 07:30:40 +0000 (07:30 +0000)
committerYing-Chun Liu (PaulLiu) <grandpaul@gmail.com>
Sun, 20 Apr 2008 07:30:40 +0000 (07:30 +0000)
Makefile.am
configure.in
man/Makefile.am [new file with mode: 0644]
man/lxappearance.sgml [new file with mode: 0644]
po/Makefile.in.in

index c184865..4d9b846 100644 (file)
@@ -1,6 +1,6 @@
 ## Process this file with automake to produce Makefile.in
 
-SUBDIRS = src po
+SUBDIRS = src po man
 
 support_scriptdir=$(datadir)/lxappearance
 support_script_DATA= \
index 29f087f..9ca8781 100644 (file)
@@ -27,5 +27,6 @@ AC_OUTPUT([
 Makefile
 src/Makefile
 po/Makefile.in
+man/Makefile
 ])
 
diff --git a/man/Makefile.am b/man/Makefile.am
new file mode 100644 (file)
index 0000000..7a0a2cd
--- /dev/null
@@ -0,0 +1,9 @@
+
+dist_man_MANS = lxapperance.1
+
+EXTRA_DIST = lxapperance.sgml
+
+dist-hook: lxapperance.1
+
+lxapperance.1: lxapperance.sgml
+       docbook-to-man $< > $@
diff --git a/man/lxappearance.sgml b/man/lxappearance.sgml
new file mode 100644 (file)
index 0000000..7ab4cca
--- /dev/null
@@ -0,0 +1,117 @@
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
+
+<!-- Process this file with docbook-to-man to generate an nroff manual
+     page: `docbook-to-man manpage.sgml > manpage.1'.  You may view
+     the manual page with: `docbook-to-man manpage.sgml | nroff -man |
+     less'.  A typical entry in a Makefile or Makefile.am is:
+
+manpage.1: manpage.sgml
+       docbook-to-man $< > $@
+
+    
+       The docbook-to-man binary is found in the docbook-to-man package.
+       Please remember that if you create the nroff version in one of the
+       debian/rules file targets (such as build), you will need to include
+       docbook-to-man in your Build-Depends control field.
+
+  -->
+
+  <!-- Fill in your name for FIRSTNAME and SURNAME. -->
+  <!ENTITY dhfirstname "<firstname>Ying-Chun</firstname>">
+  <!ENTITY dhsurname   "<surname>Liu</surname>">
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY dhdate      "<date>April  20, 2008</date>">
+  <!-- SECTION should be 1-8, maybe w/ subsection other parameters are
+       allowed: see man(7), man(1). -->
+  <!ENTITY dhsection   "<manvolnum>1</manvolnum>">
+  <!ENTITY dhemail     "<email>grandpaul@gmail.com</email>">
+  <!ENTITY dhusername  "paulliu">
+  <!ENTITY dhucpackage "<refentrytitle>LXAPPEARANCE</refentrytitle>">
+  <!ENTITY dhpackage   "lxappearance">
+
+  <!ENTITY debian      "<productname>Debian</productname>">
+  <!ENTITY gnu         "<acronym>GNU</acronym>">
+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
+]>
+
+<refentry>
+  <refentryinfo>
+    <address>
+      &dhemail;
+    </address>
+    <author>
+      &dhfirstname;
+      &dhsurname;
+    </author>
+    <copyright>
+      <year>2008</year>
+      <holder>&dhusername;</holder>
+    </copyright>
+    &dhdate;
+  </refentryinfo>
+  <refmeta>
+    &dhucpackage;
+
+    &dhsection;
+  </refmeta>
+  <refnamediv>
+    <refname>&dhpackage;</refname>
+
+    <refpurpose>GTK+ theme switcher</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&dhpackage;</command>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para>This manual page documents briefly the
+      <command>&dhpackage;</command> command.</para>
+
+    <para><command>&dhpackage;</command> is a program to change
+    GTK+ themes, icon themes, and fonts used by applications. It is a
+    feature-rich GTK+ theme switcher.
+    </para>
+
+  </refsect1>
+
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>This manual page was written by &dhusername; &dhemail; for
+      the &debian; system (but may be used by others).  Permission is
+      granted to copy, distribute and/or modify this document under
+      the terms of the &gnu; General Public License, Version 2 any 
+      later version published by the Free Software Foundation.
+    </para>
+    <para>
+         On Debian systems, the complete text of the GNU General Public
+         License can be found in /usr/share/common-licenses/GPL.
+    </para>
+    <para>
+          The source code of this manual page should be in 
+          <filename>.sgml</filename> format. It is better not to modify
+          the <filename>.1</filename> file directly.
+    </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:
+-->
index 19fc01d..7c26df4 100644 (file)
@@ -196,12 +196,12 @@ dvi info tags TAGS ID:
 
 mostlyclean:
        rm -f core core.* *.pox $(GETTEXT_PACKAGE).po *.old.po cat-id-tbl.tmp
-       rm -fr *.o *.gmo
+       rm -fr *.o
 
 clean: mostlyclean
 
 distclean: clean
-       rm -f Makefile Makefile.in POTFILES *.mo *.gmo *.msg *.cat *.cat.m
+       rm -f Makefile Makefile.in POTFILES *.mo *.msg *.cat *.cat.m
 
 maintainer-clean: distclean
        @echo "This command is intended for maintainers to use;"