[Bug 70017] New: RewriteRule Directive: "possible substitution combinations" unclear

https://bz.apache.org/bugzilla/show_bug.cgi?id=70017

            Bug ID: 70017
           Summary: RewriteRule Directive: "possible substitution
                    combinations" unclear
           Product: Apache httpd-2
           Version: 2.5-HEAD
          Hardware: All
               URL: https://httpd.apache.org/docs/trunk/en/mod/mod_rewrite
                    .html#rewriterule
                OS: All
            Status: NEW
          Severity: trivial
          Priority: P5
         Component: Documentation
          Assignee: [email protected]
          Reporter: [email protected]
  Target Milestone: ---

The documentation of the RewriteRule directive contains:
> Here are all possible substitution combinations and their meanings:

That is followed by 2 tables listing such combinations.

It is unclear what the elements of a combination are. I am far from mastering
rewriting, and am even less sure about how that document and the one specific
to flags should be divided, but I would suggest something like:
> A rewrite rule cannot use both proxy and redirect, and some forms of substitutions are only valid in certain contexts with certain sets of flags. Here are all possible combinations of substitution forms and these 2 flags and their meanings in the following contexts:

I would also recommend:
1. Changing "Inside per-server configuration" to "Outside per-directory
configuration" or "Inside server-wide configuration" (since per-directory
configuration can be in httpd.conf).
2. Replacing the 2 columns currently in each table with the following columns:
  1. Substitution (for example, otherpath$1)
  2. Substitution form (for example, URL-path)
  3. Flags (for example, [R])
  4. Effect

🅭🄍: https://www.philippecloutier.com/Common+infrastructure+licensing#its

-- 
You are receiving this mail because:
You are the assignee for the bug.