Turn reference into link and format curly brackets

Also, adjust outdated anchor name to new section title.
halfgaar · May 10, 2024 · 962c4d9 · 962c4d9
1 parent abb708e
commit 962c4d9
Show file tree

Hide file tree

Showing 3 changed files with 8 additions and 6 deletions.
diff --git a/man/flashmq.conf.5 b/man/flashmq.conf.5
@@ -18,7 +18,9 @@ To set a parameter, its name must appear on a single line, followed by whitespac
 .PP
 When setting boolean values, \*(T<yes/no\*(T>, \*(T<true/false\*(T> and \*(T<on/off\*(T> can all be used.
 .PP
-To configure the listeners, use \*(T<\fBlisten\fR\*(T> blocks, defined by { and }. See EXAMPLE LISTENERS for details.
+To configure the listeners, use \*(T<\fBlisten\fR\*(T> blocks, defined by \*(T<{\*(T> and \*(T<}\*(T>. See 
+.URL #example_listeners "EXAMPLE LISTENERS"
+for details.
 .PP
 Lines beginning with the hash character (\(lq\*(T<#\*(T>\(rq) and empty lines are ignored. Thus, a line can be commented out by prepending a \(lq\*(T<#\*(T>\(rq to it.
 .SH "GLOBAL PARAMETERS"

diff --git a/man/flashmq.conf.5.dbk5 b/man/flashmq.conf.5.dbk5
@@ -34,7 +34,7 @@
       When setting boolean values, <literal>yes/no</literal>, <literal>true/false</literal> and <literal>on/off</literal> can all be used.
     </para>
     <para>
-      To configure the listeners, use <option>listen</option> blocks, defined by { and }. See EXAMPLE LISTENERS for details.
+      To configure the listeners, use <option>listen</option> blocks, defined by <literal>{</literal> and <literal>}</literal>. See <link xlink:href="#example_listeners">EXAMPLE LISTENERS</link> for details.
     </para>
     <para>
       Lines beginning with the hash character (“<literal>#</literal>”) and empty lines are ignored. Thus, a line can be commented out by prepending a “<literal>#</literal>” to it.
@@ -759,7 +759,7 @@
     </variablelist>
   </refsect1>
 
-  <refsect1 xml:id="example_config">
+  <refsect1 xml:id="example_listeners">
     <title>Example listeners</title>
 
     <literallayout class="monospaced"><![CDATA[listen {

diff --git a/man/flashmq.conf.5.html b/man/flashmq.conf.5.html
@@ -91,7 +91,7 @@
       When setting boolean values, <code class="literal">yes/no</code>, <code class="literal">true/false</code> and <code class="literal">on/off</code> can all be used.
     </p>
     <p>
-      To configure the listeners, use <code class="option">listen</code> blocks, defined by { and }. See EXAMPLE LISTENERS for details.
+      To configure the listeners, use <code class="option">listen</code> blocks, defined by <code class="literal">{</code> and <code class="literal">}</code>. See <a href="#example_listeners">EXAMPLE LISTENERS</a> for details.
     </p>
     <p>
       Lines beginning with the hash character (“<code class="literal">#</code>”) and empty lines are ignored. Thus, a line can be commented out by prepending a “<code class="literal">#</code>” to it.
@@ -810,8 +810,8 @@
         </dd>
 
     </dl>
-  </section><section class="refsect1" id="example_config">
-    <header><h2>Example listeners<a class="hash-anchor" href="#example_config">#</a></h2></header>
+  </section><section class="refsect1" id="example_listeners">
+    <header><h2>Example listeners<a class="hash-anchor" href="#example_listeners">#</a></h2></header>
 
     <pre class="literallayout monospaced">listen {
   protocol mqtt