From: Tony Finch <fanf@isc.org>
Date: Thu, 10 Mar 2022 16:52:12 +0000 (+0000)
Subject: Regenerate the named.conf manual with hyperlinks
X-Git-Tag: v9.19.0~66^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=ad5b0402c9de3177b7da012aefff6a9df5536b14;p=thirdparty%2Fbind9.git

Regenerate the named.conf manual with hyperlinks

The named.conf grammar is exported to the manual via
doc/misc/rst-options.pl which is the ultimate source
for the non-grammar parts of the man page.
---

diff --git a/bin/named/named.conf.rst b/bin/named/named.conf.rst
index 3ce51e38ad9..6fc7d8175c0 100644
--- a/bin/named/named.conf.rst
+++ b/bin/named/named.conf.rst
@@ -24,10 +24,10 @@ Synopsis
 Description
 ~~~~~~~~~~~
 
-:iscman:`named.conf` is the configuration file for :iscman:`named`. Statements are
-enclosed in braces and terminated with a semi-colon. Clauses in the
-statements are also semi-colon terminated.  The usual comment styles are
-supported:
+:file:`named.conf` is the configuration file for :iscman:`named`.
+Statements are enclosed in braces and terminated with a semi-colon.
+Clauses in the statements are also semi-colon terminated. The usual
+comment styles are supported:
 
 C style: /\* \*/
 
diff --git a/doc/man/named.conf.5in b/doc/man/named.conf.5in
index 539346834e1..ec2c6b47f6d 100644
--- a/doc/man/named.conf.5in
+++ b/doc/man/named.conf.5in
@@ -35,10 +35,10 @@ named.conf \- configuration file for **named**
 \fBnamed.conf\fP
 .SH DESCRIPTION
 .sp
-\fI\%named.conf\fP is the configuration file for \fBnamed\fP\&. Statements are
-enclosed in braces and terminated with a semi\-colon. Clauses in the
-statements are also semi\-colon terminated.  The usual comment styles are
-supported:
+\fBnamed.conf\fP is the configuration file for \fBnamed\fP\&.
+Statements are enclosed in braces and terminated with a semi\-colon.
+Clauses in the statements are also semi\-colon terminated. The usual
+comment styles are supported:
 .sp
 C style: /* */
 .INDENT 0.0
diff --git a/doc/misc/rst-options.pl b/doc/misc/rst-options.pl
index 7526ea4f4c2..79a934dbcc5 100644
--- a/doc/misc/rst-options.pl
+++ b/doc/misc/rst-options.pl
@@ -43,6 +43,8 @@ END
 print <<END;
 .. highlight: console
 
+.. iscman:: named.conf
+
 named.conf - configuration file for **named**
 ---------------------------------------------
 
@@ -54,10 +56,10 @@ Synopsis
 Description
 ~~~~~~~~~~~
 
-``named.conf`` is the configuration file for ``named``. Statements are
-enclosed in braces and terminated with a semi-colon. Clauses in the
-statements are also semi-colon terminated.  The usual comment styles are
-supported:
+:file:`named.conf` is the configuration file for :iscman:`named`.
+Statements are enclosed in braces and terminated with a semi-colon.
+Clauses in the statements are also semi-colon terminated. The usual
+comment styles are supported:
 
 C style: /\\* \\*/
 
@@ -141,6 +143,6 @@ Files
 See Also
 ~~~~~~~~
 
-:manpage:`named(8)`, :manpage:`named-checkconf(8)`, :manpage:`rndc(8)`, :manpage:`rndc-confgen(8)`, :manpage:`tsig-keygen(8)`, BIND 9 Administrator Reference Manual.
+:iscman:`named(8) <named>`, :iscman:`named-checkconf(8) <named-checkconf>`, :iscman:`rndc(8) <rndc>`, :iscman:`rndc-confgen(8) <rndc-confgen>`, :iscman:`tsig-keygen(8) <tsig-keygen>`, BIND 9 Administrator Reference Manual.
 
 END