From: Rich Bowen <rbowen@apache.org>
Date: Mon, 11 May 2026 19:50:14 +0000 (+0000)
Subject: Rewrite guide: harmonize seealso blocks across all files
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=781cdcce4715e700c8f7899bde5d47882ee10599;p=thirdparty%2Fapache%2Fhttpd.git

Rewrite guide: harmonize seealso blocks across all files

Every document in the rewrite guide now cross-references all sibling
documents (htaccess, flags, tech, intro, remapping, rewritemap, vhosts,
avoid) consistently. Removed commented-out self-references.


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

diff --git a/docs/manual/rewrite/TODO.md b/docs/manual/rewrite/TODO.md
index d89fbec441..5ba3140a24 100644
--- a/docs/manual/rewrite/TODO.md
+++ b/docs/manual/rewrite/TODO.md
@@ -37,7 +37,7 @@ result in one file "owning" the content and others cross-referencing it.
 
 ## LOW Priority
 
-- [ ] **Harmonize `<seealso>` blocks** — htaccess.xml not consistently
+- [x] **Harmonize `<seealso>` blocks** — htaccess.xml not consistently
       listed in other files' seealso despite being a major topic.
 
 - [ ] **Deprecated stub files** (access.xml, advanced.xml, proxy.xml) —
diff --git a/docs/manual/rewrite/avoid.xml b/docs/manual/rewrite/avoid.xml
index f2ce351fb1..1b8c124e34 100644
--- a/docs/manual/rewrite/avoid.xml
+++ b/docs/manual/rewrite/avoid.xml
@@ -55,10 +55,11 @@ files to work with, you may need to resort to
 <seealso><a href="../mod/mod_rewrite.html">Module documentation</a></seealso>
 <seealso><a href="intro.html">mod_rewrite introduction</a></seealso>
 <seealso><a href="remapping.html">Redirection and remapping</a></seealso>
+<seealso><a href="htaccess.html">Per-directory Rewrites</a></seealso>
+<seealso><a href="flags.html">RewriteRule Flags</a></seealso>
 <seealso><a href="vhosts.html">Virtual hosts</a></seealso>
 <seealso><a href="rewritemap.html">Using RewriteMap</a></seealso>
-<!--<seealso><a href="htaccess.html">Per-directory Rewrites</a></seealso>
-<seealso><a href="avoid.html">When not to use mod_rewrite</a></seealso>-->
+<seealso><a href="tech.html">Technical details</a></seealso>
 
 <section id="redirect">
 <title>Simple Redirection</title>
diff --git a/docs/manual/rewrite/flags.xml b/docs/manual/rewrite/flags.xml
index f810d98dc0..1e586b8a1d 100644
--- a/docs/manual/rewrite/flags.xml
+++ b/docs/manual/rewrite/flags.xml
@@ -34,9 +34,11 @@ providing detailed explanations and examples.</p>
 <seealso><a href="../mod/mod_rewrite.html">Module documentation</a></seealso>
 <seealso><a href="intro.html">mod_rewrite introduction</a></seealso>
 <seealso><a href="remapping.html">Redirection and remapping</a></seealso>
+<seealso><a href="htaccess.html">Per-directory Rewrites</a></seealso>
 <seealso><a href="vhosts.html">Virtual hosts</a></seealso>
 <seealso><a href="rewritemap.html">Using RewriteMap</a></seealso>
 <seealso><a href="avoid.html">When not to use mod_rewrite</a></seealso>
+<seealso><a href="tech.html">Technical details</a></seealso>
 
 <section id="introduction"><title>Introduction</title>
 <p>A <directive module="mod_rewrite">RewriteRule</directive> can have
diff --git a/docs/manual/rewrite/intro.xml b/docs/manual/rewrite/intro.xml
index b2daa7dbc2..e35646b9a1 100644
--- a/docs/manual/rewrite/intro.xml
+++ b/docs/manual/rewrite/intro.xml
@@ -35,11 +35,13 @@ but this doc should help the beginner get their feet wet.
 </summary>
 
 <seealso><a href="../mod/mod_rewrite.html">Module documentation</a></seealso>
-<!-- <seealso><a href="intro.html">mod_rewrite introduction</a></seealso> -->
 <seealso><a href="remapping.html">Redirection and remapping</a></seealso>
+<seealso><a href="htaccess.html">Per-directory Rewrites</a></seealso>
+<seealso><a href="flags.html">RewriteRule Flags</a></seealso>
 <seealso><a href="vhosts.html">Virtual hosts</a></seealso>
 <seealso><a href="rewritemap.html">Using RewriteMap</a></seealso>
 <seealso><a href="avoid.html">When not to use mod_rewrite</a></seealso>
