httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "William A. Rowe, Jr." <wr...@rowe-clan.net>
Subject Re: Type-map files
Date Mon, 03 Sep 2001 02:35:24 GMT
From: "Rich Bowen" <rbowen@rcbowen.com>
Sent: Sunday, September 02, 2001 2:48 PM


> I'm still missing something from the documentation for content
> negotiation, and want to make sure that I am understanding this
> correctly before I add something incorrect to the docs.
> 
> What you do, if I'm getting this, is to do an AddHandler ...
> 
> AddHandler type-map .var
> 
> and then create a file called foo.var which lists the various
> representations of the resource called foo. Is that correct? So a given
> directory may contain multiple .var files - in fact, is rather required
> to contain multiple of them, one per negotiated resource? This
> particular point is not clear in the docs, which seems to imply that you
> might be able to just create one .var file that listed all the resources
> for the entire directory.

Yes, this is correct.  Also, note the following behavior.  If the user
enables Multiviews, requests index.html, and creats an index.html.var file
amoungst other index.html.xx variants, the index.html.var file _WILL_
take precedence over the filename's extension parsing!

They are no more required than multiple language versions.  However, you
can note that parsing a .var file is far less CPU intensive than scanning
for matching files.  Of course, if the system does _both_ (and hits a .var
file while looking at all the Multiview variants) it can sometimes be more
expensive.

> Either way, whether or not I am correctly understanding this, the docs
> need to be more explicit on this point, since it is not immediately
> apparent from the docs what the AddHandler directive is doing here,
> where the .var file is to go, and what it is to contain. (ie whether you
> list one or more than one resource per file.)
> 
> The docs point off to the sample configuration file for more details,
> which seems rather backwards to me. But I don't see anything in
> httpd-std.conf which enlightens me any further.
> 
> Thanks for any pointers on this. I know I'm probably just overlooking
> this somewhere, as I did the first time, but I rest in the defence that
> if I can't find it, neither can the average docs user.

Look at the mod_negotiation comments, some are very well documented, e.g.
file format etc, about .var files.

You can document that we used the type map to avoid the user introducing
new index.html.xx variants and forgetting to update the list of languages
and character sets in their httpd.conf file.

Bill



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


Mime
View raw message