summaryrefslogtreecommitdiffstats
path: root/test/Docbook/basic/man
diff options
context:
space:
mode:
Diffstat (limited to 'test/Docbook/basic/man')
-rw-r--r--test/Docbook/basic/man/image/SConstruct3
-rw-r--r--test/Docbook/basic/man/image/refdb.xml82
-rw-r--r--test/Docbook/basic/man/man.py59
3 files changed, 144 insertions, 0 deletions
diff --git a/test/Docbook/basic/man/image/SConstruct b/test/Docbook/basic/man/image/SConstruct
new file mode 100644
index 0000000..ddfcfbc
--- /dev/null
+++ b/test/Docbook/basic/man/image/SConstruct
@@ -0,0 +1,3 @@
+env = Environment(tools=['docbook'])
+env.DocbookMan('refdb')
+
diff --git a/test/Docbook/basic/man/image/refdb.xml b/test/Docbook/basic/man/image/refdb.xml
new file mode 100644
index 0000000..de5f94e
--- /dev/null
+++ b/test/Docbook/basic/man/image/refdb.xml
@@ -0,0 +1,82 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<refentry id="refentry-refdb8">
+ <refentryinfo><date>2005-10-15</date></refentryinfo>
+ <refmeta>
+ <refentrytitle>refdb</refentrytitle>
+ <manvolnum>8</manvolnum>
+ <refmiscinfo class="date">2005-10-15</refmiscinfo>
+ <refmiscinfo class="manual">RefDB Manual</refmiscinfo>
+ </refmeta>
+ <refnamediv id="refdb-name">
+ <refname>refdb</refname>
+ <refname>refdb.sh</refname>
+ <refpurpose>refdbd startup script</refpurpose>
+ </refnamediv>
+ <!-- body begins here -->
+ <refsynopsisdiv id="refdb-synopsis">
+ <cmdsynopsis>
+ <command>refdb</command>
+ <group choice="plain">
+ <arg choice="plain"><replaceable>start</replaceable></arg>
+ <arg choice="plain"><replaceable>stop</replaceable></arg>
+ <arg choice="plain"><replaceable>restart</replaceable></arg>
+ <arg choice="plain"><replaceable>force-reload</replaceable></arg>
+ </group>
+ </cmdsynopsis>
+ </refsynopsisdiv>
+
+
+ <refsect1 id="refdb-description">
+ <title>Description</title>
+ <para>refdb is a wrapper script for refdbd(1) to be used as a rc(8) or init(8) control script. The script is called refdb.sh on BSD-style systems. See the documentation of your system how to integrate refdb into the start process to run refdbd(1) automatically as a daemon.</para>
+ </refsect1>
+
+ <refsect1 id="refdb-options">
+ <title>Options</title>
+ <variablelist remap="TP">
+ <varlistentry>
+ <term><emphasis remap="I">start</emphasis></term>
+ <listitem>
+ <para>Starts the refdbd(1) daemon</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap="I">stop</emphasis></term>
+ <listitem>
+ <para>Stops the refdbd(1) daemon</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap="I">restart</emphasis></term>
+ <listitem>
+ <para>Restarts the refdbd(1) daemon</para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><emphasis remap="I">force-reload</emphasis></term>
+ <listitem>
+ <para>Causes the refdbd(1) daemon to read its configuration file</para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </refsect1>
+
+ <refsect1 id="refdb-see_also">
+ <title>See also</title>
+ <para><emphasis remap="B">RefDB</emphasis> (7),
+ <emphasis remap="B"><link linkend="refentry-refdbd">refdbd</link></emphasis> (1)
+ <emphasis remap="B"><link linkend="refentry-refdbctl">refdbctl</link></emphasis> (1).</para>
+
+ <para><emphasis remap="I">RefDB manual (local copy) </emphasis> &lt;prefix&gt;/share/doc/refdb-&lt;version&gt;/refdb-manual/index.html</para>
+
+ <para><emphasis remap="I">RefDB manual (web) </emphasis> &lt;<ulink url="http://refdb.sourceforge.net/manual/index.html">http://refdb.sourceforge.net/manual/index.html</ulink>&gt;</para>
+
+ <para><emphasis remap="I">RefDB on the web </emphasis> &lt;<ulink url="http://refdb.sourceforge.net/">http://refdb.sourceforge.net/</ulink>&gt;</para>
+ </refsect1>
+
+ <refsect1 id="refdb-author">
+ <title>Author</title>
+ <para>refdb was written by Markus Hoenicka &lt;markus@mhoenicka.de&gt;.</para>
+
+ </refsect1>
+</refentry>
diff --git a/test/Docbook/basic/man/man.py b/test/Docbook/basic/man/man.py
new file mode 100644
index 0000000..c1f164d
--- /dev/null
+++ b/test/Docbook/basic/man/man.py
@@ -0,0 +1,59 @@
+#!/usr/bin/env python
+#
+# Copyright (c) 2001-2010 The SCons Foundation
+#
+# Permission is hereby granted, free of charge, to any person obtaining
+# a copy of this software and associated documentation files (the
+# "Software"), to deal in the Software without restriction, including
+# without limitation the rights to use, copy, modify, merge, publish,
+# distribute, sublicense, and/or sell copies of the Software, and to
+# permit persons to whom the Software is furnished to do so, subject to
+# the following conditions:
+#
+# The above copyright notice and this permission notice shall be included
+# in all copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+# KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
+# WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+# LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+# OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+# WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+#
+
+"""
+Test the Man builder.
+"""
+
+import TestSCons
+
+test = TestSCons.TestSCons()
+
+try:
+ import libxml2
+except:
+ try:
+ import lxml
+ except:
+ test.skip_test('Cannot find installed Python binding for libxml2 or lxml, skipping test.\n')
+
+test.dir_fixture('image')
+
+# Normal invocation
+test.run(stderr=None)
+test.must_exist(test.workpath('refdb.8'))
+test.must_exist(test.workpath('refdb.sh.8'))
+
+# Cleanup
+test.run(arguments='-c')
+test.must_not_exist(test.workpath('refdb.8'))
+test.must_not_exist(test.workpath('refdb.sh.8'))
+
+test.pass_test()
+
+# Local Variables:
+# tab-width:4
+# indent-tabs-mode:nil
+# End:
+# vim: set expandtab tabstop=4 shiftwidth=4: