changeset 804:d22421dc5d00

Clarified the effects of the "env" directive.
author Ruslan Ermilov <ru@nginx.com>
date Fri, 28 Dec 2012 13:51:56 +0000
parents 6c3349baa1d3
children 26b8f81ede9b
files xml/en/docs/ngx_core_module.xml xml/ru/docs/ngx_core_module.xml
diffstat 2 files changed, 19 insertions(+), 14 deletions(-) [+]
line wrap: on
line diff
--- 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
--- 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>
-использование переменных рабочими процессами.
-Однако нужно иметь в виду, что управление поведением системных библиотек
+используются рабочими процессами.
+Следует иметь в виду, что управление поведением системных библиотек
 подобным образом возможно не всегда, поскольку зачастую библиотеки используют
 переменные только во время инициализации, то есть ещё до того, как их
 можно задать с помощью данной директивы.