[Systraq-commit] r213 - trunk/systraq/man

[Joost van Baal]

Author: joostvb
Date: 2005-02-12 23:31:08 +0100 (Sat, 12 Feb 2005)
New Revision: 213

Added:
   trunk/systraq/man/st_snapshot.hourly.dbx
Modified:
   trunk/systraq/man/Makefile.am
Log:
st_snapshot.hourly manpage, first shot

Modified: trunk/systraq/man/Makefile.am
===================================================================
--- trunk/systraq/man/Makefile.am	2005-02-12 20:57:51 UTC (rev 212)
+++ trunk/systraq/man/Makefile.am	2005-02-12 22:31:08 UTC (rev 213)
@@ -5,11 +5,17 @@
 ## and non GNU make
 SUFFIXES = .pod .1
 
+DB2MAN=/usr/share/sgml/docbook/stylesheet/xsl/nwalsh/manpages/docbook.xsl
+XP=xsltproc -''-nonet
+
 .pod.1:
 	pod2man --center='$(PACKAGE)' --release='$(VERSION)' $? > $@
 
-man_MANS = st_snapshot.1
+st_snapshot.hourly.1: st_snapshot.hourly.dbx
+	$(XP) $(DB2MAN) $<
 
+man_MANS = st_snapshot.1 st_snapshot.hourly.1
+
 EXTRA_DIST = st_snapshot.pod
 CLEANFILES = $(man_MANS)
 

Added: trunk/systraq/man/st_snapshot.hourly.dbx
===================================================================
--- trunk/systraq/man/st_snapshot.hourly.dbx	2005-02-12 20:57:51 UTC (rev 212)
+++ trunk/systraq/man/st_snapshot.hourly.dbx	2005-02-12 22:31:08 UTC (rev 213)
@@ -0,0 +1,131 @@
+<?xml version='1.0' encoding='ISO-8859-1'?>
+<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN"
+"http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [
+
+<!--
+
+$Id$
+$URL$
+
+Based upon /usr/share/debhelper/dh_make/debian/manpage.xml.ex
+
+Process this file with an XSLT processor, as specified in Makefile.am.
+A manual page foo.1 will be generated.  You may view the manual page
+with: 'nroff -man foo.1 | less'.  Or 'man -l ./foo.1'
+
+The xsltproc binary is found in the xsltproc package.  The
+XSL files are in docbook-xsl.
+
+-->
+
+  <!ENTITY firstname "<firstname>Joost</firstname>">
+  <!ENTITY surname   "<surname>van Baal</surname>">
+  <!-- Please adjust the date whenever revising the manpage. -->
+  <!ENTITY date      "<date>#SHORTDATE#</date>">
+  <!ENTITY section   "<manvolnum>1</manvolnum>">
+  <!ENTITY email     "<email>#EMAIL#</email>">
+  <!ENTITY username  "Joost van Baal">
+  <!ENTITY uccommand "<refentrytitle>ST_SNAPSHOT.HOURLY</refentrytitle>">
+  <!ENTITY command   "st_snapshot.hourly">
+
+  <!ENTITY gnu         "<acronym>GNU</acronym>">
+  <!ENTITY gpl         "&gnu; <acronym>GPL</acronym>">
+]>
+
+<refentry>
+  <refentryinfo>
+    <address>
+      &email;
+    </address>
+    <author>
+      &firstname;
+      &surname;
+    </author>
+    <copyright>
+      <year>2005</year>
+      <holder>&username;</holder>
+    </copyright>
+    &date;
+  </refentryinfo>
+  <refmeta>
+    &uccommand;
+
+    &section;
+  </refmeta>
+  <refnamediv>
+    <refname>&command;</refname>
+
+    <refpurpose>wrapper for st_snapshot</refpurpose>
+  </refnamediv>
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>&command;</command>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  <refsect1>
+    <title>DESCRIPTION</title>
+
+    <para><command>&command;</command> is a wrapper for
+st_snapshot.  <command>&command;</command> is to be run from cron.
+
+It checks existence of the files i_want_a_broken_systraq and systraq_is_unconfigured.
+
+
+This manual page documents briefly the
+      <command>&command;</command> and <command>bar</command>
+      commands.</para>
+
+    <para>
+      Instead, it has documentation in the &gnu;
+      <application>Info</application> format; see below.</para>
+
+    <para><command>&command;</command> is a program that...</para>
+
+  </refsect1>
+
+  <refsect1>
+    <title>ENVIRONMENT</title>
+
+    <variablelist>
+      <varlistentry>
+        <term><option>-h</option> ST_MODE
+          <option>--help</option>
+        </term>
+        <listitem>
+          <para>Show summary of options.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+
+    <para> </para>
+
+  </refsect1>
+  <refsect1>
+
+FILES
+
+i_want_a_broken_systraq , systraq_is_unconfigured
+
+  </refsect1>
+  <refsect1>
+    <title>SEE ALSO</title>
+
+    <para>bar (1), baz (1).</para>
+
+    <para>The programs are documented fully by <citetitle>The Rise and
+      Fall of a Fooish Bar</citetitle> available via the
+      <application>Info</application> system.</para>
+  </refsect1>
+  <refsect1>
+    <title>AUTHOR</title>
+
+    <para>This manual page was written by &username;.
+      Permission is
+      granted to copy, distribute and/or modify this document under
+      the terms of the &gnu; General Public License, Version 2 or any
+      later version published by the Free Software Foundation.
+    </para>
+
+  </refsect1>
+</refentry>
+


Property changes on: trunk/systraq/man/st_snapshot.hourly.dbx
___________________________________________________________________
Name: svn:keywords
   + Id URL Author Date Rev