https://bz.apache.org/bugzilla/show_bug.cgi?id=70088
Bug ID: 70088
Summary: Mapping URLs to Filesystem Locations: URL-path
description misleading
Product: Apache httpd-2
Version: 2.5-HEAD
Hardware: All
URL: https://httpd.apache.org/docs/trunk/en/urlmapping.html
#documentroot
OS: All
Status: UNCONFIRMED
Severity: minor
Priority: P3
Component: Documentation
Assignee: [email protected]
Reporter: [email protected]
Target Milestone: ---
The DocumentRoot section of the Mapping URLs to Filesystem Locations page
starts with:
> In deciding what file to serve for a given request, httpd's default behavior
> is to take the URL-Path for the request (the part of the URL following the
> hostname and port) and add it to the end of the DocumentRoot specified in
> your configuration files.
The parenthesis is unclear, since most URLs have no port. But most importantly,
it is ambiguous, and its most likely interpretation is misleading, since the
URL path does not include any query string.
One way to disambiguate would be to refer to “the component following” instead
of “the part of the URL following”, however the URL Standard appears to have
dropped RFC 3986’s "component" terminology. I recommend just dropping the
parenthesis, deferring to our definition:
diff --git a/docs/manual/urlmapping.xml b/docs/manual/urlmapping.xml
--- docs/manual/urlmapping.xml
+++ docs/manual/urlmapping.xml
@@ -71,11 +71,10 @@
<section id="documentroot"><title>DocumentRoot</title>
<p>In deciding what file to serve for a given request, httpd's
- default behavior is to take the URL-Path for the request (the part
- of the URL following the hostname and port) and add it to the end
- of the <directive module="core">DocumentRoot</directive> specified
+ default behavior is to take the request’s <a
href="directive-dict.html#Syntax">URL-path</a>
+ and add it to the end of the <directive
module="core">DocumentRoot</directive> specified
in your configuration files. Therefore, the files and directories
underneath the <directive module="core">DocumentRoot</directive>
make up the basic document tree which will be visible from the
web.</p>
By the way, “path” is not capitalized in “URL-Path”.
🅭🄍: 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: [email protected]
For additional commands, e-mail: [email protected]
