svn commit: r1934603 - httpd/httpd/trunk/docs/manual/rewrite

Author: rbowen
Date: Mon May 25 17:21:11 2026
New Revision: 1934603

Log:
docs: Clarify DPI flag wording re: PATH_INFO vs URL-path

The opening sentence of the DPI|discardpath section implied PATH_INFO
was a "portion of" the URL-path/URI, while the next sentence described
it as a separate value concatenated to the URL-path/URI. Reword to
make clear that PATH_INFO is appended, not an inherent component.

Also add glossary links for URL-path (trunk only).

bz#70052

Modified:
   httpd/httpd/trunk/docs/manual/rewrite/flags.xml

Modified: httpd/httpd/trunk/docs/manual/rewrite/flags.xml
==============================================================================
--- httpd/httpd/trunk/docs/manual/rewrite/flags.xml	Mon May 25 17:02:14 2026	(r1934602)
+++ httpd/httpd/trunk/docs/manual/rewrite/flags.xml	Mon May 25 17:21:11 2026	(r1934603)
@@ -284,12 +284,14 @@ minutes (24 hours) and is returned for a
 </section>
 
 <section id="flag_dpi"><title>DPI|discardpath</title>
-<p>The DPI flag causes the <glossary ref="pathinfo">PATH_INFO</glossary> portion of the rewritten URL-path to be
-discarded.</p>
+<p>The DPI flag causes the <glossary ref="pathinfo">PATH_INFO</glossary>
+that was appended to the rewritten
+<glossary ref="urlpath">URL-path</glossary> to be discarded.</p>
 
-<p>In <glossary ref="perdirectory">per-directory context</glossary>,
-the URL-path each <directive>RewriteRule</directive> compares against
-is the concatenation of the current URL-path and PATH_INFO.</p>
+<p>In <glossary ref="perdirectory">per-directory context</glossary>, the
+<glossary ref="urlpath">URL-path</glossary> each
+<directive>RewriteRule</directive> compares against is the concatenation
+of the current URL-path and PATH_INFO.</p>
 
 <p>The current URL-path can be the initial path as requested by the
 client, the result of a previous round of <module>mod_rewrite</module>