X-Git-Url: http://git.home-dn.net/?p=manu%2Fmod-proxy-html.git;a=blobdiff_plain;f=proxy_html.conf;h=49afe98a099397a5b324548815d4abaf8a714757;hp=4e9367e8a82ac54c6d8daa5ac6740c3bf67676eb;hb=5e5032129599538ea115b63e68b24227a80d2491;hpb=2b3efffe1c7b11edc9702191910fd61ce07520c5

diff --git a/proxy_html.conf b/proxy_html.conf
index 4e9367e..49afe98 100644
--- a/proxy_html.conf
+++ b/proxy_html.conf
@@ -1,16 +1,20 @@
 # Configuration example.
 #
-# First, to load the module with its prerequisites
+# First, to load the module with its prerequisites.  Note: mod_xml2enc
+# is not always necessary, but without it mod_proxy_html is likely to
+# mangle pages in encodings other than ASCII or Unicode (utf-8).
 #
 # For Unix-family systems:
 # LoadFile	/usr/lib/libxml2.so
 # LoadModule	proxy_html_module	modules/mod_proxy_html.so
+# LoadModule	xml2enc_module		modules/mod_xml2enc.so
 #
 # For Windows (I don't know if there's a standard path for the libraries)
 # LoadFile	C:/path/zlib.dll
 # LoadFile	C:/path/iconv.dll
 # LoadFile	C:/path/libxml2.dll
 # LoadModule	proxy_html_module	modules/mod_proxy_html.so
+# LoadModule	xml2enc_module		modules/mod_xml2enc.so
 # 
 # All knowledge of HTML links has been removed from the mod_proxy_html
 # code itself, and is instead read from httpd.conf (or included file)
@@ -56,7 +60,26 @@ ProxyHTMLEvents	onclick ondblclick onmousedown onmouseup \
 #
 # ProxyHTMLLinks	myelement	myattr otherattr
 #
-# Also at top level in httpd.conf, you can declare charset aliases.
-# This is the most efficient way to support encodings that libxml2
-# doesn't natively support.  See the documentation at
+###########
+# EXAMPLE #
+###########
+#
+# To define the URL /my-gateway/ as a gateway to an appserver with address
+# http://some.app.intranet/ on a private network, after loading the
+# modules and including this configuration file:
+#
+# ProxyRequests Off  <-- this is an important security setting
+# ProxyPass /my-gateway/ http://some.app.intranet/
+# <Location /my-gateway/>
+#	ProxyPassReverse /
+#	ProxyHTMLEnable On
+#	ProxyHTMLURLMap http://some.app.intranet/ /my-gateway/
+#	ProxyHTMLURLMap / /my-gateway/
+# </Location>
+#
+# Many (though not all) real-life setups are more complex.
+#
+# See the documentation at
 # http://apache.webthing.com/mod_proxy_html/
+# and the tutorial at
+# http://www.apachetutor.org/admin/reverseproxies