From eb902d7a92b2e435890cff78c9c118a2a8280fa7 Mon Sep 17 00:00:00 2001
From: Andreas Roussos <a.roussos@dataly.gr>
Date: Sun, 27 Aug 2023 23:42:49 +0000
Subject: [PATCH] Bug 31964: add a man page for koha-z3950-responder

The koha-z3950-responder command does not have a man page.

This patch fixes that.

Test plan:

1) Apply this patch.

2) Run the following command to generate the new man page:

   xsltproc /usr/share/xml/docbook/stylesheet/docbook-xsl-ns/manpages/docbook.xsl debian/docs/koha-z3950-responder.xml

3) View the generated man page with `man -l koha-z3950-responder.8`

   (KTD users may need to `apt-get install man-db` first as
   that package provides tools for reading manual pages)

4) Make sure this unit test passes:

   prove -v xt/verify-debian-docbook.t

Signed-off-by: Pedro Amorim <pedro.amorim@ptfs-europe.com>

Signed-off-by: Jonathan Druart <jonathan.druart@bugs.koha-community.org>
Signed-off-by: Tomas Cohen Arazi <tomascohen@theke.io>
---
 debian/docs/koha-z3950-responder.xml | 141 +++++++++++++++++++++++++++
 1 file changed, 141 insertions(+)
 create mode 100644 debian/docs/koha-z3950-responder.xml

diff --git a/debian/docs/koha-z3950-responder.xml b/debian/docs/koha-z3950-responder.xml
new file mode 100644
index 0000000000..b0ac2bae44
--- /dev/null
+++ b/debian/docs/koha-z3950-responder.xml
@@ -0,0 +1,141 @@
+<article xmlns='http://docbook.org/ns/docbook'>
+<title>koha-z3950-responder</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-z3950-responder">
+
+    <refmeta>
+        <refentrytitle>koha-z3950-responder</refentrytitle>
+        <manvolnum>8</manvolnum>
+    </refmeta>
+
+    <refnamediv>
+        <refname>koha-z3950-responder</refname>
+        <refpurpose>Manage the Z39.50/SRU daemons for your Koha instances</refpurpose>
+        <refclass>UNIX/Linux</refclass>
+    </refnamediv>
+
+    <refsynopsisdiv>
+        <cmdsynopsis>
+            <command>koha-z3950-responder</command>
+            <group choice="opt">
+                <arg choice="plain">--start</arg>
+                <arg choice="plain">--stop</arg>
+                <arg choice="plain">--restart</arg>
+            </group>
+            <group choice="opt">
+                <arg choice="plain">--enable</arg>
+                <arg choice="plain">--disable</arg>
+            </group>
+            <group choice="opt">
+                <arg choice="plain">--debugger</arg>
+                <arg choice="plain">--debugger-key <replaceable>key</replaceable></arg>
+                <arg choice="plain">--debugger-location <replaceable>host</replaceable>:<replaceable>port</replaceable></arg>
+                <arg choice="plain">--debugger-path <replaceable>path</replaceable></arg>
+            </group>
+            <group choice="opt">
+                <arg choice="plain">--quiet</arg>
+                <arg choice="plain">-q</arg>
+            </group>
+            <arg choice="req" rep="repeat"><replaceable>instancename</replaceable></arg>
+        </cmdsynopsis>
+        <cmdsynopsis>
+            <command>koha-z3950-responder</command>
+            <group choice="opt">
+                <arg choice="plain">--help</arg>
+                <arg choice="plain">-h</arg>
+            </group>
+        </cmdsynopsis>
+    </refsynopsisdiv>
+
+    <refsect1><title>Options</title>
+        <variablelist>
+            <varlistentry>
+                <term><option>--start</option></term>
+                <listitem>
+                    <para>Start the Z39.50/SRU daemon for the specified instance(s)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--stop</option></term>
+                <listitem>
+                    <para>Stop the Z39.50/SRU daemon for the specified instance(s)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--restart</option></term>
+                <listitem>
+                    <para>Restart the Z39.50/SRU daemon for the specified instance(s)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--enable</option></term>
+                <listitem>
+                    <para>Enable Z39.50/SRU for the specified instance(s)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--disable</option></term>
+                <listitem>
+                    <para>Disable Z39.50/SRU for the specified instance(s)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--debugger</option></term>
+                <listitem>
+                    <para>Enable running Z39.50/SRU in debug mode</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--debugger-key <replaceable>key</replaceable></option></term>
+                <listitem>
+                    <para>Specify the debugger key the IDE is expecting</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--debugger-location <replaceable>host</replaceable>:<replaceable>port</replaceable></option></term>
+                <listitem>
+                    <para>Specify the host:port for your debugger tool (defaults to localhost:9000)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--debugger-path <replaceable>path</replaceable></option></term>
+                <listitem>
+                    <para>Specify the path for the debugger library</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--quiet</option> | <option>-q</option></term>
+                <listitem>
+                    <para>Make the script quiet about non existent instance names (useful for calling from other scripts)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term><option>--help</option> | <option>-h</option></term>
+                <listitem>
+                    <para>Display help for this command</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsect1>
+
+    <refsect1><title>Description</title>
+        <para>This script lets you manage the Z39.50/SRU daemons for your Koha instances.</para>
+    </refsect1>
+
+    <refsect1><title>See also</title>
+        <simplelist type="inline">
+            <member><command>koha-rebuild-zebra(8)</command></member>
+            <member><command>koha-zebra(8)</command></member>
+        </simplelist>
+    </refsect1>
+
+</refentry>
+
+</article>
-- 
2.39.5