[myserver-commit] [2997] Added documentation for the `LOCATION' element.

[Giuseppe Scrivano]

Revision: 2997
          http://svn.sv.gnu.org/viewvc/?view=rev&root=myserver&revision=2997
Author:   gscrivano
Date:     2009-02-04 21:24:59 +0000 (Wed, 04 Feb 2009)

Log Message:
-----------
Added documentation for the `LOCATION' element.

Modified Paths:
--------------
    trunk/myserver/documentation/virtual_hosts.texi

Modified: trunk/myserver/documentation/virtual_hosts.texi
===================================================================
--- trunk/myserver/documentation/virtual_hosts.texi     2009-02-03 20:43:34 UTC 
(rev 2996)
+++ trunk/myserver/documentation/virtual_hosts.texi     2009-02-04 21:24:59 UTC 
(rev 2997)
@@ -87,6 +87,24 @@
 imposed using security file.
 
 @subsection HTTP specific configuration
+
address@hidden The LOCATION element
+It may be necessary to register an entire location with a single
+handler and it is done trought @code{LOCATION}.
+Any other element passed after the location will be part of the
address@hidden variable.
+
address@hidden
+    <LOCATION path="foo/bar" mime="text/html" handler="CGI" 
param="/usr/local/bin/handler" />
address@hidden example
+
+In the previous example, the CGI process @file{/usr/local/bin/handler}
+is used to manage any request to the location @file{foo/bar}, this
+location includes for example: @file{foo/bar}, @file{foo/bar/baz},
address@hidden/bar/a/file}, everything that follows @file{foo/bar} will be
+part of @code{PATH_INFO}.
+
address@hidden HTTP trace command
 MyServer gives you the option to enable the HTTP TRACE command for
 each virtual host. All you need to do is edit the @file{security.xml}
 file of the root of your virtual host (not a subdirectory!  If the