[update for reverse proxies documentation
dan**20031110051152] {
hunk ./doc/installation.html 87
-
+<p>For more information on using a reverse proxy in front of Araneida,
+see the <a href="listeners.html">Listeners</a> documentation.
hunk ./doc/listeners.html 26
+<h2>Proxies</h2>
+
+<p>If you are using a reverse proxy (e.g. Apache's mod_proxy) in front
+of Araneida, you will probably want to use
+{THREADED,SERVE-EVENT}-REVERSE-PROXY-LISTENER.  These have an
+additional TRANSLATIONS slot - this is a list whose elements are
+urlstrings mapping from the external URL hierarchy that the proxy is
+configured for to the internal URL that Araneida is listening for.
+For example, 
+<pre>
+:translations '(("http://www.examples.com/" "http://www.internal:8000/")
+                ("http://images.examples.com/" "http://images.internal:8000/")
+</pre>
+
+<p>There are two reasons to use this: 
+<ol>
+<li>Araneida handlers now believe the requests they are seeing are
+from the public interface, so for example REQUEST-URL will return
+www.examples.com instead of www.internal.  This means that URLs
+can safely be displayed to the browser without bypassing the proxy.
+<li>the APACHE-CONF-SEGMENT function can be used to print out a chunk
+of apache.conf syntax containing VirtualHost definitions for the 
+specified translations.
+</ol>
+
+
}