httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From mru...@apache.org
Subject svn commit: r1696464 - /httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml
Date Tue, 18 Aug 2015 17:34:30 GMT
Author: mrumph
Date: Tue Aug 18 17:34:30 2015
New Revision: 1696464

URL: http://svn.apache.org/r1696464
Log:
Grammar corrections

Modified:
    httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml

Modified: httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml?rev=1696464&r1=1696463&r2=1696464&view=diff
==============================================================================
--- httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml (original)
+++ httpd/httpd/branches/2.2.x/docs/manual/mod/mod_proxy.xml Tue Aug 18 17:34:30 2015
@@ -77,7 +77,7 @@
       server that sits between the client and the <em>origin
       server</em>.  In order to get content from the origin server,
       the client sends a request to the proxy naming the origin server
-      as the target and the proxy then requests the content from the
+      as the target. The proxy then requests the content from the
       origin server and returns it to the client.  The client must be
       specially configured to use the forward proxy to access other
       sites.</p>
@@ -98,15 +98,15 @@
       <p>A <dfn>reverse proxy</dfn> (or <dfn>gateway</dfn>),
by
       contrast, appears to the client just like an ordinary web
       server.  No special configuration on the client is necessary.
-      The client makes ordinary requests for content in the name-space
+      The client makes ordinary requests for content in the namespace
       of the reverse proxy.  The reverse proxy then decides where to
-      send those requests, and returns the content as if it was itself
+      send those requests and returns the content as if it were itself
       the origin.</p>
 
       <p>A typical usage of a reverse proxy is to provide Internet
       users access to a server that is behind a firewall.  Reverse
       proxies can also be used to balance load among several back-end
-      servers, or to provide caching for a slower back-end server.
+      servers or to provide caching for a slower back-end server.
       In addition, reverse proxies can be used simply to bring
       several servers into the same URL space.</p>
 
@@ -152,7 +152,7 @@
     <section id="workers"><title>Workers</title>
       <p>The proxy manages the configuration of origin servers and their
       communication parameters in objects called <dfn>workers</dfn>.
-      There are two built-in workers, the default forward proxy worker and the
+      There are two built-in workers: the default forward proxy worker and the
       default reverse proxy worker. Additional workers can be configured
       explicitly.</p>
 
@@ -173,7 +173,7 @@
       </example>
 
       <p>This will create a worker associated with the origin server URL
-      <code>http://backend.example.com</code> and using the given timeout
+      <code>http://backend.example.com</code> that will use the given timeout
       values. When used in a forward proxy, workers are usually defined
       via the <directive module="mod_proxy">ProxySet</directive> directive:</p>
 
@@ -195,13 +195,13 @@
       <p>Using explicitly configured workers in the forward mode is
       not very common, because forward proxies usually communicate with many
       different origin servers. Creating explicit workers for some of the
-      origin servers can still be useful, if they are used very often.
+      origin servers can still be useful if they are used very often.
       Explicitly configured workers have no concept of forward or reverse
       proxying by themselves. They encapsulate a common concept of
       communication with origin servers. A worker created by
       <directive module="mod_proxy">ProxyPass</directive> for use in a
-      reverse proxy will be also used for forward proxy requests whenever
-      the URL to the origin server matches the worker URL and vice versa.</p>
+      reverse proxy will also be used for forward proxy requests whenever
+      the URL to the origin server matches the worker URL, and vice versa.</p>
 
       <p>The URL identifying a direct worker is the URL of its
       origin server including any path components given:</p>
@@ -229,13 +229,13 @@
         so connections are more often reused. Note that all configuration attributes
         given explicitly for the later worker and some configuration defaults will
         overwrite the configuration given for the first worker. This will be logged
-        as a warning. In the above example the resulting timeout value
+        as a warning. In the above example, the resulting timeout value
         for the URL <code>/apps</code> will be <code>10</code> instead
         of <code>60</code>!</p>
 
         <p>If you want to avoid worker sharing, sort your worker definitions
         by URL length, starting with the longest worker URLs. If you want to maximize
