From 5036fffac66d9ceda7e6a2eeff51c7ed589d3d13 Mon Sep 17 00:00:00 2001
From: Tomas Cohen Arazi <tomascohen@theke.io>
Date: Tue, 2 Mar 2021 16:33:29 -0300
Subject: [PATCH] Bug 27839: (follow-up) Update docs for koha-worker

Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>

Signed-off-by: David Nind <david@davidnind.com>

Signed-off-by: Kyle M Hall <kyle@bywatersolutions.com>

Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>
(cherry picked from commit 65542edbe021d58ca6ef1332a8e3ca760b198391)
Signed-off-by: Fridolin Somers <fridolin.somers@biblibre.com>
---
 debian/docs/koha-worker.xml | 82 +++++++++++++++++++++++++++++++++++++
 debian/scripts/koha-worker  |  1 +
 2 files changed, 83 insertions(+)
 create mode 100644 debian/docs/koha-worker.xml

diff --git a/debian/docs/koha-worker.xml b/debian/docs/koha-worker.xml
new file mode 100644
index 0000000000..3cb19e63cf
--- /dev/null
+++ b/debian/docs/koha-worker.xml
@@ -0,0 +1,82 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-worker</title>
+<info>
+<productname>Koha</productname> is the first free software library automation package.
+<author>
+  <orgname>The Koha Community</orgname>
+  <uri>https://koha-community.org/</uri>
+</author>
+</info>
+
+<refentry xml:id="koha-worker">
+
+  <refmeta>
+    <refentrytitle>koha-worker</refentrytitle>
+    <manvolnum>8</manvolnum>
+  </refmeta>
+
+  <refnamediv>
+    <refname>koha-worker</refname>
+    <refpurpose>Handle worker daemon for named Koha instances.</refpurpose>
+    <refclass>UNIX/Linux</refclass>
+  </refnamediv>
+
+  <refsynopsisdiv>
+    <cmdsynopsis>
+      <command>koha-worker</command>
+      <arg><option>--start</option>|<option>--stop</option>|<option>--restart</option></arg>
+      <arg><option>--status</option></arg>
+      <arg><option>--quiet</option>|<option>-q</option></arg>
+      <arg><option>-h</option>|<option>--help</option></arg>
+    </cmdsynopsis>
+  </refsynopsisdiv>
+
+  <refsect1><title>Options</title>
+  <para>All option switches are mutually exclusive</para>
+  <variablelist>
+    <varlistentry>
+      <term><option>--start</option></term>
+      <listitem>
+        <para>Start worker daemon for named Koha instances.</para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term><option>--stop</option></term>
+      <listitem>
+        <para>Stop worker daemon for named Koha instances.</para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term><option>--restart</option></term>
+      <listitem>
+        <para>Restart worker daemon for named Koha instances.</para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term><option>--status</option></term>
+      <listitem>
+        <para>Show status information about worker daemon for named Koha instances.</para>
+      </listitem>
+    </varlistentry>
+    <varlistentry>
+      <term><option>-v</option>|<option>--verbose</option></term>
+      <listitem>
+        <para>Enable verbose output.</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 handles worker daemons for Koha instances.</para>
+  </refsect1>
+
+</refentry>
+
+</article>
diff --git a/debian/scripts/koha-worker b/debian/scripts/koha-worker
index b4df12859f..207d503b55 100755
--- a/debian/scripts/koha-worker
+++ b/debian/scripts/koha-worker
@@ -41,6 +41,7 @@ This script lets you manage the worker daemon for your Koha instances.
 
 Usage:
 $scriptname [--start|--stop|--restart] [--quiet|-q] instancename1 [instancename2...]
+$scriptname --status instancename1 [instancename2...]
 $scriptname -h|--help
 
     --start               Start the worker daemon for the specified instances
-- 
2.39.5