Koha/debian/docs/koha-list.xml
Tomas Cohen Arazi de275ec128 Bug 10094 - koha-list should have a --disabled option switch
This patch adds that (--disabled) option switch, Also revisits some of the code and docs.

To test:
- Apply the patch and create new packages (you might just drop the koha-list command somewhere)
- Create several instances (koha-create)
- Randomly set some as disabled, others enabled and enable email on some.
- Test all possible option switches combinations

Expected results:
- koha-list should abort with a proper message if mutually exclusive options selected (--email vs. --noemail, --enabled vs. --disabled)
- koha-list should show the exact instances you asked for

Regards
To+

P.S.: I wanted to add the --disabled option switch for the tab-completion work I'm doing, but as of bug 4876 I thought it would be ok to revisit the script to make it robust and clear.

Sponsored-by: Universidad Nacional de Córdoba
Signed-off-by: Robin Sheat <robin@catalyst.net.nz>

Does what it says, and cleans up the script at the same time.
Signed-off-by: Jared Camins-Esakov <jcamins@cpbibliography.com>
2013-05-15 08:14:09 -04:00

79 lines
2.4 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, optionally only those that are enabled or have email turned on.</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>-h</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>-h</option></term>
<listitem>
<para>This help.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1><title>Description</title>
<para>Lists Koha instances, optionally only those that are enabled or have email turned on.</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>