httpd-users mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Boyle Owen" <Owen.Bo...@swx.com>
Subject RE: UseCanonicalName Off
Date Tue, 02 Jul 2002 11:05:40 GMT
>From: Rich Bowen [mailto:rbowen@rcbowen.com]
>
>With UseCanonicalName on, Apache will use the ServerName and Pot
>directives to construct a canonical name for the server. This name is
>used in all self-referential URLs, and for the values of 
>SERVER_NAME and
>SERVER_PORT.
>
>With UseCanonicalName off, Apache will form self-referential URLs using
>the hostname and port supplied by the client, if they are supplied.
>Otherwise it will use the canonical name.
>

What is confusing is that it is not obvious that the entity "canonical name" is *defined*
in para 1 and that it is the same entity which is referred to in para 2.

To put it another way, it is not clear that "canonical name" is a concept related only to
this particular directive. An inexperienced user, unfamiliar with the jargon, might think
that it is some general concept that exists outside apache (like domain name or ip address).
In this frame of mind, he might think that "a canonical name" constructed in para 1 is one
thing and "the canonical name" used in para 2 is something else derived from another source.

It wouldn't take much to clear it up;

"With UseCanonicalName on, Apache will use the ServerName and Port directives to construct
*the* canonical name for the server.

With UseCanonicalName off, Apache will form self-referential URLs using the hostname and port
supplied by the client, if they are supplied. Otherwise it will use the canonical name *as
defined above*."

Rgds,

Owen Boyle

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


Mime
View raw message