-        worker sharing use the reverse sort order. See also the related warning about
+        worker sharing, use the reverse sort order. See also the related warning about
         ordering <directive module="mod_proxy">ProxyPass</directive> directives.</p>
 
       </note> <!-- /worker_sharing -->
@@ -248,7 +248,7 @@
       <directive module="mod_proxy">ProxySet</directive>.</p>
 
       <p>The set of options available for a direct worker
-      depends on the protocol, which is specified in the origin server URL.
+      depends on the protocol which is specified in the origin server URL.
       Available protocols include <code>ajp</code>,
       <code>ftp</code>, <code>http</code> and <code>scgi</code>.</p>
 
@@ -265,7 +265,7 @@
 
     </section> <!-- /workers -->
 
-    <section id="access"><title>Controlling access to your proxy</title>
+    <section id="access"><title>Controlling Access to Your Proxy</title>
       <p>You can control who can access your proxy via the <directive
       module="mod_proxy" type="section">Proxy</directive> control block as in
       the following example:</p>
@@ -473,14 +473,14 @@ response</description>
 
 <usage>
     <p>The <directive>ProxyBadHeader</directive> directive determines the
-    behaviour of <module>mod_proxy</module> if it receives syntactically invalid
+    behavior of <module>mod_proxy</module> if it receives syntactically invalid
     response header lines (<em>i.e.</em> containing no colon) from the origin

     server. The following arguments are possible:</p>
 
     <dl>
     <dt><code>IsError</code></dt>
     <dd>Abort the request and end up with a 502 (Bad Gateway) response. This is
-    the default behaviour.</dd>
+    the default behavior.</dd>
 
     <dt><code>Ignore</code></dt>
     <dd>Treat bad header lines as if they weren't sent.</dd>
@@ -520,7 +520,7 @@ proxied resources</description>
 <usage>
     <p>The <directive type="section">ProxyMatch</directive> directive is
     identical to the <directive module="mod_proxy"
-    type="section">Proxy</directive> directive, except it matches URLs
+    type="section">Proxy</directive> directive, except that it matches URLs
     using <glossary ref="regex">regular expressions</glossary>.</p>
 </usage>
 <seealso><directive type="section" module="mod_proxy">Proxy</directive></seealso>
@@ -539,7 +539,7 @@ request</description>
 <usage>
     <p>When enabled, this option will pass the Host: line from the incoming
     request to the proxied host, instead of the hostname specified in the
-    <directive>ProxyPass</directive> line.</p>
+    <directive>ProxyPass module="mod_proxy"</directive> line.</p>
 
     <p>This option should normally be turned <code>Off</code>. It is mostly

     useful in special configurations like proxied mass name-based virtual
@@ -616,7 +616,7 @@ request</description>
     as yet another HTTP proxy request, to another proxy which can handle
     them.</p>
 
-    <p>This option also supports reverse proxy configuration - a backend
+    <p>This option also supports reverse proxy configuration; a backend
     webserver can be embedded within a virtualhost URL space even if that
     server is hidden by another forward proxy.</p>
 </usage>
@@ -632,8 +632,9 @@ expressions</description>
 
 <usage>
     <p>The <directive>ProxyRemoteMatch</directive> is identical to the
-    <directive module="mod_proxy">ProxyRemote</directive> directive, except the
-    first argument is a <glossary ref="regex">regular expression</glossary>
+    <directive module="mod_proxy">ProxyRemote</directive> directive, except
+    that the first argument is a 
+    <glossary ref="regex">regular expression</glossary>
     match against the requested URL.</p>
 </usage>
 </directivesynopsis>
@@ -648,11 +649,12 @@ expressions</description>
 <compatibility>BalancerMember is only available in Apache 2.2
         and later.</compatibility>
 <usage>
-    <p>This directive adds a member to a load balancing group. It could be used
+    <p>This directive adds a member to a load balancing group. It can be used
     within a <code>&lt;Proxy <var>balancer://</var>...&gt;</code>
container
-    directive, and can take any of the key value pairs available to
+    directive and can take any of the key value pairs available to
     <directive module="mod_proxy">ProxyPass</directive> directives.</p>
