From: Rich Bowen Date: Fri, 15 May 2026 19:31:59 +0000 (+0000) Subject: Add PATH_INFO glossary entry, link first mention in each doc X-Git-Url: http://git.ipfire.org/gitweb/index.cgi?a=commitdiff_plain;h=790bc3c25967a202ed331c60b6329609cd89307a;p=thirdparty%2Fapache%2Fhttpd.git Add PATH_INFO glossary entry, link first mention in each doc Define PATH_INFO in glossary.xml with an example (/app/index.php/extra/path), reference to AcceptPathInfo directive, and RFC 3875 section 4.1.5 citation. Convert the first prose mention of PATH_INFO in 14 files to links. Subsequent mentions within the same document are left as or plain text to avoid link spam. Skipped mod_ext_filter.xml (only occurrence is inside the compound variable name DOCUMENT_PATH_INFO) and mod_ssl.xml (inside a 
block where markup links are inappropriate).

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

diff --git a/docs/manual/env.xml b/docs/manual/env.xml
index fef7930fac..2e27b4ef37 100644
--- a/docs/manual/env.xml
+++ b/docs/manual/env.xml
@@ -320,7 +320,7 @@
     

         PATH_INFO
 
-        
The variable PATH_INFO is set to
+        
The variable PATH_INFO is set to
         the any value that appears after a matches resource
         at the end of the URL, not including any
         QUERY_STRING. This is best shown by
diff --git a/docs/manual/expr.xml b/docs/manual/expr.xml
index 0479098542..6563864ec6 100644
--- a/docs/manual/expr.xml
+++ b/docs/manual/expr.xml
@@ -261,7 +261,7 @@ DIGIT       ::= <any US-ASCII digit "0".."9">
         The user name of the owner of the script.
     SCRIPT_GROUP
         The group name of the group of the script.
-    PATH_INFO
+    PATH_INFO
         The trailing path name information, see
             AcceptPathInfo
     QUERY_STRING
diff --git a/docs/manual/glossary.xml b/docs/manual/glossary.xml
index 61d9912415..3d6eb4b699 100644
--- a/docs/manual/glossary.xml
+++ b/docs/manual/glossary.xml
@@ -346,6 +346,18 @@
       See: Configuration Sections
     
 
+    
PATH_INFO

+    
The trailing path information that follows the actual filename
+      in a URL. For example, if /app/index.php/extra/path
+      maps to the file /app/index.php, then the PATH_INFO
+      is /extra/path. It is passed to CGI scripts, PHP,
+      and other handlers as additional context about the request. The
+      AcceptPathInfo directive controls
+      whether requests with trailing path information are accepted or
+      rejected.

+      See: 3875
+    

+
     
Plaintext

     
The unencrypted text.

 
diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index 139da820f9..6faec1dfbf 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -137,7 +137,7 @@ AcceptFilter https connect
     pathname information that follows an actual filename (or
     non-existent file in an existing directory) will be accepted or
     rejected.  The trailing pathname information can be made
-    available to scripts in the PATH_INFO environment
+    available to scripts in the PATH_INFO environment
     variable.

 
     
For example, assume the location /test/ points to
diff --git a/docs/manual/mod/mod_actions.xml b/docs/manual/mod/mod_actions.xml
index d9a9457ca3..7bf2ae7296 100644
--- a/docs/manual/mod/mod_actions.xml
+++ b/docs/manual/mod/mod_actions.xml
@@ -66,7 +66,7 @@ content-type
     href="../handler.html">handler or a MIME content type. It sends the URL and
     file path of the requested document using the standard CGI
-    PATH_INFO and PATH_TRANSLATED
+    PATH_INFO and PATH_TRANSLATED
     environment variables. The handler used for the particular request
     is passed using the REDIRECT_HANDLER variable.

 
diff --git a/docs/manual/mod/mod_cgi.xml b/docs/manual/mod/mod_cgi.xml
index 1eb6add1b1..9c3b8d5c90 100644
--- a/docs/manual/mod/mod_cgi.xml
+++ b/docs/manual/mod/mod_cgi.xml
@@ -66,7 +66,7 @@
     with the following provisions:

 
     

-      
PATH_INFO

+      
PATH_INFO

 
       
This will not be available if the AcceptPathInfo directive is explicitly set to
diff --git a/docs/manual/mod/mod_include.xml b/docs/manual/mod/mod_include.xml
index f6ef79537f..09f526653a 100644
--- a/docs/manual/mod/mod_include.xml
+++ b/docs/manual/mod/mod_include.xml
@@ -83,7 +83,7 @@ Options +Includes
     PATH_INFO with Server Side Includes
 
     
Files processed for server-side includes no longer accept
-    requests with PATH_INFO (trailing pathname information)
+    requests with PATH_INFO (trailing pathname information)
     by default.  You can use the AcceptPathInfo directive to
     configure the server to accept requests with PATH_INFO.

diff --git a/docs/manual/mod/mod_lua.xml b/docs/manual/mod/mod_lua.xml
index 67b2764857..aecbca3ed9 100644
--- a/docs/manual/mod/mod_lua.xml
+++ b/docs/manual/mod/mod_lua.xml
@@ -526,7 +526,7 @@ end
           path_info
           string
           no
