--- a/xml/en/docs/http/ngx_http_core_module.xml	Thu Aug 02 06:27:12 2012 +0000
+++ b/xml/en/docs/http/ngx_http_core_module.xml	Thu Aug 02 13:24:07 2012 +0000
@@ -1152,14 +1152,13 @@
 
 <para>
 A <literal>listen</literal> directive
-can have several additional parameters specific to system calls
-<c-func>listen</c-func> and <c-func>bind</c-func>.
+can have several additional parameters specific to socket-related system calls.
 They can be specified in any
 <literal>listen</literal> directive, but only once for the given
 <value>address</value>:<value>port</value> pair.
 <note>
 In versions prior to 0.8.21, they could only be
-specified in the <literal>listen</literal> directive with the
+specified in the <literal>listen</literal> directive along with the
 <literal>default</literal> parameter.
 </note>
 <list type="tag">
@@ -1168,8 +1167,8 @@
 <literal>setfib</literal>=<value>number</value>
 </tag-name>
 <tag-desc>
-this parameter (0.8.44) sets the associated FIB (routing table)
-for the listening socket.
+this parameter (0.8.44) sets an associated routing table, FIB 
+(the <c-def>SO_SETFIB</c-def> option) for the listening socket.
 This currently works only on FreeBSD.
 </tag-desc>
 
@@ -1178,43 +1177,49 @@
 </tag-name>
 <tag-desc>
 sets the <literal>backlog</literal> parameter in the
-<c-func>listen</c-func> call.
-By default, <literal>backlog</literal> equals -1 on FreeBSD
-and 511 on other platforms.
+<c-func>listen</c-func> call that limits
+the maximum length for the queue of pending connections.
+By default, <literal>backlog</literal> is set to -1 on FreeBSD,
+and to 511 on other platforms.
 </tag-desc>
 
 <tag-name>
 <literal>rcvbuf</literal>=<value>size</value>
 </tag-name>
 <tag-desc>
-sets the <c-def>SO_RCVBUF</c-def> parameter for the listening socket.
+sets receive buffer size
+(the <c-def>SO_RCVBUF</c-def> option) for the listening socket.
 </tag-desc>
 
 <tag-name>
 <literal>sndbuf</literal>=<value>size</value>
 </tag-name>
 <tag-desc>
-sets the <c-def>SO_SNDBUF</c-def> parameter for the listening socket.
+sets send buffer size
+(the <c-def>SO_SNDBUF</c-def> option) for the listening socket.
 </tag-desc>
 
 <tag-name>
 <literal>accept_filter</literal>=<value>filter</value>
 </tag-name>
 <tag-desc>
-sets the name of the accept filter.
-This works only on FreeBSD, acceptable values are <literal>dataready</literal>
-and <literal>httpready</literal>.
-On receipt of the <c-def>SIGHUP</c-def> signal, an accept filter can only be
-changed in recent versions of FreeBSD, starting from 6.0, 5.4-STABLE
-and 4.11-STABLE.
+sets the name of accept filter
+(the <c-def>SO_ACCEPTFILTER</c-def> option) for the listening socket
+that filters incoming connections before presenting them to
+<c-func>accept</c-func>.
+This works only on FreeBSD and NetBSD 5.0+.
+Acceptable values are
+<link url="http://man.freebsd.org/accf_data">dataready</link>
+and
+<link url="http://man.freebsd.org/accf_http">httpready</link>.
 </tag-desc>
 
 <tag-name>
 <literal>deferred</literal>
 </tag-name>
 <tag-desc>
-instructs to use a deferred <c-func>accept</c-func> on Linux
-using the <c-def>TCP_DEFER_ACCEPT</c-def> option.
+instructs to use a deferred <c-func>accept</c-func>
+(the <c-def>TCP_DEFER_ACCEPT</c-def> socket option) on Linux.
 </tag-desc>
 
 <tag-name>
@@ -1244,31 +1249,29 @@
 <literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>
 </tag-name>
 <tag-desc>
-this parameter (0.7.42) sets the value of the <c-def>IPV6_V6ONLY</c-def>
-parameter for the listening socket.
-It is turned on by default.
-This parameter can only be set once on start.
+this parameter (0.7.42) determines
+(via the <c-def>IPV6_V6ONLY</c-def> socket option)
+whether IPv6 socket listening on a wildcard address <literal>[::]</literal>
+will accept only IPv6 connections, or both IPv6 and IPv4 connections.
+This parameter is turned on by default.
+It can only be set once on start.
 <note>