-    <p>The balancerurl is only needed when not in <code>&lt;Proxy <var>balancer://</var>...&gt;</code>
+    <p>The balancerurl is only needed when not within a
+    <code>&lt;Proxy <var>balancer://</var>...&gt;</code>
     container directive. It corresponds to the url of a balancer defined in
     <directive module="mod_proxy">ProxyPass</directive> directive.</p>
 </usage>
@@ -705,8 +707,8 @@ expressions</description>
 
    <note type="warning"><title>Warning</title>
       <p>Keep in mind that the same parameter key can have a different meaning
-      depending whether it is applied to a balancer or a worker as shown by the two
-      examples above regarding timeout.</p>
+      depending whether it is applied to a balancer or a worker, as shown by
+      the two examples above regarding timeout.</p>
    </note>
 
 </usage>
@@ -723,8 +725,8 @@ expressions</description>
 
 <usage>
     <p>This directive allows remote servers to be mapped into the
-    space of the local server; the local server does not act as a
-    proxy in the conventional sense, but appears to be a mirror of the
+    space of the local server. The local server does not act as a
+    proxy in the conventional sense but appears to be a mirror of the
     remote server. The local server is often called a <dfn>reverse
     proxy</dfn> or <dfn>gateway</dfn>. The <var>path</var>
is the name of
     a local virtual path; <var>url</var> is a partial URL for the
@@ -748,8 +750,8 @@ expressions</description>
 
     <note type="warning">
     <p>If the first argument ends with a trailing <strong>/</strong>, the
second
-       argument should also end with a trailing <strong>/</strong> and vice
-       versa. Otherwise the resulting requests to the backend may miss some
+       argument should also end with a trailing <strong>/</strong>, and vice
+       versa. Otherwise, the resulting requests to the backend may miss some
        needed slashes and do not deliver the expected results.
     </p>
     </note>
@@ -772,11 +774,11 @@ expressions</description>
       rules are checked in the order of configuration. The first rule that
       matches wins. So usually you should sort conflicting
       <directive module="mod_proxy">ProxyPass</directive> rules starting with
the
-      longest URLs first. Otherwise later rules for longer URLS will be hidden
+      longest URLs first. Otherwise, later rules for longer URLS will be hidden
       by any earlier rule which uses a leading substring of the URL. Note that
       there is some relation with worker sharing.</p>
 
-      <p>For the same reasons exclusions must come <em>before</em> the
+      <p>For the same reasons, exclusions must come <em>before</em> the
       general <directive>ProxyPass</directive> directives.</p>
 
     </note> <!-- /ordering_proxypass -->
@@ -786,7 +788,7 @@ expressions</description>
     can be retained in a pool for future use.  Limits on the pool size
     and other settings can be coded on
     the <directive>ProxyPass</directive> directive
-    using  <code>key=value</code> parameters, described in the table
+    using  <code>key=value</code> parameters, described in the tables
     below.</p>
 
     <p>By default, mod_proxy will allow and retain the maximum number of
@@ -821,8 +823,8 @@ expressions</description>
         <td>1...n</td>
         <td>Maximum number of connections that will be allowed to the
     backend server. The default for this limit is the number of threads
-    per process in the active MPM. In the Prefork MPM, this is always 1,
-    while with other MPMs it is controlled by the
+    per process in the active MPM. In the Prefork MPM, this is always 1;
+    while with other MPMs, it is controlled by the
     <directive>ThreadsPerChild</directive> directive.</td></tr>
     <tr><td>smax</td>
         <td>max</td>
@@ -836,16 +838,16 @@ expressions</description>
     closed more aggressively.</td></tr>
     <tr><td>acquire</td>
         <td>-</td>
-        <td>If set this will be the maximum time to wait for a free
+        <td>If set, this will be the maximum time to wait for a free
     connection in the connection pool, in milliseconds. If there are no free
-    connections in the pool the Apache will return <code>SERVER_BUSY</code>
+    connections in the pool, the Apache will return <code>SERVER_BUSY</code>
     status to the client.
     </td></tr>
     <tr><td>connectiontimeout</td>
         <td>timeout</td>
         <td>Connect timeout in seconds.
         The number of seconds Apache waits for the creation of a connection to
