# HG changeset patch
# User Ruslan Ermilov <ru@nginx.com>
# Date 1356702716 0
# Node ID d22421dc5d00de844c1806f0a58eef371d40e864
# Parent  6c3349baa1d3365729df91f95c1e7824790a84a8
Clarified the effects of the "env" directive.

diff -r 6c3349baa1d3 -r d22421dc5d00 xml/en/docs/ngx_core_module.xml
--- a/xml/en/docs/ngx_core_module.xml	Fri Dec 28 13:18:15 2012 +0000
+++ b/xml/en/docs/ngx_core_module.xml	Fri Dec 28 13:51:56 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Core functionality"
         link="/en/docs/ngx_core_module.html"
         lang="en"
-        rev="5">
+        rev="6">
 
 <section id="example" name="Example Configuration">
 
@@ -195,23 +195,25 @@
 <context>main</context>
 
 <para>
-Allows to limit a set of environment variables, change their values,
-or create new environment variables, for the following cases:
+By default, nginx removes all environment variables inherited
+from its parent process except the TZ variable.
+This directive allows to preserve some of the inherited variables,
+change their values, or create new environment variables.
+These variables are then:
 <list type="bullet">
 
 <listitem>
-variable inheritance during a
-<link doc="control.xml" id="upgrade">live upgrade</link>
+inherited during a <link doc="control.xml" id="upgrade">live upgrade</link>
 of an executable file;
 </listitem>
 
 <listitem>
-use of variables by the module
+used by the module
 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>;
 </listitem>
 
 <listitem>
-use of variables by worker processes.
+used by worker processes.
 Please bear in mind that controlling system libraries in this way
 is not always possible as it is not uncommon for libraries to check
 variables only during initialization, well before they can be set
diff -r 6c3349baa1d3 -r d22421dc5d00 xml/ru/docs/ngx_core_module.xml
--- a/xml/ru/docs/ngx_core_module.xml	Fri Dec 28 13:18:15 2012 +0000
+++ b/xml/ru/docs/ngx_core_module.xml	Fri Dec 28 13:51:56 2012 +0000
@@ -10,7 +10,7 @@
 <module name="Основная функциональность"
         link="/ru/docs/ngx_core_module.html"
         lang="ru"
-        rev="5">
+        rev="6">
 
 <section id="example" name="Пример конфигурации">
 
@@ -194,23 +194,26 @@
 <context>main</context>
 
 <para>
-Позволяет ограничить набор переменных окружения, поменять им значения
-или же создать новые переменные окружения для следующих случаев:
+По умолчанию nginx удаляет все переменные окружения, унаследованные
+от своего родительского процесса, кроме переменной TZ.
+Эта директива позволяет сохранить часть унаследованных переменных,
+поменять им значения или же создать новые переменные окружения.
+Эти переменные затем:
 <list type="bullet">
 
 <listitem>
-наследование переменных во время
+наследуются во время
 <link doc="control.xml" id="upgrade">обновления исполняемого файла на лету</link>;
 </listitem>
 
 <listitem>
-использование переменных модулем
+используются модулем
 <link doc="http/ngx_http_perl_module.xml">ngx_http_perl_module</link>;
 </listitem>
 
 <listitem>
-использование переменных рабочими процессами.
-Однако нужно иметь в виду, что управление поведением системных библиотек
+используются рабочими процессами.
+Следует иметь в виду, что управление поведением системных библиотек
 подобным образом возможно не всегда, поскольку зачастую библиотеки используют
 переменные только во время инициализации, то есть ещё до того, как их
 можно задать с помощью данной директивы.