[Patches] [PATCH] Bug 4877 - Add DocBook for missing manual pages

koha-patchbot at kohaaloha.com koha-patchbot at kohaaloha.com
Fri Nov 4 19:52:20 NZDT 2011


From: Magnus Enger <magnus at enger.priv.no>
Date: Mon, 17 Oct 2011 12:23:09 +0200
Subject: [PATCH] Bug 4877 - Add DocBook for missing manual pages

Add DocBook manual pages for commands that do not have a manual page yet. Also
add a page for koha-common itself, listing all the available commands.

Signed-off-by: Robin Sheat <robin at catalyst.net.nz>

Minor change: I fixed a typo I spotted
---
 debian/docs/koha-common.xml         |  206 +++++++++++++++++++++++++++++++++++
 debian/docs/koha-create-dirs.xml    |   43 +++++++
 debian/docs/koha-disable.xml        |   45 ++++++++
 debian/docs/koha-dump-defaults.xml  |   44 ++++++++
 debian/docs/koha-dump.xml           |   45 ++++++++
 debian/docs/koha-email-disable.xml  |   42 +++++++
 debian/docs/koha-email-enable.xml   |   42 +++++++
 debian/docs/koha-enable.xml         |   45 ++++++++
 debian/docs/koha-foreach.xml        |   43 +++++++
 debian/docs/koha-list.xml           |   73 ++++++++++++
 debian/docs/koha-mysql.xml          |   44 ++++++++
 debian/docs/koha-rebuild-zebra.xml  |   67 +++++++++++
 debian/docs/koha-remove.xml         |   17 ++-
 debian/docs/koha-reset-passwd.xml   |   44 ++++++++
 debian/docs/koha-restart-zebra.xml  |   44 ++++++++
 debian/docs/koha-restore.xml        |   45 ++++++++
 debian/docs/koha-start-zebra.xml    |   44 ++++++++
 debian/docs/koha-stop-zebra.xml     |   44 ++++++++
 debian/docs/koha-upgrade-schema.xml |   44 ++++++++
 debian/docs/koha-upgrade-to-3.4.xml |   41 +++++++
 20 files changed, 1058 insertions(+), 4 deletions(-)
 create mode 100644 debian/docs/koha-common.xml
 create mode 100644 debian/docs/koha-create-dirs.xml
 create mode 100644 debian/docs/koha-disable.xml
 create mode 100644 debian/docs/koha-dump-defaults.xml
 create mode 100644 debian/docs/koha-dump.xml
 create mode 100644 debian/docs/koha-email-disable.xml
 create mode 100644 debian/docs/koha-email-enable.xml
 create mode 100644 debian/docs/koha-enable.xml
 create mode 100644 debian/docs/koha-foreach.xml
 create mode 100644 debian/docs/koha-list.xml
 create mode 100644 debian/docs/koha-mysql.xml
 create mode 100644 debian/docs/koha-rebuild-zebra.xml
 create mode 100644 debian/docs/koha-reset-passwd.xml
 create mode 100644 debian/docs/koha-restart-zebra.xml
 create mode 100644 debian/docs/koha-restore.xml
 create mode 100644 debian/docs/koha-start-zebra.xml
 create mode 100644 debian/docs/koha-stop-zebra.xml
 create mode 100644 debian/docs/koha-upgrade-schema.xml
 create mode 100644 debian/docs/koha-upgrade-to-3.4.xml