+<seealso><a href="tech.html">Technical details</a></seealso>
 
 <section id="introduction"><title>Introduction</title>
 <p>The Apache module <module>mod_rewrite</module> is a very powerful and
diff --git a/docs/manual/rewrite/remapping.xml b/docs/manual/rewrite/remapping.xml
index 42050a88c1..ba32436f4f 100644
--- a/docs/manual/rewrite/remapping.xml
+++ b/docs/manual/rewrite/remapping.xml
@@ -36,10 +36,12 @@ including detailed descriptions of how each works.</p>
 </summary>
 <seealso><a href="../mod/mod_rewrite.html">Module documentation</a></seealso>
 <seealso><a href="intro.html">mod_rewrite introduction</a></seealso>
-<!--<seealso><a href="remapping.html">Redirection and remapping</a></seealso>-->
+<seealso><a href="htaccess.html">Per-directory Rewrites</a></seealso>
+<seealso><a href="flags.html">RewriteRule Flags</a></seealso>
 <seealso><a href="vhosts.html">Virtual hosts</a></seealso>
 <seealso><a href="rewritemap.html">Using RewriteMap</a></seealso>
 <seealso><a href="avoid.html">When not to use mod_rewrite</a></seealso>
+<seealso><a href="tech.html">Technical details</a></seealso>
 
 <section id="old-to-new">
 
diff --git a/docs/manual/rewrite/rewritemap.xml b/docs/manual/rewrite/rewritemap.xml
index 8f5718cd7f..7b3193f671 100644
--- a/docs/manual/rewrite/rewritemap.xml
+++ b/docs/manual/rewrite/rewritemap.xml
@@ -33,9 +33,11 @@ and provides examples of each of the various <directive module="mod_rewrite"
   <seealso><a href="../mod/mod_rewrite.html">Module documentation</a></seealso>
   <seealso><a href="intro.html">mod_rewrite introduction</a></seealso>
   <seealso><a href="remapping.html">Redirection and remapping</a></seealso>
+  <seealso><a href="flags.html">RewriteRule Flags</a></seealso>
     <seealso><a href="vhosts.html">Virtual hosts</a></seealso>
       <seealso><a href="htaccess.html">Per-directory Rewrites</a></seealso>
 <seealso><a href="avoid.html">When not to use mod_rewrite</a></seealso>
+<seealso><a href="tech.html">Technical details</a></seealso>
 
   <section id="introduction">
     <title>Introduction</title>
diff --git a/docs/manual/rewrite/tech.xml b/docs/manual/rewrite/tech.xml
index da65017271..275a98d965 100644
--- a/docs/manual/rewrite/tech.xml
+++ b/docs/manual/rewrite/tech.xml
@@ -32,6 +32,7 @@ and URL matching.</p>
 <seealso><a href="../mod/mod_rewrite.html">Module documentation</a></seealso>
 <seealso><a href="intro.html">mod_rewrite introduction</a></seealso>
 <seealso><a href="remapping.html">Redirection and remapping</a></seealso>
+<seealso><a href="flags.html">RewriteRule Flags</a></seealso>
 <seealso><a href="vhosts.html">Virtual hosts</a></seealso>
 <seealso><a href="rewritemap.html">Using RewriteMap</a></seealso>
 <seealso><a href="htaccess.html">Per-directory Rewrites</a></seealso>
diff --git a/docs/manual/rewrite/vhosts.xml b/docs/manual/rewrite/vhosts.xml
index 0ff8a063b1..a270d264ab 100644
--- a/docs/manual/rewrite/vhosts.xml
+++ b/docs/manual/rewrite/vhosts.xml
@@ -42,10 +42,11 @@ mod_rewrite</a> document.</note>
 <seealso><a href="../mod/mod_rewrite.html">Module documentation</a></seealso>
 <seealso><a href="intro.html">mod_rewrite introduction</a></seealso>
 <seealso><a href="remapping.html">Redirection and remapping</a></seealso>
-<!--<seealso><a href="vhosts.html">Virtual hosts</a></seealso>-->
-<seealso><a href="rewritemap.html">RewriteMap</a></seealso>
 <seealso><a href="htaccess.html">Per-directory Rewrites</a></seealso>
+<seealso><a href="flags.html">RewriteRule Flags</a></seealso>
+<seealso><a href="rewritemap.html">RewriteMap</a></seealso>
 <seealso><a href="avoid.html">When not to use mod_rewrite</a></seealso>
+<seealso><a href="tech.html">Technical details</a></seealso>
 
 <section id="per-hostname">