Koha/debian/docs/koha-list.xml
Magnus Enger 46574c9160 Bug 10622 - [SIGNED OFF] Followup: Add --sip, --nosip and --help to man page
The original patch for bug 10622 added the --sip, --nosip and
--help switches to the koha-list command, but did not update the
manpage for the command. This patch does.

To test:

Run these commands and look at the formatted man page:
$ xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl \
  debian/docs/koha-list.xml
$ man -l koha-list.8

Make sure this test passes:
$ prove -v xt/verify-debian-docbook.t

Signed-off-by: Tomas Cohen Arazi <tomascohen@gmail.com>
Forgot the docs this time, good catch Magnus

Signed-off-by: Robin Sheat <robin@catalyst.net.nz>
Signed-off-by: Galen Charlton <gmc@esilibrary.com>
2013-09-21 17:45:48 +00:00

96 lines
3.1 KiB
XML

<article xmlns='http://docbook.org/ns/docbook'>
<title>koha-list</title>
<info>
<productname>Koha</productname> is the first free software library automation package.
<author>
<orgname>The Koha Community</orgname>
<uri>http://koha-community.org/</uri>
</author>
</info>
<refentry xml:id="koha-list">
<refmeta>
<refentrytitle>koha-list</refentrytitle>
<manvolnum>8</manvolnum>
</refmeta>
<refnamediv>
<refname>koha-list</refname>
<refpurpose>Lists Koha instances, and optionally only those that are enabled/disabled or have email and/or sip turned on/off.</refpurpose>
<refclass>UNIX/Linux</refclass>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>koha-list</command>
<arg><option>--enabled</option>|<option>--disabled</option></arg>
<arg><option>--email</option>|<option>--noemail</option></arg>
<arg><option>--sip</option>|<option>--nosip</option></arg>
<arg><option>-h</option>|<option>--help</option></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1><title>Options</title>
<para>The filtering options can be combined, and you probably want to do this (except --email and --noemail, or --enabled and --disabled, that's just silly.)</para>
<variablelist>
<varlistentry>
<term><option>--enabled</option></term>
<listitem>
<para>Only show instances that are enabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--disabled</option></term>
<listitem>
<para>Only show instances that are disabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--email</option></term>
<listitem>
<para>Only show instances that have email enabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--noemail</option></term>
<listitem>
<para>Only show instances that do not have email enabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--sip</option></term>
<listitem>
<para>Only show instances that have sip enabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>--nosip</option></term>
<listitem>
<para>Only show instances that do not have sip enabled.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-h</option>|<option>--help</option></term>
<listitem>
<para>This help.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1><title>Description</title>
<para>This script lists Koha instances on a server. Optionally only those that are enabled or disabled can be listed. There are also options for listing only servers that have email or sip enabled/disabled. These limits can be applied alone or in combination.</para>
</refsect1>
<refsect1><title>See also</title>
<simplelist type="inline">
<member><command>koha-create-dirs(8)</command></member>
<member><command>koha-foreach(8)</command></member>
</simplelist>
</refsect1>
</refentry>
</article>