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 2011/02/08 11:04:23 UTC
DO NOT REPLY [Bug 50730] New: Location of .var type-map files for
content negotiation mod_negotiation not mentioned.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50730
Summary: Location of .var type-map files for content
negotiation mod_negotiation not mentioned.
Product: Apache httpd-2
Version: 2.2.17
Platform: All
OS/Version: All
Status: NEW
Severity: normal
Priority: P2
Component: Documentation
AssignedTo: docs@httpd.apache.org
ReportedBy: mongolie2006-apache@yahoo.fr
The page
http://httpd.apache.org/docs/current/en/content-negotiation.html#negotiation
explains how to create a type-map file for the mod_negotiation module, but
fails to explain where to put such a file and whether several such files are
possible/recommended or not.
--
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
DO NOT REPLY [Bug 50730] Location of .var type-map files for content
negotiation mod_negotiation not mentioned.
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50730
--- Comment #2 from Fiable.biz <mo...@yahoo.fr> 2011-03-01 10:00:52 EST ---
Thank you.
It's said that “Type map files should have the same name as the resource which
they are describing”.
A 1st problem is that the example immediately following show that the two names
do differ, since the file name has an extension, but not the resource.
A 2nd problem is, if I understand well, that type map files "should" not but
HAVE TO have that name.
A 3rd problem is that mixing the plural with the singular in this sentence,
though grammatically correct, leads to 2 possible interpretations if read
quickly or by a non native speaker like me, one interpretation being that
several type map fileS ARE describing THE resourcE.
A 4th problem is that it's obvious for you that the type map file should be
placed where most other resource file would, but it's not written and it's not
obvious. Please take into account that most people are familiar with the notion
of file and unfamiliar, if not completely new, to notion of resource, so that
things which can become obvious after a few minutes of thinking are not at
first reading for us. Moreover readers can, like me, be discovering how a web
server works. My former experience of maths teacher in high school is that
"obvious" things are not obvious at all for pupils, even for those with a good
brain, specially when there are several new things in one lesson.
I suggest to replace
“Type map files should have the same name as the resource which they are
describing, and have an entry for each available variant;”
by
“The type map of a given resource must have the same name as the resource it
describes, followed by the extension ".var", and must be placed in the
directory indicated by the URI of that resource. For instance, for a ressource
of URI http://example.com/bar/dir/foo , the type map file must be
bar/dir/foo.var inside the file hierarchy pointed to by http://example.com .
The type map must have an entry for each available variant;”
--
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
DO NOT REPLY [Bug 50730] Location of .var type-map files for content
negotiation mod_negotiation not mentioned.
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50730
Igor Galić <i....@brainsware.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEW |NEEDINFO
--- Comment #1 from Igor Galić <i....@brainsware.org> 2011-02-28 14:25:35 EST ---
"""Using a type map (i.e., a *.var file) which names the files containing the
variants explicitly, or"""
and then:
"""Type map files should have the same name as the resource which they are
describing, and have an entry for each available variant; these entries consist
of contiguous HTTP-format header lines."""
If that is not clear enough, can you suggest a better phrasing?
For one, for the other: We then go on to describe the multitude of things you
can pack into a single .var file -- I'm not quite clear how from these two
pieces of information you were able to interpret that:
a) type-maps can be placed in arbitrary directories (How then should they be
mapped to the requested resources?)
b) There can be more than one type-map
...sure there can be.. but that would be silly...
You could for instance create
# foo.en.var:
URI: foo.en.html
Content-Encoding: text/html
URI: foo.en.xhtml
Content-Encoding: text/xhtml
# foo.fr.var:
URI: foo.fr.html
Content-Encoding: text/html
URI: foo.fr.xhtml
Content-Encoding: text/xhtml
But that seems silly, since you can vary on all that within the same type-map:
# foo.var:
URI: foo.en.html
Content-Language: en
Content-Type: text/html
URI: foo.en.xhtml
Content-Language: en
Content-Type: text/xhtml
URI: foo.fr.html
Content-Language: fr
Content-Type: text/html
URI: foo.fr.xhtml
Content-Language: fr
Content-Type: text/xhtml
--
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
DO NOT REPLY [Bug 50730] Location of .var type-map files for content
negotiation mod_negotiation not mentioned.
Posted by bu...@apache.org.
https://issues.apache.org/bugzilla/show_bug.cgi?id=50730
Rich Bowen <rb...@apache.org> changed:
What |Removed |Added
----------------------------------------------------------------------------
Status|NEEDINFO |RESOLVED
Resolution| |FIXED
--- Comment #3 from Rich Bowen <rb...@apache.org> 2011-07-21 13:45:01 UTC ---
I've added some clarifications in r1149174, in trunk. If I get a chance, I'll
put these changes in the 2.2 docs as well. Thanks for the suggestions.
--
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