-Prior to version 1.3.4, if parameter was not set explicitly,
-operating system’s setting was used.
+Prior to version 1.3.4,
+if this parameter was omitted then the operating system’s settings were
+in effect for the socket.
 </note>
-
 </tag-desc>
 
 <tag-name>
 <literal>ssl</literal>
 </tag-name>
 <tag-desc>
-this parameter (0.7.14) does not relate to system calls
-<c-func>listen</c-func> and <c-func>bind</c-func>, but allows to
-specify that all connections accepted on this port should work in
-the SSL mode.
-This allows for a more compact configuration for the server operating
-in both HTTP and HTTPS modes simultaneously.
-<example>
-listen 80;
-listen 443 ssl;
-</example>
+this parameter (0.7.14) does not relate to socket-related system calls,
+but allows to specify that all connections accepted on this port
+should work in SSL mode.
+This allows for a more compact <link doc="configuring_https_servers.xml"
+id="single_http_https_server">configuration</link> for the server that
+handles both HTTP and HTTPS requests.
 </tag-desc>
 
 <tag-name>
@@ -1277,7 +1280,7 @@
 <tag-desc>
 this parameter (1.1.11) configures the “TCP keepalive” behavior
 for the listening socket.
-If this parameter is omitted then the system default setting will be
+If this parameter is omitted then the operating system’s settings will be
 in effect for the socket.
 If set to the value “<literal>on</literal>”, the <c-def>SO_KEEPALIVE</c-def>
 socket option is turned on for the socket.
@@ -1305,7 +1308,7 @@
 <para>
 Example:
 <example>
-listen 127.0.0.1 default accept_filter=dataready backlog=1024;
+listen 127.0.0.1 default_server accept_filter=dataready backlog=1024;
 </example>
 </para>
 

--- a/xml/en/index.xml	Thu Aug 02 06:27:12 2012 +0000
+++ b/xml/en/index.xml	Thu Aug 02 13:24:07 2012 +0000
@@ -287,7 +287,7 @@
 </listitem>
 
 <listitem>
-Accept-filters (FreeBSD 4.1+) and TCP_DEFER_ACCEPT (Linux 2.4+)
+Accept-filters (FreeBSD 4.1+, NetBSD 5.0+) and TCP_DEFER_ACCEPT (Linux 2.4+)
 <link doc="docs/http/ngx_http_core_module.xml" id="listen">support</link>;
 </listitem>
 

--- a/xml/ru/docs/http/ngx_http_core_module.xml	Thu Aug 02 06:27:12 2012 +0000
+++ b/xml/ru/docs/http/ngx_http_core_module.xml	Thu Aug 02 13:24:07 2012 +0000
@@ -1134,14 +1134,14 @@
 
 <para>
 В директиве <literal>listen</literal> можно также указать несколько
-дополнительных параметров, специфичных для системных вызовов
-<c-func>listen</c-func> и <c-func>bind</c-func>.
+дополнительных параметров, специфичных для связанных с сокетами
+системных вызовов.
 Эти параметры можно задать в любой директиве <literal>listen</literal>,
 но только один раз для указанной пары
 <value>адрес</value>:<value>порт</value>.
 <note>
 До версии 0.8.21 их можно было указывать лишь в директиве
-<literal>listen</literal> с параметром <literal>default</literal>.
+<literal>listen</literal> совместно с параметром <literal>default</literal>.
 </note>
 <list type="tag">
 
@@ -1149,8 +1149,8 @@
 <literal>setfib</literal>=<value>число</value>
 </tag-name>
 <tag-desc>
-этот параметр (0.8.44) задаёт для слушающего сокета соответствующую
-таблицу маршрутизации (FIB).
+этот параметр (0.8.44) задаёт таблицу маршрутизации, FIB
+(параметр <c-def>SO_SETFIB</c-def>) для слушающего сокета.
 В настоящий момент это работает только на FreeBSD.
 </tag-desc>
 
@@ -1159,8 +1159,9 @@
 </tag-name>
 <tag-desc>
 задаёт параметр <literal>backlog</literal> в вызове
-<c-func>listen</c-func>.
-По умолчанию <literal>backlog</literal> равен -1 для FreeBSD
+<c-func>listen</c-func>, который ограничивает
+максимальный размер очереди ожидающих приёма соединений.
+По умолчанию <literal>backlog</literal> устанавливается равным -1 для FreeBSD
 и 511 для других платформ.
 </tag-desc>
 
