[interchange-docs] xmldocs - docelic modified refs/FullUrl
docs at icdevgroup.org
docs at icdevgroup.org
Fri Oct 10 09:29:32 UTC 2008
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 —
+&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__
+
More information about the docs
mailing list