You are viewing a plain text version of this content. The canonical link for it is here.
Posted to docs@httpd.apache.org by bu...@apache.org on 2026/05/15 00:51:30 UTC
[Bug 70043] New: RewriteRule Flags: DPI|discardpath confusing about URI
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
Bug ID: 70043
Summary: RewriteRule Flags: DPI|discardpath confusing about URI
Product: Apache httpd-2
Version: 2.5-HEAD
Hardware: All
URL: https://httpd.apache.org/docs/current/en/rewrite/flags
.html#flag_dpi
OS: All
Status: UNCONFIRMED
Severity: minor
Priority: P4
Component: Documentation
Assignee: docs@httpd.apache.org
Reporter: chealer@gmail.com
Target Milestone: ---
The DPI|discardpath section of the RewriteRule Flags page contains:
> The DPI flag causes the PATH_INFO portion of the rewritten URI to be discarded.
> In per-directory context, the URI each RewriteRule 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.
>
I have some understanding of what the flag does, but I struggle to achieve even
a moderate understanding of that section. I assume at least the first 2
occurrences of "URI" should read “URL-path”, but I still think that would be
wrong.
Adding an example would *surely* help.
🅭🄍: https://www.philippecloutier.com/Common+infrastructure+licensing#its
--
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
[Bug 70043] Rewrite Guide: Disambiguate uses of URI vs URL vs URL-path across all docs.
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
--- Comment #5 from Rich Bowen <rb...@apache.org> ---
This is mostly addressed by r1934232.
--
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
[Bug 70043] RewriteRule Flags: DPI|discardpath confusing about URI
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
Philippe Cloutier <ch...@gmail.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
Summary|Requesting DPI example in |RewriteRule Flags:
|rewrite/flags.html |DPI|discardpath confusing
| |about URI
--- Comment #2 from Philippe Cloutier <ch...@gmail.com> ---
Thanks Rich, but I am restoring this ticket’s original title.
Suggesting solutions is fine, but as this is an ITS, each ticket should
emphasize the problem, in particular in the title. For example, compare a
ticket titled in this one’s fashion:
❌Bigger titles
…with a proper title for the same issue:
✅Poor title legibility (gray on grayer background)
Moreover, the request you highlighted does not resolve this issue, it would
merely mitigate it or expose it more clearly. The core issue is with the second
paragraph’s confusing (and surely incorrect) phrasing.
--
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
[Bug 70043] Requesting DPI example in rewrite/flags.html
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
Rich Bowen <rb...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Summary|RewriteRule Flags: |Requesting DPI example in
|DPI|discardpath confusing |rewrite/flags.html
|about URI |
--
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
[Bug 70043] RewriteRule Flags: DPI|discardpath confusing about URI
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
--- Comment #3 from Rich Bowen <rb...@apache.org> ---
As the person who will surely be the one that works on this ticket, having a
title that actually explains to me what I expect to be working on makes it much
more likely that I will actually work on it. "Confusing", like "Incoherent",
does not communicate to me the intent of the ticket.
But, whatever. I give up. Have a lovely weekend.
--
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
[Bug 70043] Rewrite Guide confusing about URI (DPI|discardpath)
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
Philippe Cloutier <ch...@gmail.com> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|RESOLVED |VERIFIED
Summary|Rewrite Guide: Disambiguate |Rewrite Guide confusing
|uses of URI vs URL vs |about URI (DPI|discardpath)
|URL-path across all docs. |
--- Comment #7 from Philippe Cloutier <ch...@gmail.com> ---
(In reply to Rich Bowen from comment #3)
> As the person who will surely be the one that works on this ticket, having a
> title that actually explains to me what I expect to be working on makes it
> much more likely that I will actually work on it.
Your concern is legitimate, and there are ITS engines like Azure DevOps which
allow to create tasks for issues, as the “Track work with different work item
types” section there shows:
https://learn.microsoft.com/en-us/azure/devops/boards/work-items/about-work-items?view=azure-devops&tabs=basic-process
Unfortunately, although this practice is very common in the industry, it is
much less so in CBPP. Most CBPP ITSs use basic engines like Bugzilla, which
does not support tasks. [MNG-5896] is more or less an example, although the
tickets do not use the Task type. [INFRA-27707] uses the Task type, although
the example is not very convincing. But this would be possible on ASF Jira
(YouTrack is another engine which models this well).
> "Confusing", like "Incoherent", does not communicate to me the intent of the ticket.
If tickets have an intent, I would argue their title’s (main) function is to
communicate their issue, not their intent. You could rightly say that
"confusing" is not so clear, but then mod_rewrite is itself unclear, so
describing an issue in its documentation in a single sentence is not always
easy. Even in the Description, I could not say precisely what the problem is,
since I didn't really understand what the section describes. The Description
should be read to see how the problem can be addressed.
> But, whatever. I give up.
If I may abuse “my” ticket, I sense some discouragement/resignation in that
latest comment, as well as in some of your other messages elsewhere.
I don't disagree with your assessment that you were most likely to contribute
to a solution. And I don't disagree that there are lots of documentation
issues. But that is also the case in many other projects (at the ASF and
elsewhere). I very much hope you will get help, or even not need to intervene
at all in future fixes. There may be very few people contributing to
documentation today, but that does not mean it has to stay this way. As I wrote
in https://lists.apache.org/thread/94gh4txmxnt8y4bknz9p8p4ygnot08sq, httpd
documentation may not have an abundance of very low-hanging fruits, but the
best advice I can offer is the same I have for the vast majority of projects I
advise: invest in foundations first. Even if that takes more time first, that
will lead earlier to a quality product which lasts longer. Remember Nupedia’s
faith, and don’t neglect infrastructure/tools/processes and
recruitment/training. To quote Dirk-Willem van Gulik:
> [The ASF is about] finding, first and foremost, a very welcoming community, and a code base only second
>
That being said, I understand httpd is itself a highly foundational component,
so there was no choice earlier.
> Have a lovely weekend.
Thank you, I hope yours was as good.
Thank you very much for the fixes, that is way clearer. I now get a sense of
what this is saying and filed a followup in ticket #70052.
Also, I understand from your retitling and commit message that you confuse URIs
and URI references. A URL-path can be an URI reference, but it is never a URI.
Moreover, a URL-path never includes a query string.
--
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
[Bug 70043] Requesting DPI example in rewrite/flags.html
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
Rich Bowen <rb...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|UNCONFIRMED |NEW
Ever confirmed|0 |1
--- Comment #1 from Rich Bowen <rb...@apache.org> ---
Update issue title to reflect intent of issue -- Add example to DPI in
rewrite/flags.html
A number of the flags would benefit from examples.
Adding to TODO.md in r1934220
--
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
[Bug 70043] Rewrite Guide: Disambiguate uses of URI vs URL vs URL-path across all docs.
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
Rich Bowen <rb...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Summary|RewriteRule Flags: |Rewrite Guide: Disambiguate
|DPI|discardpath confusing |uses of URI vs URL vs
|about URI |URL-path across all docs.
--- Comment #4 from Rich Bowen <rb...@apache.org> ---
In RFC terms, URI and URL are functionally interchangeable on the web
(all HTTP URLs are URIs; RFC 3986 subsumes both). However, in this
context the docs mean specifically the path component — no scheme, no
host, no port. "URL-path" (as defined in our own directive-dict.xml)
makes this unambiguous, and is consistent with the rest of the
mod_rewrite documentation which uses "URL-path" throughout.
One assumes that this is what you're reporting here.
--
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
[Bug 70043] Rewrite Guide: Disambiguate uses of URI vs URL vs URL-path across all docs.
Posted by bu...@apache.org.
https://bz.apache.org/bugzilla/show_bug.cgi?id=70043
Rich Bowen <rb...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Resolution|--- |FIXED
Status|NEW |RESOLVED
--- Comment #6 from Rich Bowen <rb...@apache.org> ---
The rest is resolved in r1934233.
--
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