DO NOT REPLY [Bug 53153] New: Rewrite documentation unclear or wrong about what is matched (file-path)

[bu...@apache.org]

https://issues.apache.org/bugzilla/show_bug.cgi?id=53153

             Bug #: 53153
           Summary: Rewrite documentation unclear or wrong about what is
                    matched (file-path)
           Product: Apache httpd-2
           Version: 2.5-HEAD
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Documentation
        AssignedTo: docs@httpd.apache.org
        ReportedBy: chealer@gmail.com
    Classification: Unclassified


http://httpd.apache.org/docs/trunk/en/mod/mod_rewrite.html#rewriterule says:

Pattern is a perl compatible regular expression. On the first RewriteRule, it
is matched against the (%-decoded) URL-path (or file-path, depending on the
context) of the request.

I think the second parenthesis is wrong, or at least unclear. To put it simply:
What is the file-path of a request?

file-path is defined as:
The path to a file in the local file-system beginning with the root directory
as in /usr/local/apache/htdocs/path/to/file.html. Unless otherwise specified, a
file-path which does not begin with a slash will be treated as relative to the
ServerRoot.

Just below the problematic sentence, a box expands on what is matched:
In Directory and htaccess context, the Pattern will initially be matched
against the filesystem path, after removing the prefix that led the server to
the current RewriteRule (e.g. "app1/index.html" or "index.html" depending on
where the directives are defined).

I find this less bad, although one may ask *which* filesystem path this refers
to.

The parenthesis was added recently (see #52000 for background).

-- 
Configure bugmail: https://issues.apache.org/bugzilla/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the assignee for the bug.

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org