[prev in list] [next in list] [prev in thread] [next in thread] 

List:       apache-docs
Subject:    DO NOT REPLY [Bug 50730] Location of .var type-map files for content
From:       bugzilla () apache ! org
Date:       2011-03-01 15:00:55
Message-ID: 201103011500.p21F0txJ003635 () thor ! apache ! org
[Download RAW message or body]

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

--- Comment #2 from Fiable.biz <mongolie2006-apache@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


[prev in list] [next in list] [prev in thread] [next in thread]