-        the backend to complete. By adding a postfix of ms the timeout can be
+        the backend to complete. By adding a postfix of ms, the timeout can be
         also set in milliseconds.
     </td></tr>
     <tr><td>disablereuse</td>
@@ -863,10 +865,10 @@ expressions</description>
         <td>off</td>
         <td>Determines whether the proxy module will auto-flush the output
         brigade after each "chunk" of data. 'off' means that it will flush
-        only when needed, 'on' means after each chunk is sent and
+        only when needed; 'on' means after each chunk is sent; and
         'auto' means poll/wait for a period of time and flush if
         no input has been received for 'flushwait' milliseconds.
-        Currently this is in effect only for AJP.
+        Currently, this is in effect only for AJP.
     </td></tr>
     <tr><td>flushwait</td>
         <td>10</td>
@@ -876,10 +878,11 @@ expressions</description>
     <tr><td>keepalive</td>
         <td>Off</td>
         <td><p>This parameter should be used when you have a firewall between
your
-    Apache and the backend server, who tend to drop inactive connections.
+    Apache and the backend server, which tends to drop inactive connections.
     This flag will tell the Operating System to send <code>KEEP_ALIVE</code>
-    messages on inactive connections  and thus prevent the firewall to drop the connection.
-    To enable keepalive set this property value to <code>On</code>. </p>
+    messages on inactive connections and thus prevent the firewall from dropping
+    the connection.
+    To enable keepalive, set this property value to <code>On</code>. </p>
     <p>The frequency of initial and subsequent TCP keepalive probes 
     depends on global OS settings, and may be as high as 2 hours. To be useful,
     the frequency configured in the OS must be smaller than the threshold used 
@@ -888,8 +891,8 @@ expressions</description>
     <tr><td>lbset</td>
         <td>0</td>
         <td>Sets the load balancer cluster set that the worker is a member
-         of. The load balancer will try all members of a lower numbered
-         lbset before trying higher numbered ones.
+        of. The load balancer will try all members of a lower numbered
+        lbset before trying higher numbered ones.
     </td></tr>
     <tr><td>ping</td>
         <td>0</td>
@@ -903,30 +906,30 @@ expressions</description>
         This will increase the network traffic during the normal operation
         which could be an issue, but it will lower the
         traffic in case some of the cluster nodes are down or busy.
-        Currently this has an effect only for AJP.
-        By adding a postfix of ms the delay can be also set in
+        Currently, this has an effect only for AJP.
+        By adding a postfix of ms, the delay can be also set in
         milliseconds.
     </td></tr>
     <tr><td>loadfactor</td>
         <td>1</td>
         <td>Worker load factor. Used with BalancerMember.
-         It is a number between 1 and 100 and defines the normalized weighted
-         load applied to the worker.
+        It is a number between 1 and 100 and defines the normalized weighted
+        load applied to the worker.
     </td></tr>
     <tr><td>redirect</td>
         <td>-</td>
         <td>Redirection Route of the worker. This value is usually
         set dynamically to enable safe removal of the node from
-        the cluster. If set all requests without session id will be
+        the cluster. If set, all requests without session id will be
         redirected to the BalancerMember that has route parameter
-        equal as this value.
+        equal to this value.
     </td></tr>
     <tr><td>retry</td>
         <td>60</td>
         <td>Connection pool worker retry timeout in seconds.
     If the connection pool worker to the backend server is in the error state,
     Apache will not forward any requests to that server until the timeout
-    expires. This enables to shut down the backend server for maintenance,
+    expires. This enables to shut down the backend server for maintenance
     and bring it back online later. A value of 0 means always retry workers
     in an error state with no timeout.
     </td></tr>
@@ -938,9 +941,9 @@ expressions</description>
     <tr><td>status</td>
         <td>-</td>
         <td>Single letter value defining the initial status of
