From c74f197368753006753d55280d9feec8d4e36895 Mon Sep 17 00:00:00 2001
From: "Roger A. Light" <roger@atchoo.org>
Date: Fri, 16 Jan 2026 13:32:33 +0000
Subject: [PATCH] man pages: Add 'See Also' mosquitto(7) to all pages

---
 man/libmosquitto.3.xml          | 11 +++++++++++
 man/mosquitto-tls.7.xml         |  6 ++++++
 man/mosquitto.7.xml             |  6 +++++-
 man/mosquitto.8.xml             |  6 ++++++
 man/mosquitto.conf.5.xml        |  6 ++++++
 man/mosquitto_ctrl.1.xml        |  6 ++++++
 man/mosquitto_ctrl_dynsec.1.xml |  6 ++++++
 man/mosquitto_ctrl_shell.1.xml  |  6 ++++++
 man/mosquitto_passwd.1.xml      |  6 ++++++
 man/mosquitto_pub.1.xml         |  6 ++++++
 man/mosquitto_rr.1.xml          |  6 ++++++
 man/mosquitto_signal.1.xml      |  6 ++++++
 man/mosquitto_sub.1.xml         |  6 ++++++
 man/mqtt.7.xml                  |  6 ++++++
 14 files changed, 88 insertions(+), 1 deletion(-)

diff --git a/man/libmosquitto.3.xml b/man/libmosquitto.3.xml
index 3f0ed27e..0fd6dab2 100644
--- a/man/libmosquitto.3.xml
+++ b/man/libmosquitto.3.xml
@@ -19,6 +19,17 @@
 		<para>See <ulink url="https://mosquitto.org/api/"/></para>
 	</refsect1>
 
+	<refsect1>
+		<title>See Also</title>
+		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
+		</simplelist>
+	</refsect1>
 	<refsect1>
 		<title>Author</title>
 		<para>Roger Light <email>roger@atchoo.org</email></para>
diff --git a/man/mosquitto-tls.7.xml b/man/mosquitto-tls.7.xml
index 7f9dea1d..205314cd 100644
--- a/man/mosquitto-tls.7.xml
+++ b/man/mosquitto-tls.7.xml
@@ -88,6 +88,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mosquitto-8.html">mosquitto</link></refentrytitle>
diff --git a/man/mosquitto.7.xml b/man/mosquitto.7.xml
index 9a1dcdbd..13f55775 100644
--- a/man/mosquitto.7.xml
+++ b/man/mosquitto.7.xml
@@ -20,7 +20,7 @@
 			The mosquitto project contains MQTT related programs, and comprises
 			the mosquitto broker and applications, command line clients, and a
 			client library for implementing custom MQTT clients. A brief description
-			of some MQTT features is available at 
+			of some MQTT features is available at
 			<citerefentry><refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle><manvolnum>7</manvolnum></citerefentry>.
 		</para>
 
@@ -77,6 +77,10 @@
 				with the Dynamic Security module described in
 				<citerefentry><refentrytitle><link xlink:href="mosquitto_ctrl_dynsec-1.html">mosquitto_ctrl_dynsec</link></refentrytitle><manvolnum>1</manvolnum></citerefentry>.
 			</para>
+			<para>
+				The interactive shell mode is described in
+				<citerefentry><refentrytitle><link xlink:href="mosquitto_ctrl_shell-1.html">mosquitto_ctrl_shell</link></refentrytitle><manvolnum>1</manvolnum></citerefentry>.
+			</para>
 		</refsect2>
 
 		<refsect2>
diff --git a/man/mosquitto.8.xml b/man/mosquitto.8.xml
index 50790f32..138e54a5 100644
--- a/man/mosquitto.8.xml
+++ b/man/mosquitto.8.xml
@@ -1004,6 +1004,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle>
diff --git a/man/mosquitto.conf.5.xml b/man/mosquitto.conf.5.xml
index de7b4d98..35423406 100644
--- a/man/mosquitto.conf.5.xml
+++ b/man/mosquitto.conf.5.xml
@@ -2780,6 +2780,12 @@ topic clients/total in 0 test/mosquitto/org/ $SYS/broker/
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mosquitto-8.html">mosquitto</link></refentrytitle>
diff --git a/man/mosquitto_ctrl.1.xml b/man/mosquitto_ctrl.1.xml
index a3be4827..108c8bfc 100644
--- a/man/mosquitto_ctrl.1.xml
+++ b/man/mosquitto_ctrl.1.xml
@@ -272,6 +272,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle>
diff --git a/man/mosquitto_ctrl_dynsec.1.xml b/man/mosquitto_ctrl_dynsec.1.xml
index 172714ac..580fa87e 100644
--- a/man/mosquitto_ctrl_dynsec.1.xml
+++ b/man/mosquitto_ctrl_dynsec.1.xml
@@ -53,6 +53,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle>
diff --git a/man/mosquitto_ctrl_shell.1.xml b/man/mosquitto_ctrl_shell.1.xml
index f373071f..ec6a53ce 100644
--- a/man/mosquitto_ctrl_shell.1.xml
+++ b/man/mosquitto_ctrl_shell.1.xml
@@ -281,6 +281,12 @@ OK</programlisting>
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle>
diff --git a/man/mosquitto_passwd.1.xml b/man/mosquitto_passwd.1.xml
index 39f912c8..9b4c6170 100644
--- a/man/mosquitto_passwd.1.xml
+++ b/man/mosquitto_passwd.1.xml
@@ -184,6 +184,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mosquitto-8.html">mosquitto</link></refentrytitle>
diff --git a/man/mosquitto_pub.1.xml b/man/mosquitto_pub.1.xml
index 190a5b44..782abd46 100644
--- a/man/mosquitto_pub.1.xml
+++ b/man/mosquitto_pub.1.xml
@@ -354,6 +354,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle>
diff --git a/man/mosquitto_rr.1.xml b/man/mosquitto_rr.1.xml
index 9bd8afb3..c702eb6c 100644
--- a/man/mosquitto_rr.1.xml
+++ b/man/mosquitto_rr.1.xml
@@ -312,6 +312,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle>
diff --git a/man/mosquitto_signal.1.xml b/man/mosquitto_signal.1.xml
index 9016e341..c5089272 100644
--- a/man/mosquitto_signal.1.xml
+++ b/man/mosquitto_signal.1.xml
@@ -167,6 +167,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mosquitto-8.html">mosquitto</link></refentrytitle>
diff --git a/man/mosquitto_sub.1.xml b/man/mosquitto_sub.1.xml
index 28391d3a..5babcc67 100644
--- a/man/mosquitto_sub.1.xml
+++ b/man/mosquitto_sub.1.xml
@@ -536,6 +536,12 @@ mosquitto_sub -t 'bbc/#' -T bbc/bbc1 --remove-retained</programlisting>
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mqtt-7.html">mqtt</link></refentrytitle>
diff --git a/man/mqtt.7.xml b/man/mqtt.7.xml
index 1464bc6a..b2513041 100644
--- a/man/mqtt.7.xml
+++ b/man/mqtt.7.xml
@@ -187,6 +187,12 @@
 	<refsect1>
 		<title>See Also</title>
 		<simplelist type="inline">
+			<member>
+				<citerefentry>
+					<refentrytitle><link xlink:href="mosquitto-7.html">mosquitto</link></refentrytitle>
+					<manvolnum>7</manvolnum>
+				</citerefentry>
+			</member>
 			<member>
 				<citerefentry>
 					<refentrytitle><link xlink:href="mosquitto-8.html">mosquitto</link></refentrytitle>