diff --git a/debian/docs/koha-common.xml b/debian/docs/koha-common.xml
new file mode 100644
index 0000000..0e70595
--- /dev/null
+++ b/debian/docs/koha-common.xml
@@ -0,0 +1,206 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-common</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-common">
+
+  <refmeta>
+    <refentrytitle>koha-common</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-common</refname>
+    <refpurpose>Create and manage Koha instances.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsect1><title>Description</title>
+    <para>koha-common provides a number of scripts for creating and administering Koha instances. It is meant for sites that provide Koha hosting, and serves several sites from the same host.</para>
+  </refsect1>
+
+  <refsect1><title>Commands</title>
+    <para>The following commands are available after when koha-common has been installed. See individual manual pages for each command for optios and other details related to their usage.</para>
+
+    <refsect2><title>Administer instances</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>koha-disable</option></term>
+        <listitem>
+          <para>Disable a Koha instance.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-enable</option></term>
+        <listitem>
+          <para>Enable a Koha instance. New instances are enabled by default. You only need this command if you have previously disabled a site with koha-disable.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-restore</option></term>
+        <listitem>
+          <para>Restore a Koha site from a dump (from koha-dump).</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-dump</option></term>
+        <listitem>
+          <para>Dump all contents and configs for a Koha site.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-remove</option></term>
+        <listitem>
+          <para>Remove a Koha instance.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    </refsect2>
+
+    <refsect2><title>Database-related</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>koha-dump-defaults</option></term>
+        <listitem>
+          <para>Create default contents from an existing Koha site.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-upgrade-schema</option></term>
+        <listitem>
+          <para>Upgrade the DB schema for Koha instances. Done automatically on package upgrades.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-reset-passwd</option></term>
+        <listitem>
+          <para>Reset password for a user in a Koha instance.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-mysql</option></term>
+        <listitem>
+          <para>Provide an interactive mysql shell set up for the specified koha instance.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    </refsect2>
+
+    <refsect2><title>Zebra-related</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>koha-start-zebra</option></term>
+        <listitem>
+          <para>Start Zebra for named Koha instances.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-restart-zebra</option></term>
+        <listitem>
+          <para>Restart Zebra for named Koha instances.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-rebuild-zebra</option></term>
+        <listitem>
+          <para>Rebuild the Zebra database for a Koha instance.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-stop-zebra</option></term>
+        <listitem>
+          <para>Stop Zebra for named Koha instances.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    </refsect2>
+
+    <refsect2><title>E-mail</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>koha-email-enable</option></term>
+        <listitem>
+          <para>Turn on the email for a Koha instance.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-email-disable</option></term>
+        <listitem>
+          <para>Turn off the email for a Koha instance.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    </refsect2>
+
+    <refsect2><title>Misc</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>koha-upgrade-to-3.4</option></term>
+        <listitem>
+          <para>Performs the necessary changes to upgrade a Koha system from 3.2 to 3.4. If no instance names are provided, this will run it on all of them.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    </refsect2>
+
+    <refsect2><title>Utilities</title>
+    <variablelist>
+
+      <varlistentry>
+        <term><option>koha-create-dirs</option></term>
+        <listitem>
+          <para>Create dirs for a Koha instance.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-list</option></term>
+        <listitem>
+          <para>Lists Koha instances, optionally only those that are enabled or have email turned on.</para>
+        </listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><option>koha-foreach</option></term>
+        <listitem>
+          <para>Run a command for each Koha instance. Takes the same arguments as koha-list.</para>
+        </listitem>
+      </varlistentry>
+    </variablelist>
+    </refsect2>
+  </refsect1>
+  
+  <refsect1><title>Bugs</title>
+  <para>The scripts are a bit fragile. If something goes wrong, they do not clean up after themselves.</para>
+  <para>Bugs can be reported here: <uri>http://bugs.koha-community.org/bugzilla3/</uri></para>
+  </refsect1>
+
+  <refsect1><title>About Koha</title>
+  <para>Koha is the first free software library automation package. In use worldwide, its development is steered by a growing community of users collaborating to achieve their technology goals. Koha’s feature set continues to evolve and expand to meet the needs of its user base.</para>
+  </refsect1>
+
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-create-dirs.xml b/debian/docs/koha-create-dirs.xml
new file mode 100644
index 0000000..9f9ddea
--- /dev/null
+++ b/debian/docs/koha-create-dirs.xml
@@ -0,0 +1,43 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-create-dirs</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-create-dirs">
+
+  <refmeta>
+    <refentrytitle>koha-create-dirs</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-create-dirs</refname>
+    <refpurpose>Create dirs for a Koha instance.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-create-dirs</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Create dirs for a Koha instance.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-foreach(8)</command></member>
+    <member><command>koha-list(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-disable.xml b/debian/docs/koha-disable.xml
new file mode 100644
index 0000000..8b7f729
--- /dev/null
+++ b/debian/docs/koha-disable.xml
@@ -0,0 +1,45 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-disable</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-disable">
+
+  <refmeta>
+    <refentrytitle>koha-disable</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-disable</refname>
+    <refpurpose>Disable a Koha instance.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-disable</command> <arg choice="req" rep="norepeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Disable a Koha instance.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-dump(8)</command></member>
+    <member><command>koha-enable(8)</command></member>
+    <member><command>koha-remove(8)</command></member>
+    <member><command>koha-restore(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-dump-defaults.xml b/debian/docs/koha-dump-defaults.xml
new file mode 100644
index 0000000..048c3e9
--- /dev/null
+++ b/debian/docs/koha-dump-defaults.xml
@@ -0,0 +1,44 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-dump-defaults</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-dump-defaults">
+
+  <refmeta>
+    <refentrytitle>koha-dump-defaults</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-dump-defaults</refname>
+    <refpurpose>Create default contents from an existing Koha site.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-dump-defaults</command> <arg choice="req" rep="norepeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Create default contents from an existing Koha site.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-mysql(8)</command></member>
+    <member><command>koha-reset-passwd(8)</command></member>
+    <member><command>koha-upgrade-schema(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-dump.xml b/debian/docs/koha-dump.xml
new file mode 100644
index 0000000..ec79f6e
--- /dev/null
+++ b/debian/docs/koha-dump.xml
@@ -0,0 +1,45 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-dump</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-dump">
+
+  <refmeta>
+    <refentrytitle>koha-dump</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-dump</refname>
+    <refpurpose>Dump all contents and configs for a Koha site.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-dump</command> <arg choice="req" rep="norepeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Dump all contents and configs for a Koha site.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-disable(8)</command></member>
+    <member><command>koha-enable(8)</command></member>
+    <member><command>koha-remove(8)</command></member>
+    <member><command>koha-restore(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-email-disable.xml b/debian/docs/koha-email-disable.xml
new file mode 100644
index 0000000..83bf8ef
--- /dev/null
+++ b/debian/docs/koha-email-disable.xml
@@ -0,0 +1,42 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-email-disable</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-email-disable">
+
+  <refmeta>
+    <refentrytitle>koha-email-disable</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-email-disable</refname>
+    <refpurpose>Turn off the email for a Koha instance.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-email-disable</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Turn off the email for a Koha instance.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-email-enable(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-email-enable.xml b/debian/docs/koha-email-enable.xml
new file mode 100644
index 0000000..5274f75
--- /dev/null
+++ b/debian/docs/koha-email-enable.xml
@@ -0,0 +1,42 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-email-enable</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-email-enable">
+
+  <refmeta>
+    <refentrytitle>koha-email-enable</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-email-enable</refname>
+    <refpurpose>Turn on the email for a Koha instance.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-email-enable</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Turn on the email for a Koha instance.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-email-disable(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-enable.xml b/debian/docs/koha-enable.xml
new file mode 100644
index 0000000..a2f8cc3
--- /dev/null
+++ b/debian/docs/koha-enable.xml
@@ -0,0 +1,45 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-enable</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-enable">
+
+  <refmeta>
+    <refentrytitle>koha-enable</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-enable</refname>
+    <refpurpose>Enable a Koha instance. New instances are enabled by default. You only need this command if you have previously disabled a site with koha-disable.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-enable</command> <arg choice="req" rep="norepeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Enable a Koha instance. New instances are enabled by default. You only need this command if you have previously disabled a site with koha-disable.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-disable(8)</command></member>
+    <member><command>koha-dump(8)</command></member>
+    <member><command>koha-remove(8)</command></member>
+    <member><command>koha-restore(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-foreach.xml b/debian/docs/koha-foreach.xml
new file mode 100644
index 0000000..869e9c7
--- /dev/null
+++ b/debian/docs/koha-foreach.xml
@@ -0,0 +1,43 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-foreach</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-foreach">
+
+  <refmeta>
+    <refentrytitle>koha-foreach</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-foreach</refname>
+    <refpurpose>Run a command for each Koha instance. Takes the same arguments as koha-list.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-list</command> <arg><option>--enabled</option></arg> <arg><option>--email</option>|<option>--noemail</option></arg> <arg><option>command</option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Run a command for each Koha instance. Takes the same arguments as koha-list.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-create-dirs(8)</command></member>
+    <member><command>koha-list(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-list.xml b/debian/docs/koha-list.xml
new file mode 100644
index 0000000..9d0acf9
--- /dev/null
+++ b/debian/docs/koha-list.xml
@@ -0,0 +1,73 @@
+<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 Communnity</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></arg> <arg><option>--email</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, 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>--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>
diff --git a/debian/docs/koha-mysql.xml b/debian/docs/koha-mysql.xml
new file mode 100644
index 0000000..b8079ce
--- /dev/null
+++ b/debian/docs/koha-mysql.xml
@@ -0,0 +1,44 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-mysql</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-mysql">
+
+  <refmeta>
+    <refentrytitle>koha-mysql</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-mysql</refname>
+    <refpurpose>Provide an interactive mysql shell set up for the specified koha instance.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-mysql</command> <arg choice="req" rep="norepeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Provide an interactive mysql shell set up for the specified koha instance.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-dump-defaults(8)</command></member>
+    <member><command>koha-reset-passwd(8)</command></member>
+    <member><command>koha-upgrade-schema(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-rebuild-zebra.xml b/debian/docs/koha-rebuild-zebra.xml
new file mode 100644
index 0000000..e5b319c
--- /dev/null
+++ b/debian/docs/koha-rebuild-zebra.xml
@@ -0,0 +1,67 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-rebuild-zebra</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-rebuild-zebra">
+
+  <refmeta>
+    <refentrytitle>koha-rebuild-zebra</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-rebuild-zebra</refname>
+    <refpurpose>Rebuild the Zebra database for a Koha instance.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-rebuild-zebra</command> <arg><option>-u</option>|<option>--usmarc</option></arg> <arg><option>-f</option>|<option>--full</option></arg> <arg><option>...</option></arg> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+  
+  <refsect1><title>Options</title>
+  <variablelist> 
+    <varlistentry>
+      <term><option>-u, --usmarc</option></term>
+      <listitem>
+        <para>Runs the process as USMARC rather than the default of MARCXML.</para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term><option>-f, --full</option></term>
+      <listitem>
+        <para>Does a reindex of the whole collection.</para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term><option>-...</option></term>
+      <listitem>
+        <para>Anything else is passed directly to rebuild_zebra. This is useful in particular for -v.</para>
+      </listitem>
+    </varlistentry>
+  </variablelist>
+  </refsect1>
+
+  <refsect1><title>Description</title>
+  <para>Rebuild the Zebra database for a Koha instance.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-restart-zebra(8)</command></member>
+    <member><command>koha-start-zebra(8)</command></member>
+    <member><command>koha-stop-zebra(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-remove.xml b/debian/docs/koha-remove.xml
index 5d5767f..ee2b266 100644
--- a/debian/docs/koha-remove.xml
+++ b/debian/docs/koha-remove.xml
@@ -17,20 +17,29 @@
 
   <refnamediv>
     <refname>koha-remove</refname>
-    <refpurpose>Remove one or more Koha instance(s).</refpurpose>
+    <refpurpose>Remove a Koha instance.</refpurpose>
     <refclass>UNIX/Linux</refclass>
   </refnamediv>
 
   <refsynopsisdiv>
     <cmdsynopsis>
-      <command>koha-remove</command>
-      <arg choice="req" rep="repeat">instancename</arg>
+      <command>koha-remove</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
     </cmdsynopsis>
   </refsynopsisdiv>
 
   <refsect1><title>Description</title>
-  <para>Remove one or more Koha instance(s). This removes all files associated with a Koha instance.</para>
+  <para>Remove a Koha instance.</para>
   </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-disable(8)</command></member>
+    <member><command>koha-dump(8)</command></member>
+    <member><command>koha-enable(8)</command></member>
+    <member><command>koha-restore(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
 </refentry>
 
 </article>
diff --git a/debian/docs/koha-reset-passwd.xml b/debian/docs/koha-reset-passwd.xml
new file mode 100644
index 0000000..85e8443
--- /dev/null
+++ b/debian/docs/koha-reset-passwd.xml
@@ -0,0 +1,44 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-reset-passwd</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-reset-passwd">
+
+  <refmeta>
+    <refentrytitle>koha-reset-passwd</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-reset-passwd</refname>
+    <refpurpose>Reset password for a user in a Koha instance.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-reset-passwd</command> <arg choice="req" rep="norepeat"><replaceable>instancename</replaceable></arg> <arg choice="req" rep="norepeat">username</arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Reset password for a user in a Koha instance.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-dump-defaults(8)</command></member>
+    <member><command>koha-mysql(8)</command></member>
+    <member><command>koha-upgrade-schema(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-restart-zebra.xml b/debian/docs/koha-restart-zebra.xml
new file mode 100644
index 0000000..649df1e
--- /dev/null
+++ b/debian/docs/koha-restart-zebra.xml
@@ -0,0 +1,44 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-restart-zebra</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-restart-zebra">
+
+  <refmeta>
+    <refentrytitle>koha-restart-zebra</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-restart-zebra</refname>
+    <refpurpose>Restart Zebra for named Koha instances.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-restart-zebra</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Restart Zebra for named Koha instances.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-rebuild-zebra(8)</command></member>
+    <member><command>koha-start-zebra(8)</command></member>
+    <member><command>koha-stop-zebra(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-restore.xml b/debian/docs/koha-restore.xml
new file mode 100644
index 0000000..6acb0e8
--- /dev/null
+++ b/debian/docs/koha-restore.xml
@@ -0,0 +1,45 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-restore</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-restore">
+
+  <refmeta>
+    <refentrytitle>koha-restore</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-restore</refname>
+    <refpurpose>Restore a Koha site from a dump (from koha-dump).</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-restore</command> <arg choice="req"><option>sqldump</option></arg> <arg choice="req"><option>configdump</option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Restore a Koha site from a dump (from koha-dump).</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-disable(8)</command></member>
+    <member><command>koha-dump(8)</command></member>
+    <member><command>koha-enable(8)</command></member>
+    <member><command>koha-remove(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-start-zebra.xml b/debian/docs/koha-start-zebra.xml
new file mode 100644
index 0000000..eb3c2ab
--- /dev/null
+++ b/debian/docs/koha-start-zebra.xml
@@ -0,0 +1,44 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-start-zebra</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-start-zebra">
+
+  <refmeta>
+    <refentrytitle>koha-start-zebra</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-start-zebra</refname>
+    <refpurpose>Start Zebra for named Koha instances.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-start-zebra</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Start Zebra for named Koha instances.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-rebuild-zebra(8)</command></member>
+    <member><command>koha-restart-zebra(8)</command></member>
+    <member><command>koha-stop-zebra(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-stop-zebra.xml b/debian/docs/koha-stop-zebra.xml
new file mode 100644
index 0000000..050ddd7
--- /dev/null
+++ b/debian/docs/koha-stop-zebra.xml
@@ -0,0 +1,44 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-stop-zebra</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-stop-zebra">
+
+  <refmeta>
+    <refentrytitle>koha-stop-zebra</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-stop-zebra</refname>
+    <refpurpose>Stop Zebra for named Koha instances.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-stop-zebra</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Stop Zebra for named Koha instances.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-rebuild-zebra(8)</command></member>
+    <member><command>koha-restart-zebra(8)</command></member>
+    <member><command>koha-start-zebra(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-upgrade-schema.xml b/debian/docs/koha-upgrade-schema.xml
new file mode 100644
index 0000000..8b5a4c4
--- /dev/null
+++ b/debian/docs/koha-upgrade-schema.xml
@@ -0,0 +1,44 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-upgrade-schema</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-upgrade-schema">
+
+  <refmeta>
+    <refentrytitle>koha-upgrade-schema</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-upgrade-schema</refname>
+    <refpurpose>Upgrade the DB schema for Koha instances. Done automatically on package upgrades.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-upgrade-schema</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Upgrade the DB schema for Koha instances. Done automatically on package upgrades.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+    <member><command>koha-dump-defaults(8)</command></member>
+    <member><command>koha-mysql(8)</command></member>
+    <member><command>koha-reset-passwd(8)</command></member>
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
diff --git a/debian/docs/koha-upgrade-to-3.4.xml b/debian/docs/koha-upgrade-to-3.4.xml
new file mode 100644
index 0000000..c528377
--- /dev/null
+++ b/debian/docs/koha-upgrade-to-3.4.xml
@@ -0,0 +1,41 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-upgrade-to-3.4</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Communnity</orgname>
+  <uri>http://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-upgrade-to-3.4">
+
+  <refmeta>
+    <refentrytitle>koha-upgrade-to-3.4</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-upgrade-to-3.4</refname>
+    <refpurpose>Performs the necessary changes to upgrade a Koha system from 3.2 to 3.4. If no instance names are provided, this will run it on all of them.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-upgrade-to-3.4</command> <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Description</title>
+  <para>Performs the necessary changes to upgrade a Koha system from 3.2 to 3.4. If no instance names are provided, this will run it on all of them.</para>
+  </refsect1>
+  
+  <refsect1><title>See also</title>
+  <simplelist type="inline">
+  </simplelist>
+  </refsect1>
+  
+</refentry>
+
+</article>
-- 
1.7.5.4


More information about the Patches mailing list