-        this worker: 'D' is disabled, 'S' is stopped, 'I' is ignore-errors,
-	'H' is hot-standby and 'E' is in an error state. Status 
-	can be set (which is the default) by prepending with '+' or 
+        this worker: 'D' is disabled; 'S' is stopped; 'I' is ignore-errors;
+	    'H' is hot-standby; and 'E' is in an error state. Status 
+	    can be set (which is the default) by prepending with '+' or 
         cleared by prepending with '-'.
         Thus, a setting of 'S-E' sets this worker to Stopped and
         clears the in-error flag.
@@ -962,10 +965,11 @@ expressions</description>
 
     <p>If the <directive>ProxyPass</directive> directive scheme starts
with the
     <code>balancer://</code> (eg: <code>balancer://cluster/</code>,

-    any path information is ignored)  then a virtual worker that does not really
-    communicate with the backend server will be created. Instead it is responsible
-    for the management of several "real" workers. In that case the special set of
-    parameters can be add to this virtual worker. See <module>mod_proxy_balancer</module>
+    any path information is ignored), then a virtual worker that does not really
+    communicate with the backend server will be created. Instead, it is responsible
+    for the management of several "real" workers. In that case, the special set of
+    parameters can be added to this virtual worker. 
+    See <module>mod_proxy_balancer</module>
     for more information about how the balancer works.
     </p>
     <table>
@@ -976,10 +980,10 @@ expressions</description>
         <td>byrequests</td>
         <td>Balancer load-balance method. Select the load-balancing scheduler
         method to use. Either <code>byrequests</code>, to perform weighted
-        request counting, <code>bytraffic</code>, to perform weighted
-        traffic byte count balancing, or <code>bybusyness</code> 
+        request counting; <code>bytraffic</code>, to perform weighted
+        traffic byte count balancing; or <code>bybusyness</code> 
         (Apache HTTP Server 2.2.10 and later), to perform pending request 
-        balancing. Default is <code>byrequests</code>.
+        balancing. The default is <code>byrequests</code>.
     </td></tr>
     <tr><td>maxattempts</td>
         <td>One less than the number of workers, or 1 with a single worker.</td>
@@ -987,7 +991,7 @@ expressions</description>
     </td></tr>
     <tr><td>nofailover</td>
         <td>Off</td>
-        <td>If set to <code>On</code> the session will break if the worker
is in
+        <td>If set to <code>On</code>, the session will break if the worker
is in
         error state or disabled. Set this value to On if backend servers do not
         support session replication.
     </td></tr>
@@ -996,25 +1000,25 @@ expressions</description>
         <td>Balancer sticky session name. The value is usually set to something
         like <code>JSESSIONID</code> or <code>PHPSESSIONID</code>,
         and it depends on the backend application server that support sessions.
-        If the backend application server uses different name for cookies
-        and url encoded id (like servlet containers) use | to to separate them.
-        The first part is for the cookie the second for the path.
+        If the backend application server uses different names for cookies
+        and url encoded id (like servlet containers), use | to to separate them.
+        The first part is for the cookie; the second for the path.
     </td></tr>
     <tr><td>scolonpathdelim</td>
         <td>Off</td>
-        <td>If set to <code>On</code> the semi-colon character ';' will
be
+        <td>If set to <code>On</code>, the semi-colon character ';' will
be
         used as an additional sticky session path deliminator/separator. This
         is mainly used to emulate mod_jk's behavior when dealing with paths such
         as <code>JSESSIONID=6736bcf34;foo=aabfa</code>
     </td></tr>
     <tr><td>timeout</td>
         <td>0</td>
-        <td>Balancer timeout in seconds. If set this will be the maximum time
-        to wait for a free worker. Default is not to wait. 
+        <td>Balancer timeout in seconds. If set, this will be the maximum time
+        to wait for a free worker. The default is to not wait.
     </td></tr>
     <tr><td>failonstatus</td>
         <td>-</td>
-        <td>A single or comma-separated list of HTTP status codes. If set this will
+        <td>A single or comma-separated list of HTTP status codes. If set, this will
         force the worker into error state when the backend returns any status code
         in the list. Worker recovery behaves the same as other worker errors.
         Available with Apache HTTP Server 2.2.17 and later.
@@ -1032,13 +1036,13 @@ expressions</description>
         retry parameter of the workers if all workers of a balancer are
         in error state. There might be cases where an already overloaded backend
         can get into deeper trouble if the recovery of all workers is enforced
