--- a/xml/en/docs/http/ngx_http_core_module.xml	Tue Jun 05 21:42:57 2012 +0000
+++ b/xml/en/docs/http/ngx_http_core_module.xml	Tue Jun 05 22:11:50 2012 +0000
@@ -1845,22 +1845,28 @@
 <context>location</context>
 
 <para>
-Configures name servers used to resolve names of upstream servers,
-for example:
+Configures name servers used to resolve names of upstream servers
+into addresses, for example:
 <example>
-resolver 127.0.0.1 192.0.2.1;
+resolver 127.0.0.1 [::1]:5353;
 </example>
-An <value>address</value> parameter may be specified as
-either an IPv4 address or a hostname;
-in the latter case, the first resolved IPv4 address is used.
+An address can be specified as a domain name or IP address,
+and an optional port (1.3.1).
+<!--
+If address is specified using a domain name, only the first
+resolved IPv4 address is used.
+-->
+If port is not specified, the port 53 is used.
 Name servers are queried in a round-robin fashion.
 <note>
 Before version 1.1.7, only a single name server could be configured.
+Specifying name servers using IPv6 addresses is supported
+starting from version 1.3.1.
 </note>
 By default, nginx caches answers using the TTL value of a response.
 An optional <literal>valid</literal> parameter allows to override it:
 <example>
-resolver 127.0.0.1 192.0.2.1 valid=30s;
+resolver 127.0.0.1 [::1]:5353 valid=30s;
 </example>
 <note>
 Before version 1.1.9, tuning of caching time was not possible,