From: Rich Bowen <rbowen@apache.org>
Date: Wed, 29 Apr 2026 15:21:03 +0000 (+0000)
Subject: docs: Add <rfc> tag for RFC links — renders to www.rfc-editor.org URLs on build
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=59e8f794bfd6de8293d3c1aea05b28f614e81787;p=thirdparty%2Fapache%2Fhttpd.git

docs: Add <rfc> tag for RFC links — renders to www.rfc-editor.org URLs on build

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1933500 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/style/common.dtd b/docs/manual/style/common.dtd
index 8402f9e36e..08ead9d3c0 100644
--- a/docs/manual/style/common.dtd
+++ b/docs/manual/style/common.dtd
@@ -42,7 +42,7 @@
 <!-- Generic tag entities -->
 
 <!ENTITY % inlinetags "em | strong | code | a | br | directive | module |
-program | img | cite | q | dfn | var | transnote | glossary | phonetic | since">
+program | img | cite | q | dfn | var | transnote | glossary | phonetic | since | rfc">
 
 <!ENTITY % blocktags "p | example | note | table | ul | ol | dl | pre | 
 highlight | blockquote">
@@ -201,3 +201,9 @@ highlight | blockquote">
      describes a pronunciation -->
 <!ELEMENT phonetic (#PCDATA)>
 
+<!-- The rfc element creates a link to an RFC at www.rfc-editor.org.
+     Content is the RFC number (e.g. 7230). Optional section attribute
+     adds a fragment anchor (e.g. section="14.24"). -->
+<!ELEMENT rfc (#PCDATA)>
+<!ATTLIST rfc section CDATA #IMPLIED>
+
diff --git a/docs/manual/style/xsl/common.xsl b/docs/manual/style/xsl/common.xsl
index 718f2b3e8e..29af2f8057 100644
--- a/docs/manual/style/xsl/common.xsl
+++ b/docs/manual/style/xsl/common.xsl
@@ -1222,6 +1222,26 @@ if (typeof(prettyPrint) !== 'undefined') {
 <!-- /glossary -->
 
 <!-- ==================================================================== -->
+<!-- link to an RFC at www.rfc-editor.org                                 -->
+<!-- ==================================================================== -->
+<xsl:template match="rfc">
+  <xsl:variable name="rfcnum">
+    <xsl:value-of select="normalize-space(.)"/>
+  </xsl:variable>
+
+  <xsl:variable name="rfcurl">
+    <xsl:text>https://www.rfc-editor.org/rfc/rfc</xsl:text>
+    <xsl:value-of select="$rfcnum"/>
+    <xsl:if test="@section">
+      <xsl:text>#section-</xsl:text>
+      <xsl:value-of select="@section"/>
+    </xsl:if>
+  </xsl:variable>
+
+  <a href="{$rfcurl}">RFC <xsl:value-of select="$rfcnum"/></a>
+</xsl:template>
+<!-- /rfc -->
+
 <!-- Filter &#160; in text() nodes.                                       -->
 <!-- In some environments this character won't be transformed correctly,  -->
 <!-- so we just write it explicitly as "&nbsp;" into the output.         -->
diff --git a/docs/manual/style/xsl/nroff.xsl b/docs/manual/style/xsl/nroff.xsl
index 4c68ce8a5e..de3a3ccdc8 100644
--- a/docs/manual/style/xsl/nroff.xsl
+++ b/docs/manual/style/xsl/nroff.xsl
@@ -373,7 +373,7 @@ FATAL: only tables with two (2) columns are supported.
 <!-- ==================================================================== -->
 <!-- pass through content                                                 -->
 <!-- ==================================================================== -->
-<xsl:template match="a|module|table|program|glossary|highlight">
+<xsl:template match="a|module|table|program|glossary|highlight|rfc">
 <xsl:apply-templates />
 </xsl:template>