-        without considering the retry parameter of each worker. In this case
+        without considering the retry parameter of each worker. In this case,
         set to <code>Off</code>.
         Available with Apache HTTP Server 2.2.23 and later.
     </td></tr>
     
     </table>
-    <p>A sample balancer setup</p>
+    <p>A sample balancer setup:</p>
     <example>
       ProxyPass /special-area http://special.example.com smax=5 max=10<br />
       ProxyPass / balancer://mycluster/ stickysession=JSESSIONID|jsessionid nofailover=On<br
/>
@@ -1052,8 +1056,8 @@ expressions</description>
       &lt;/Proxy&gt;
     </example>
 
-    <p>Setting up a hot-standby, that will only be used if no other
-     members are available</p>
+    <p>Setting up a hot-standby that will only be used if no other
+     members are available:</p>
     <example>
       ProxyPass / balancer://hotcluster/ <br />
       &lt;Proxy balancer://hotcluster&gt;<br />
@@ -1070,17 +1074,17 @@ expressions</description>
     <p>Normally, mod_proxy will canonicalise ProxyPassed URLs.
     But this may be incompatible with some backends, particularly those
     that make use of <var>PATH_INFO</var>.  The optional <var>nocanon</var>
-    keyword suppresses this, and passes the URL path "raw" to the
-    backend.  Note that may affect the security of your backend, as it
-    removes the normal limited protection against URL-based attacks
+    keyword suppresses this and passes the URL path "raw" to the
+    backend.  Note that this keyword may affect the security of your backend,
+    as it removes the normal limited protection against URL-based attacks
     provided by the proxy.</p>
 
     <p>When used inside a <directive type="section" module="core"
     >Location</directive> section, the first argument is omitted and the local
     directory is obtained from the <directive type="section" module="core"
     >Location</directive>. The same will occur inside a
-    <directive type="section" module="core">LocationMatch</directive> section,
-    however ProxyPass does not interpret the regexp as such, so it is necessary
+    <directive type="section" module="core">LocationMatch</directive> section;
+    however, ProxyPass does not interpret the regexp as such, so it is necessary
     to use <directive>ProxyPassMatch</directive> in this situation instead.</p>
   
     <p>This directive is not supported in <directive type="section" module="core"
@@ -1093,7 +1097,7 @@ expressions</description>
 
     <p>The optional <var>interpolate</var> keyword (available in
     httpd 2.2.9 and later), in combination with
-    <directive>ProxyPassInterpolateEnv</directive> causes the ProxyPass
+    <directive>ProxyPassInterpolateEnv</directive>, causes the ProxyPass
     to interpolate environment variables, using the syntax
     <var>${VARNAME}</var>.  Note that many of the standard CGI-derived
     environment variables will not exist when this interpolation happens,
@@ -1129,8 +1133,8 @@ ProxyPassReverse  /mirror/foo/ https://b
 <compatibility>available in Apache 2.2.5 and later</compatibility>
 
 <usage>
-    <p>This directive is equivalent to <directive module="mod_proxy">ProxyPass</directive>,
-       but makes use of regular expressions, instead of simple prefix matching. The
+    <p>This directive is equivalent to <directive module="mod_proxy">ProxyPass</directive>
+       but makes use of regular expressions instead of simple prefix matching. The
        supplied regular expression is matched against the <var>url</var>, and
if it
        matches, the server will substitute any parenthesized matches into the given
        string and use it as a new <var>url</var>.</p>
@@ -1177,7 +1181,7 @@ ProxyPassReverse  /mirror/foo/ https://b
       <p>Take care when constructing the target URL of the rule, considering
         the security impact from allowing the client influence over the set of
         URLs to which your server will act as a proxy.  Ensure that the scheme
-        and hostname part of the URL is either fixed, or does not allow the
+        and hostname part of the URL is either fixed or does not allow the
         client undue influence.</p>
     </note>
 </usage>
@@ -1197,7 +1201,7 @@ proxied server</description>
     <p>This directive lets Apache adjust the URL in the <code>Location</code>,
     <code>Content-Location</code> and <code>URI</code> headers on
