From: Rich Bowen Date: Tue, 14 Apr 2026 19:30:14 +0000 (+0000) Subject: Wrap module mentions in X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=cfeb2541f74aa137f1b4a17d0875e6ac86521672;p=thirdparty%2Fapache%2Fhttpd.git Wrap module mentions in git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1933062 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/rewrite/flags.xml b/docs/manual/rewrite/flags.xml index 714711b2aa..09347d5a68 100644 --- a/docs/manual/rewrite/flags.xml +++ b/docs/manual/rewrite/flags.xml @@ -71,7 +71,7 @@ of how you might use them.

module="mod_rewrite">RewriteRule to escape non-alphanumeric characters before applying the transformation.

-

mod_rewrite has to unescape URLs before mapping them, +

mod_rewrite has to unescape URLs before mapping them, so backreferences are unescaped at the time they are applied. Using the B flag, non-alphanumeric characters in backreferences will be escaped. For example, consider the rule:

@@ -257,7 +257,7 @@ RewriteRule "^/index\.html" "-" [CO=frontdoor:yes:.example.com:1440:/]

In the example give, the rule doesn't rewrite the request. -The "-" rewrite target tells mod_rewrite to pass the request +The "-" rewrite target tells mod_rewrite to pass the request through unchanged. Instead, it sets a cookie called 'frontdoor' to a value of 'yes'. The cookie is valid for any host in the .example.com domain. It is set to expire in 1440 @@ -274,12 +274,12 @@ compares against is the concatenation of the current values of the URI and PATH_INFO.

The current URI can be the initial URI as requested by the client, the -result of a previous round of mod_rewrite processing, or the result of -a prior rule in the current round of mod_rewrite processing.

+result of a previous round of mod_rewrite processing, or the result of +a prior rule in the current round of mod_rewrite processing.

In contrast, the PATH_INFO that is appended to the URI before each rule reflects only the value of PATH_INFO before this round of -mod_rewrite processing. As a consequence, if large portions +mod_rewrite processing. As a consequence, if large portions of the URI are matched and copied into a substitution in multiple RewriteRule directives, without regard for which parts of the URI came from the current PATH_INFO, the final @@ -288,8 +288,8 @@ URI may have multiple copies of PATH_INFO appended to it.

Use this flag on any substitution where the PATH_INFO that resulted from the previous mapping of this request to the filesystem is not of interest. This flag permanently forgets the PATH_INFO established -before this round of mod_rewrite processing began. PATH_INFO will -not be recalculated until the current round of mod_rewrite processing +before this round of mod_rewrite processing began. PATH_INFO will +not be recalculated until the current round of mod_rewrite processing completes. Subsequent rules during this round of processing will see only the direct result of substitutions, without any PATH_INFO appended.

@@ -865,11 +865,11 @@ invariably be a less efficient solution than the alternatives.

If used in per-directory context, use only - (dash) -as the substitution for the entire round of mod_rewrite processing, +as the substitution for the entire round of mod_rewrite processing, otherwise the MIME-type set with this flag is lost due to an internal -re-processing (including subsequent rounds of mod_rewrite processing). +re-processing (including subsequent rounds of mod_rewrite processing). The L flag can be useful in this context to end the -current round of mod_rewrite processing.

+current round of mod_rewrite processing.

UnsafeAllow3F