@@ -1168,33 +1169,39 @@
 <literal>rcvbuf</literal>=<value>размер</value>
 </tag-name>
 <tag-desc>
-задаёт параметр <c-def>SO_RCVBUF</c-def> для слушающего сокета
+задаёт размер буфера приёма
+(параметр <c-def>SO_RCVBUF</c-def>) для слушающего сокета.
 </tag-desc>
 
 <tag-name>
 <literal>sndbuf</literal>=<value>размер</value>
 </tag-name>
 <tag-desc>
-задаёт параметр <c-def>SO_SNDBUF</c-def> для слушающего сокета
+задаёт размер буфера передачи
+(параметр <c-def>SO_SNDBUF</c-def>) для слушающего сокета.
 </tag-desc>
 
 <tag-name>
 <literal>accept_filter</literal>=<value>фильтр</value>
 </tag-name>
 <tag-desc>
-задаёт название accept-фильтра.
-Работает только на FreeBSD, можно использовать два фильтра —
-<literal>dataready</literal> и <literal>httpready</literal>.
-По сигналу <c-def>SIGHUP</c-def> accept-фильтр можно менять только в
-последних версиях FreeBSD, начиная с 6.0, 5.4-STABLE и 4.11-STABLE.
+задаёт название accept-фильтра
+(параметр <c-def>SO_ACCEPTFILTER</c-def>) для слушающего сокета,
+который включается для фильтрации входящих соединений
+перед передачей их в <c-func>accept</c-func>.
+Работает только на FreeBSD и NetBSD 5.0+.
+Можно использовать два фильтра —
+<link url="http://man.freebsd.org/accf_data">dataready</link>
+и
+<link url="http://man.freebsd.org/accf_http">httpready</link>.
 </tag-desc>
 
 <tag-name>
 <literal>deferred</literal>
 </tag-name>
 <tag-desc>
-указывает использовать отложенный <c-func>accept</c-func> на Linux
-с помощью опции <c-def>TCP_DEFER_ACCEPT</c-def>.
+указывает использовать отложенный <c-func>accept</c-func>
+(параметр <c-def>TCP_DEFER_ACCEPT</c-def> сокета) на Linux.
 </tag-desc>
 
 <tag-name>
@@ -1223,12 +1230,15 @@
 <literal>ipv6only</literal>=<literal>on</literal>|<literal>off</literal>
 </tag-name>
 <tag-desc>
-параметр (0.7.42) задаёт значение параметра <c-def>IPV6_V6ONLY</c-def>
-для слушающего сокета.
+этот параметр (0.7.42) определяет
+(через параметр сокета <c-def>IPV6_V6ONLY</c-def>),
+будет ли слушающий на wildcard-адресе <literal>[::]</literal> IPv6-сокет
+принимать только IPv6-соединения, или же одновременно IPv6- и IPv4-соединения.
 По умолчанию параметр включён.
-Установить этот параметр можно только один раз на старте.
+Установить его можно только один раз на старте.
 <note>
-До версии 1.3.4, если параметр не был задан явно, использовались
+До версии 1.3.4,
+если этот параметр не был задан явно, то для сокета действовали
 настройки операционной системы.
 </note>
 </tag-desc>
@@ -1237,16 +1247,12 @@
 <literal>ssl</literal>
 </tag-name>
 <tag-desc>
-этот параметр (0.7.14) не имеет отношения к системным вызовам
-<c-func>listen</c-func> и <c-func>bind</c-func>, а позволяет указать,
-что все соединения, принимаемые на этом порту, должны работать
-в режиме SSL.
-Это позволяет задать компактную конфигурацию для сервера,
+этот параметр (0.7.14) не имеет отношения к связанным с сокетами системным
+вызовам, а позволяет указать, что все соединения, принимаемые на этом порту,
+должны работать в режиме SSL.
+Это позволяет задать компактную <link doc="configuring_https_servers.xml"
+id="single_http_https_server">конфигурацию</link> для сервера,
 работающего сразу в двух режимах — HTTP и HTTPS.
-<example>
-listen 80;
-listen 443 ssl;
-</example>
 </tag-desc>
 
 <tag-name>
@@ -1256,13 +1262,13 @@
 этот параметр (1.1.11) конфигурирует для слушающего сокета
 поведение “TCP keepalive”.
 Если этот параметр опущен, то для сокета будут действовать