HTTP
     redirect responses. This is essential when Apache is used as a
-    reverse proxy (or gateway) to avoid by-passing the reverse proxy
+    reverse proxy (or gateway) to avoid bypassing the reverse proxy
     because of HTTP redirects on the backend servers which stay behind
     the reverse proxy.</p>
 
@@ -1205,14 +1209,14 @@ proxied server</description>
     will be rewritten.  Apache will not rewrite other response
     headers, nor will it rewrite URL references inside HTML pages.
     This means that if the proxied content contains absolute URL
-    references, they will by-pass the proxy.  A third-party module
+    references, they will bypass the proxy.  A third-party module
     that will look inside the HTML and rewrite URL references is Nick
     Kew's <a href="http://apache.webthing.com/mod_proxy_html/"
     >mod_proxy_html</a>.</p>
 
-    <p><var>path</var> is the name of a local virtual path. <var>url</var>
is a
-    partial URL for the remote server - the same way they are used for the
-    <directive module="mod_proxy">ProxyPass</directive> directive.</p>
+    <p><var>path</var> is the name of a local virtual path; <var>url</var>
is a
+    partial URL for the remote server. These parameters are used the same way as
+    for the <directive module="mod_proxy">ProxyPass</directive> directive.</p>
 
     <p>For example, suppose the local server has address
     <code>http://example.com/</code>; then</p>
@@ -1227,17 +1231,17 @@ proxied server</description>
     <p>will not only cause a local request for the
     <code>http://example.com/mirror/foo/bar</code> to be internally converted
     into a proxy request to <code>http://backend.example.com/bar</code>
-    (the functionality <code>ProxyPass</code> provides here). It also takes care
-    of redirects the server <code>backend.example.com</code> sends: when
-    <code>http://backend.example.com/bar</code> is redirected by him to
-    <code>http://backend.example.com/quux</code> Apache adjusts this to
+    (the functionality which <code>ProxyPass</code> provides here). It also
+    takes care of redirects which the server <code>backend.example.com</code>
+    sends when redirecting <code>http://backend.example.com/bar</code> to
+    <code>http://backend.example.com/quux</code> . Apache adjusts this to
     <code>http://example.com/mirror/foo/quux</code> before forwarding the HTTP
     redirect response to the client. Note that the hostname used for
     constructing the URL is chosen in respect to the setting of the <directive
     module="core">UseCanonicalName</directive> directive.</p>
 
     <p>Note that this <directive>ProxyPassReverse</directive> directive
can
-    also be used in conjunction with the proxy pass-through feature
+    also be used in conjunction with the proxy feature
     (<code>RewriteRule ...  [P]</code>) from <module>mod_rewrite</module>
     because it doesn't depend on a corresponding <directive module="mod_proxy"
     >ProxyPass</directive> directive.</p>
@@ -1256,7 +1260,7 @@ proxied server</description>
     module="core">LocationMatch</directive> section, but will probably not work
as
     intended, as ProxyPassReverse will interpret the regexp literally as a
     path; if needed in this situation, specify the ProxyPassReverse outside
-    the section, or in a separate <directive type="section" module="core"
+    the section or in a separate <directive type="section" module="core"
     >Location</directive> section.</p>
 
     <p>This directive is not supported in <directive type="section" module="core"
@@ -1410,14 +1414,14 @@ connections</description>
 
 <usage>
     <p>The <directive>ProxyIOBufferSize</directive> directive adjusts the
size
-    of the internal buffer, which is used as a scratchpad for the data between
+    of the internal buffer which is used as a scratchpad for the data between
     input and output. The size must be at least <code>8192</code>.</p>
 
     <p>When the <module>mod_proxy_ajp</module> module is used, this value
is
     aligned to a 1024 byte boundary, and values larger than 65536 are set to
     65536 in accordance with the AJP protocol.</p>
 
-    <p>In almost every case there's no reason to change that value.</p>
+    <p>In almost every case, there's no reason to change that value.</p>
 </usage>
 </directivesynopsis>
 
@@ -1434,9 +1438,9 @@ through</description>
 
 <usage>
     <p>The <directive>ProxyMaxForwards</directive> directive specifies
