diff xml/en/docs/http/ngx_http_memcached_module.xml @ 966:95c3c3bbf1ce

Text review.
author Egor Nikitin <yegor.nikitin@gmail.com>
date Wed, 14 Aug 2013 12:03:41 +0400
parents ba3d6ade3513
children 1501e5848052
line wrap: on
line diff
--- a/xml/en/docs/http/ngx_http_memcached_module.xml	Wed Aug 14 17:21:19 2013 +0400
+++ b/xml/en/docs/http/ngx_http_memcached_module.xml	Wed Aug 14 12:03:41 2013 +0400
@@ -15,10 +15,10 @@
 <section id="summary">
 
 <para>
-The <literal>ngx_http_memcached_module</literal> module allows to obtain
+The <literal>ngx_http_memcached_module</literal> module is used to obtain
 responses from a memcached server.
 The key is set in the <var>$memcached_key</var> variable.
-A response should be put in memcached in advance via means that are
+A response should be put in memcached in advance by means
 external to nginx.
 </para>
 
@@ -57,13 +57,13 @@
 <appeared-in>0.8.22</appeared-in>
 
 <para>
-Forces outgoing connections to a memcached server to originate
+Makes outgoing connections to a memcached server originate
 from the specified local IP <value>address</value>.
-Value of the parameter can contain variables (1.3.12).
+Parameter value can contain variables (1.3.12).
 The special value <literal>off</literal> (1.3.12) cancels the effect
 of the <literal>memcached_bind</literal> directive
-inherited from the previous configuration level, allowing the
-system to auto-assign local address.
+inherited from the previous configuration level, which allows the
+system to auto-assign the local IP address.
 </para>
 
 </directive>
@@ -77,9 +77,9 @@
 <context>location</context>
 
 <para>
-Sets <value>size</value> of the buffer used for reading a response
+Sets the <value>size</value> of the buffer used for reading a response
 received from the memcached server.
-A response is passed to a client synchronously, immediately as it is received.
+A response is passed to a client synchronously, as soon as it is received.
 </para>
 
 </directive>
@@ -93,7 +93,7 @@
 <context>location</context>
 
 <para>
-Defines a timeout for establishing a connection with the memcached server.
+Defines a timeout for establishing a connection with a memcached server.
 It should be noted that this timeout cannot usually exceed 75 seconds.
 </para>
 
@@ -110,8 +110,8 @@
 
 <para>
 Enables the test for the <value>flag</value> presence in the memcached
-server response and sets the response header field
-“<literal>Content-Encoding</literal>” to “<literal>gzip</literal>”
+server response and sets the “<literal>Content-Encoding</literal>”
+response header field to “<literal>gzip</literal>”
 if the flag is set.
 </para>
 
@@ -137,14 +137,14 @@
 
 <tag-name><literal>error</literal></tag-name>
 <tag-desc>an error occurred while establishing a connection with the
-server, passing it a request, or reading the response header;</tag-desc>
+server, passing a request to it, or reading the response header;</tag-desc>
 
 <tag-name><literal>timeout</literal></tag-name>
 <tag-desc>a timeout has occurred while establishing a connection with the
-server, passing it a request, or reading the response header;</tag-desc>
+server, passing a request to it, or reading the response header;</tag-desc>
 
 <tag-name><literal>invalid_response</literal></tag-name>
-<tag-desc>a server returned empty or invalid response;</tag-desc>
+<tag-desc>a server returned an empty or invalid response;</tag-desc>
 
 <tag-name><literal>not_found</literal></tag-name>
 <tag-desc>a response was not found on the server;</tag-desc>
@@ -156,10 +156,10 @@
 </para>
 
 <para>
-It should be understood that passing a request to the next server is
-only possible if a client was not sent anything yet.
-That is, if an error or a timeout occurs in the middle of
-transferring a response, fixing this is impossible.
+One should bear in mind that passing a request to the next server is
+only possible if nothing has been sent to a client yet.
+That is, if an error or timeout occurs in the middle of the
+transferring of a response, fixing this is impossible.
 </para>
 
 <para>
@@ -183,9 +183,8 @@
 <context>if in location</context>
 
 <para>
-Sets an address of the memcached server.
-An address can be specified as a domain name or an address, and a port,
-for example,
+Sets the memcached server address.
+The address can be specified as a domain name or an address, and a port:
 <example>
 memcached_pass localhost:11211;
 </example>
@@ -214,10 +213,10 @@
 
 <para>
 Defines a timeout for reading a response from the memcached server.
-A timeout is only set between two successive read operations,
+A timeout is set only between two successive read operations,
 not for the transmission of the whole response.
 If a memcached server does not transmit anything within this time,
-a connection is closed.
+the connection is closed.
 </para>
 
 </directive>
@@ -232,7 +231,7 @@
 
 <para>
 Sets a timeout for transmitting a request to the memcached server.
-A timeout is only set between two successive write operations,
+A timeout is set only between two successive write operations,
 not for the transmission of the whole request.
 If a memcached server does not receive anything within this time,
 a connection is closed.