[interchange-docs] xmldocs - docelic modified refs/FullUrl

[docs at icdevgroup.org]

User:      docelic
Date:      2008-10-10 09:29:32 GMT
Modified:  refs     FullUrl
Log:
* Improvement to FullUrl directive

Revision  Changes    Path
1.4                  xmldocs/refs/FullUrl


rev 1.4, prev_rev 1.3
Index: FullUrl
===================================================================
RCS file: /var/cvs/xmldocs/refs/FullUrl,v
retrieving revision 1.3
retrieving revision 1.4
diff -u -r1.3 -r1.4
--- FullUrl	23 Nov 2007 13:55:57 -0000	1.3
+++ FullUrl	10 Oct 2008 09:29:32 -0000	1.4
@@ -9,20 +9,33 @@
 
 
 __NAME__ description
-⁣ determines the appropriate catalog to invoke by the 
-<literal>SCRIPT_NAME</literal> from the CGI call. This means that different
-(possibly virtual) hosts cannot use the same <literal>SCRIPT_NAME</literal>, as
-the catalogs would become indistinguishable. Setting this directive includes
-the hostname in the catalog selection method.
+When a page request comes to &IC;, the &glos-catalog; to invoke is
+determined from CGI value <literal>SCRIPT_NAME</literal>.
 </para><para>
-See the &conf-Catalog; directive for more on the subject and concrete
+For example, 
+if a request for <literal>www.example.com/cat1</literal> comes in,
+<literal>SCRIPT_NAME</literal> will be "<literal>/cat1</literal>".
+If a request for <literal>www.example.com</literal> comes in,
+<literal>SCRIPT_NAME</literal> will be "<literal>/</literal>".
+</para><para>
+By default, hostnames are not honored, so different catalogs cannot use the
+same <literal>SCRIPT_NAME</literal> under the same &IC; server. This prevents
+multiple domains from serving their &IC; pages directly from www.HOSTNAME.com
+(as there can only be one "<literal>/</literal>" script name).
+</para><para>
+With &conf-FullUrl; enabled, catalog selection includes the hostname
+and it becomes possible to uniquely determine catalog name based on both
+hostname and script name.
+</para><para>
+See the &conf-Catalog; directive for further discussion and concrete
 examples.
 __END__
 
 __NAME__ notes
-If &conf-FullUrl; is defined, <emphasis role='bold'>all catalogs must be
-defined with hostnames included</emphasis>. Per-catalog setting can not work,
-as this is used before the catalog name is known.
+If &conf-FullUrl; is defined, <emphasis role='bold'>you must modify all
+&conf-catalog; lines in your &gcf; to include the hostname &mdash; 
+&conf-FullUrl; and non-&conf-FullUrl; &conf-catalog; specifications
+are not compatible.</emphasis>
 __END__
 
 __NAME__ see also
@@ -36,3 +49,12 @@
 </programlisting>
 __END__
 
+__NAME__ example: Catalog definition example with FullUrl enabled
+An example from &gcf;:
+<programlisting>
+FullUrl yes
+
+Catalog &std-catalog; /path/to/catalogs/&std-catalog;/ &def-hostname;/cgi-bin/&std-catalog;
+</programlisting>
+__END__
+