the
-    maximum number of proxies through which a request may pass, if there's no
+    maximum number of proxies through which a request may pass if there's no
     <code>Max-Forwards</code> header supplied with the request. This may
-    be set to prevent infinite proxy loops, or a DoS attack.</p>
+    be set to prevent infinite proxy loops or a DoS attack.</p>
 
     <example><title>Example</title>
       ProxyMaxForwards 15
@@ -1447,7 +1451,7 @@ through</description>
     setting <code>Max-Forwards</code> if the Client didn't set it.
     Earlier Apache versions would always set it.  A negative
     <directive>ProxyMaxForwards</directive> value, including the
-    default -1, gives you protocol-compliant behaviour, but may
+    default -1, gives you protocol-compliant behavior but may
     leave you open to loops.</p>
 </usage>
 </directivesynopsis>
@@ -1497,7 +1501,7 @@ directly</description>
     <note><title>Note</title>
       <p>Domain name comparisons are done without regard to the case, and
       <var>Domain</var>s are always assumed to be anchored in the root of the
-      DNS tree, therefore two domains <code>.ExAmple.com</code> and
+      DNS tree; therefore, the two domains <code>.ExAmple.com</code> and
       <code>.example.com.</code> (note the trailing period) are considered
       equal. Since a domain comparison does not involve a DNS lookup, it is much
       more efficient than subnet comparison.</p>
@@ -1567,7 +1571,7 @@ directly</description>
       link.</p>
       <p><var>Hostname</var> comparisons are done without regard to the
case,
       and <var>Hostname</var>s are always assumed to be anchored in the root
-      of the DNS tree, therefore two hosts <code>WWW.ExAmple.com</code>
+      of the DNS tree; therefore, the two hosts <code>WWW.ExAmple.com</code>
       and <code>www.example.com.</code> (note the trailing period) are
       considered equal.</p>
      </note></dd>
@@ -1661,13 +1665,13 @@ header for proxied requests</description
 <compatibility>Available in version 2.0 and later</compatibility>
 
 <usage>
-    <p>This directive is useful for reverse-proxy setups, where you want to 
+    <p>This directive is useful for reverse-proxy setups where you want to 
     have a common look and feel on the error pages seen by the end user. 
     This also allows for included files (via
     <module>mod_include</module>'s SSI) to get
-    the error code and act accordingly (default behavior would display
-    the error page of the proxied server, turning this on shows the SSI
-    Error message).</p>
+    the error code and act accordingly. (Default behavior would display
+    the error page of the proxied server. Turning this on shows the SSI
+    Error message.)</p>
 
     <p>This directive does not affect the processing of informational (1xx),
     normal success (2xx), or redirect (3xx) responses.</p>
@@ -1688,18 +1692,18 @@ header for proxied requests</description
 <usage>
     <p>This directive, together with the <var>interpolate</var> argument
to
     <directive>ProxyPass</directive>, <directive>ProxyPassReverse</directive>,
-    <directive>ProxyPassReverseCookieDomain</directive> and
-    <directive>ProxyPassReverseCookiePath</directive>
+    <directive>ProxyPassReverseCookieDomain</directive>, and
+    <directive>ProxyPassReverseCookiePath</directive>,
     enables reverse proxies to be dynamically
-    configured using environment variables, which may be set by
+    configured using environment variables which may be set by
     another module such as <module>mod_rewrite</module>.
     It affects the <directive>ProxyPass</directive>,
     <directive>ProxyPassReverse</directive>,
     <directive>ProxyPassReverseCookieDomain</directive>, and
-    <directive>ProxyPassReverseCookiePath</directive> directives,
+    <directive>ProxyPassReverseCookiePath</directive> directives
     and causes them to substitute the value of an environment
     variable <code>varname</code> for the string <code>${varname}</code>
-    in configuration directives (if the <var>interpolate</var> option is set).</p>
+    in configuration directives if the <var>interpolate</var> option is set.</p>
     <p>Keep this turned off (for server performance) unless you need it!</p>
 </usage>
 </directivesynopsis>



Mime
View raw message