-стандартные системные настройки.
+настройки операционной системы.
 Если он установлен в значение “<literal>on</literal>”, то для сокета
-включается опция <c-def>SO_KEEPALIVE</c-def>.
+включается параметр <c-def>SO_KEEPALIVE</c-def>.
 Если он установлен в значение “<literal>off</literal>”, то для сокета
-опция <c-def>SO_KEEPALIVE</c-def> выключается.
+параметр <c-def>SO_KEEPALIVE</c-def> выключается.
 Некоторые операционные системы поддерживают настройку параметров
-“TCP keepalive” на уровне сокета посредством опций
+“TCP keepalive” на уровне сокета посредством параметров
 <c-def>TCP_KEEPIDLE</c-def>, <c-def>TCP_KEEPINTVL</c-def> и
 <c-def>TCP_KEEPCNT</c-def>.
 На таких системах (в настоящий момент это Linux 2.4+, NetBSD 5+ и
@@ -1270,7 +1276,7 @@
 их можно сконфигурировать с помощью параметров <value>keepidle</value>,
 <value>keepintvl</value> и <value>keepcnt</value>.
 Один или два параметра могут быть опущены, в таком случае для
-соответствующей опции сокета будут действовать стандартные
+соответствующего параметра сокета будут действовать стандартные
 системные настройки.
 Например,
 <example>so_keepalive=30m::10</example>
@@ -1286,7 +1292,7 @@
 <para>
 Пример:
 <example>
-listen 127.0.0.1 default accept_filter=dataready backlog=1024;
+listen 127.0.0.1 default_server accept_filter=dataready backlog=1024;
 </example>
 </para>
 
@@ -1829,7 +1835,7 @@
 <para>
 Разрешает или запрещает сброс соединений по таймауту.
 Сброс делается следующим образом — перед закрытием сокета для него
-ставится опция
+ставится параметр
 <c-def>SO_LINGER</c-def>
 с таймаутом 0.
 После чего при закрытии сокета клиенту отсылается TCP RST, а вся память,
@@ -1997,7 +2003,7 @@
 число операций отправки на клиентских сокетах либо при помощи флага
 <c-def>NOTE_LOWAT</c-def> метода
 <link doc="../events.xml" id="kqueue"/>,
-либо при помощи опции сокета <c-def>SO_SNDLOWAT</c-def>,
+либо при помощи параметра сокета <c-def>SO_SNDLOWAT</c-def>,
 с указанным размером.
 </para>
 
@@ -2295,8 +2301,8 @@
 <context>location</context>
 
 <para>
-Разрешает или запрещает использование опции <c-def>TCP_NODELAY</c-def>.
-Опция включаются только при переходе соединения в состояние keep-alive.
+Разрешает или запрещает использование параметра <c-def>TCP_NODELAY</c-def>.
+Параметр включаются только при переходе соединения в состояние keep-alive.
 </para>
 
 </directive>
@@ -2310,11 +2316,11 @@
 <context>location</context>
 
 <para>
-Разрешает или запрещает использование опции сокета
+Разрешает или запрещает использование параметра сокета
 <c-def>TCP_NOPUSH</c-def> во FreeBSD или
 <c-def>TCP_CORK</c-def> в Linux.
-Опции включаются только при использовании <link id="sendfile"/>.
-Включение опции позволяет
+Параметр включаются только при использовании <link id="sendfile"/>.
+Включение параметра  позволяет
 <list type="bullet">
 
 <listitem>
@@ -2845,7 +2851,7 @@
 </tag-name>
 <tag-desc>
 информация о клиентском TCP-соединении; доступна на системах,
-поддерживающих опцию сокета <c-def>TCP_INFO</c-def>
+поддерживающих параметр сокета <c-def>TCP_INFO</c-def>
 </tag-desc>
 
 <tag-name><var>$uri</var></tag-name>

--- a/xml/ru/index.xml	Thu Aug 02 06:27:12 2012 +0000
+++ b/xml/ru/index.xml	Thu Aug 02 13:24:07 2012 +0000
@@ -290,7 +290,7 @@
 
 <listitem>
 <link doc="docs/http/ngx_http_core_module.xml" id="listen">Поддержка</link>
-accept-фильтров (FreeBSD 4.1+) и TCP_DEFER_ACCEPT (Linux 2.4+);
+accept-фильтров (FreeBSD 4.1+, NetBSD 5.0+) и TCP_DEFER_ACCEPT (Linux 2.4+);
 </listitem>
 
 <listitem>