-          The PATH_INFO extracted from this request.
+          The PATH_INFO extracted from this request.
         
         
           port
diff --git a/docs/manual/mod/mod_proxy.xml b/docs/manual/mod/mod_proxy.xml
index 1f51a2c894..058331922e 100644
--- a/docs/manual/mod/mod_proxy.xml
+++ b/docs/manual/mod/mod_proxy.xml
@@ -1515,7 +1515,7 @@ ProxyPass "/" "balancer://hotcluster/"
 
     
Normally, mod_proxy will canonicalise ProxyPassed URLs.
     But this may be incompatible with some backends, particularly those
-    that make use of PATH_INFO.  The optional nocanon
+    that make use of PATH_INFO.  The optional nocanon
     keyword suppresses this and passes the URL path "raw" to the
     backend.  Note that this keyword may affect the security of your backend,
     as it removes the normal limited protection against URL-based attacks
diff --git a/docs/manual/mod/mod_proxy_fcgi.xml b/docs/manual/mod/mod_proxy_fcgi.xml
index 0d4010cc04..644f40329a 100644
--- a/docs/manual/mod/mod_proxy_fcgi.xml
+++ b/docs/manual/mod/mod_proxy_fcgi.xml
@@ -173,7 +173,7 @@ ProxyPass "/myapp/" "balancer://myappcluster/"
        allows the normal mapping of URI to filename to occur in the server, and the
        local filesystem result is passed to the backend.  When FastCGI is
        configured this way, the server can calculate the most accurate
-       PATH_INFO.
+       PATH_INFO.
       

     Proxy via Handler
       
diff --git a/docs/manual/mod/mod_proxy_scgi.xml b/docs/manual/mod/mod_proxy_scgi.xml
index b24a01feb4..eb8918c78e 100644
--- a/docs/manual/mod/mod_proxy_scgi.xml
+++ b/docs/manual/mod/mod_proxy_scgi.xml
@@ -84,7 +84,7 @@ ProxyPass "/scgi-bin/" "balancer://somecluster/"
     

         
proxy-scgi-pathinfo

         
By default mod_proxy_scgi will neither create
-        nor export the PATH_INFO environment variable. This allows
+        nor export the PATH_INFO environment variable. This allows
         the backend SCGI server to correctly determine SCRIPT_NAME
         and Script-URI and be compliant with RFC 3875 section 3.3.
         If instead you need mod_proxy_scgi to generate
diff --git a/docs/manual/mod/mod_rewrite.xml b/docs/manual/mod/mod_rewrite.xml
index 339483571b..35f34160ce 100644
--- a/docs/manual/mod/mod_rewrite.xml
+++ b/docs/manual/mod/mod_rewrite.xml
@@ -526,7 +526,7 @@ RewriteRule "^/ex/(.*)" "${examplemap:$1}"
                  CONTEXT_PREFIX

                  CONTEXT_DOCUMENT_ROOT

                  IPV6

-                 PATH_INFO

+                 PATH_INFO

                  QUERY_STRING

                  REMOTE_ADDR

                  REMOTE_HOST

diff --git a/docs/manual/rewrite/flags.xml b/docs/manual/rewrite/flags.xml
index b952503420..45ff22c9d7 100644
--- a/docs/manual/rewrite/flags.xml
+++ b/docs/manual/rewrite/flags.xml
@@ -284,7 +284,7 @@ minutes (24 hours) and is returned for all URIs.

 

 
 
DPI|discardpath
-
The DPI flag causes the PATH_INFO portion of the rewritten URL-path to be
+
The DPI flag causes the PATH_INFO portion of the rewritten URL-path to be
 discarded.

 
 
In per-directory context,
diff --git a/docs/manual/rewrite/remapping.xml b/docs/manual/rewrite/remapping.xml
index 9bd698cb22..c9c7694c04 100644
--- a/docs/manual/rewrite/remapping.xml
+++ b/docs/manual/rewrite/remapping.xml
@@ -701,7 +701,7 @@ RewriteRule "(.*)"            "-" [F]
   
 
   
  • This solution shows the reverse of the previous ones, copying
-      path components (perhaps PATH_INFO) from the URL into the query string.
+      path components (perhaps PATH_INFO) from the URL into the query string.
 
 # The desired URL might be /products/kitchen-sink, and the script expects
 # /path?products=kitchen-sink.
diff --git a/docs/manual/upgrading.xml b/docs/manual/upgrading.xml
index 07d3a9f6a1..64fb7a819b 100644
--- a/docs/manual/upgrading.xml
+++ b/docs/manual/upgrading.xml
@@ -454,7 +454,7 @@ Require ip 127.0.0.1
         
    • 
 
         
  • mod_proxy_scgi: The default setting for
-        PATH_INFO has changed from httpd 2.2, and
+        PATH_INFO has changed from httpd 2.2, and
         some web applications will no longer operate properly with
         the new PATH_INFO setting.  The previous setting
         can be restored by configuring the proxy-scgi-pathinfo