# HG changeset patch # User Ruslan Ermilov # Date 1600692307 -10800 # Node ID eeed494bba5127b189abe7cf9eff01eccf8a79e1 # Parent fca42223b9fc18693bbe9e9d64c37d0d7c3c243f Unified phrases about configuration levels and inheritance. diff --git a/xml/en/docs/http/ngx_http_auth_basic_module.xml b/xml/en/docs/http/ngx_http_auth_basic_module.xml --- a/xml/en/docs/http/ngx_http_auth_basic_module.xml +++ b/xml/en/docs/http/ngx_http_auth_basic_module.xml @@ -10,7 +10,7 @@ + rev="10">
@@ -61,7 +61,7 @@ Enables validation of user name and pass “HTTP Basic Authentication” protocol. The specified parameter is used as a realm. Parameter value can contain variables (1.3.10, 1.2.7). -The special value off allows cancelling the effect +The special value off cancels the effect of the auth_basic directive inherited from the previous configuration level. diff --git a/xml/en/docs/http/ngx_http_core_module.xml b/xml/en/docs/http/ngx_http_core_module.xml --- a/xml/en/docs/http/ngx_http_core_module.xml +++ b/xml/en/docs/http/ngx_http_core_module.xml @@ -10,7 +10,7 @@ + rev="92">
@@ -729,10 +729,9 @@ The code 308 was not treated as a redire -These directives are inherited from the previous level if and -only if there are no -error_page -directives defined on the current level. +These directives are inherited from the previous configuration level +if and only if there are no error_page directives +defined on the current level. diff --git a/xml/en/docs/http/ngx_http_fastcgi_module.xml b/xml/en/docs/http/ngx_http_fastcgi_module.xml --- a/xml/en/docs/http/ngx_http_fastcgi_module.xml +++ b/xml/en/docs/http/ngx_http_fastcgi_module.xml @@ -10,7 +10,7 @@ + rev="53">
@@ -1209,10 +1209,9 @@ Can be used along with the + rev="4">
@@ -433,10 +433,9 @@ the connection is closed. Allows redefining or appending fields to the request header passed to the gRPC server. The value can contain text, variables, and their combinations. -These directives are inherited from the previous level if and -only if there are no -grpc_set_header -directives defined on the current level. +These directives are inherited from the previous configuration level +if and only if there are no grpc_set_header directives +defined on the current level. diff --git a/xml/en/docs/http/ngx_http_headers_module.xml b/xml/en/docs/http/ngx_http_headers_module.xml --- a/xml/en/docs/http/ngx_http_headers_module.xml +++ b/xml/en/docs/http/ngx_http_headers_module.xml @@ -10,7 +10,7 @@ + rev="13">
@@ -62,10 +62,9 @@ Parameter value can contain variables. There could be several add_header directives. -These directives are inherited from the previous level if and -only if there are no -add_header -directives defined on the current level. +These directives are inherited from the previous configuration level +if and only if there are no add_header directives +defined on the current level. @@ -95,10 +94,9 @@ Parameter value can contain variables. There could be several add_trailer directives. -These directives are inherited from the previous level if and -only if there are no -add_trailer -directives defined on the current level. +These directives are inherited from the previous configuration level +if and only if there are no add_trailer directives +defined on the current level. diff --git a/xml/en/docs/http/ngx_http_limit_conn_module.xml b/xml/en/docs/http/ngx_http_limit_conn_module.xml --- a/xml/en/docs/http/ngx_http_limit_conn_module.xml +++ b/xml/en/docs/http/ngx_http_limit_conn_module.xml @@ -10,7 +10,7 @@ + rev="14">
@@ -100,10 +100,9 @@ server { -These directives are inherited from the previous level if and -only if there are no -limit_conn -directives on the current level. +These directives are inherited from the previous configuration level +if and only if there are no limit_conn directives +defined on the current level. diff --git a/xml/en/docs/http/ngx_http_limit_req_module.xml b/xml/en/docs/http/ngx_http_limit_req_module.xml --- a/xml/en/docs/http/ngx_http_limit_req_module.xml +++ b/xml/en/docs/http/ngx_http_limit_req_module.xml @@ -10,7 +10,7 @@ + rev="16">
@@ -117,10 +117,9 @@ server { -These directives are inherited from the previous level if and -only if there are no -limit_req -directives on the current level. +These directives are inherited from the previous configuration level +if and only if there are no limit_req directives +defined on the current level. diff --git a/xml/en/docs/http/ngx_http_log_module.xml b/xml/en/docs/http/ngx_http_log_module.xml --- a/xml/en/docs/http/ngx_http_log_module.xml +++ b/xml/en/docs/http/ngx_http_log_module.xml @@ -10,7 +10,7 @@ + rev="21">
@@ -64,7 +64,7 @@ access_log /spool/logs/nginx-access.log Sets the path, format, and configuration for a buffered log write. -Several logs can be specified on the same level. +Several logs can be specified on the same configuration level. Logging to syslog can be configured by specifying the “syslog:” prefix in the first parameter. @@ -160,7 +160,7 @@ is checked, and if it does not exist the created. It is thus a good idea to specify both -and access_log on the same level: +and access_log on the same configuration level: server { root /spool/vhost/data/$host; diff --git a/xml/en/docs/http/ngx_http_mirror_module.xml b/xml/en/docs/http/ngx_http_mirror_module.xml --- a/xml/en/docs/http/ngx_http_mirror_module.xml +++ b/xml/en/docs/http/ngx_http_mirror_module.xml @@ -9,7 +9,7 @@ + rev="4">
@@ -53,7 +53,7 @@ location = /mirror { Sets the URI to which an original request will be mirrored. -Several mirrors can be specified on the same level. +Several mirrors can be specified on the same configuration level. diff --git a/xml/en/docs/http/ngx_http_proxy_module.xml b/xml/en/docs/http/ngx_http_proxy_module.xml --- a/xml/en/docs/http/ngx_http_proxy_module.xml +++ b/xml/en/docs/http/ngx_http_proxy_module.xml @@ -10,7 +10,7 @@ + rev="67">
@@ -1792,10 +1792,9 @@ The value can contain tex Allows redefining or appending fields to the request header passed to the proxied server. The value can contain text, variables, and their combinations. -These directives are inherited from the previous level if and -only if there are no -proxy_set_header -directives defined on the current level. +These directives are inherited from the previous configuration level +if and only if there are no proxy_set_header directives +defined on the current level. By default, only two fields are redefined: proxy_set_header Host $proxy_host; diff --git a/xml/en/docs/http/ngx_http_scgi_module.xml b/xml/en/docs/http/ngx_http_scgi_module.xml --- a/xml/en/docs/http/ngx_http_scgi_module.xml +++ b/xml/en/docs/http/ngx_http_scgi_module.xml @@ -10,7 +10,7 @@ + rev="41">
@@ -1128,10 +1128,9 @@ Can be used along with the + rev="3">
@@ -60,9 +60,9 @@ request header field: Enables the use of the specified session log. -The special value off cancels all -session_log directives inherited from the previous -configuration level. +The special value off cancels the effect +of the session_log directives +inherited from the previous configuration level. diff --git a/xml/en/docs/http/ngx_http_sub_module.xml b/xml/en/docs/http/ngx_http_sub_module.xml --- a/xml/en/docs/http/ngx_http_sub_module.xml +++ b/xml/en/docs/http/ngx_http_sub_module.xml @@ -10,7 +10,7 @@ + rev="6">
@@ -57,9 +57,10 @@ Sets a string to replace and a replaceme The string to replace is matched ignoring the case. The string to replace (1.9.4) and replacement string can contain variables. Several sub_filter directives -can be specified on one configuration level (1.9.4). -These directives are inherited from the previous level if and only if there are -no sub_filter directives defined on the current level. +can be specified on the same configuration level (1.9.4). +These directives are inherited from the previous configuration level +if and only if there are no sub_filter directives +defined on the current level. diff --git a/xml/en/docs/http/ngx_http_uwsgi_module.xml b/xml/en/docs/http/ngx_http_uwsgi_module.xml --- a/xml/en/docs/http/ngx_http_uwsgi_module.xml +++ b/xml/en/docs/http/ngx_http_uwsgi_module.xml @@ -10,7 +10,7 @@ + rev="45">
@@ -1159,10 +1159,9 @@ Can be used along with the + rev="3">
@@ -114,10 +114,10 @@ the direc There could be several xslt_param directives. -These directives are inherited from the previous level if and -only if there are no -xslt_param and -directives defined on the current level. +These directives are inherited from the previous configuration level +if and only if there are no xslt_param and + directives +defined on the current level. @@ -139,10 +139,10 @@ The value can contain var There could be several xslt_string_param directives. -These directives are inherited from the previous level if and -only if there are no - and xslt_string_param -directives defined on the current level. +These directives are inherited from the previous configuration level +if and only if there are no and +xslt_string_param directives +defined on the current level. diff --git a/xml/en/docs/ngx_core_module.xml b/xml/en/docs/ngx_core_module.xml --- a/xml/en/docs/ngx_core_module.xml +++ b/xml/en/docs/ngx_core_module.xml @@ -10,7 +10,7 @@ + rev="26">
@@ -220,7 +220,7 @@ and should not be set directly by the us Configures logging. -Several logs can be specified on the same level (1.5.2). +Several logs can be specified on the same configuration level (1.5.2). If on the main configuration level writing a log to a file is not explicitly defined, the default file will be used. diff --git a/xml/en/docs/stream/ngx_stream_limit_conn_module.xml b/xml/en/docs/stream/ngx_stream_limit_conn_module.xml --- a/xml/en/docs/stream/ngx_stream_limit_conn_module.xml +++ b/xml/en/docs/stream/ngx_stream_limit_conn_module.xml @@ -10,7 +10,7 @@ + rev="7">
@@ -76,10 +76,9 @@ any configured limit will apply. -The directives are inherited from the previous level if and -only if there are no -limit_conn -directives on the current level. +These directives are inherited from the previous configuration level +if and only if there are no limit_conn directives +defined on the current level. diff --git a/xml/en/docs/stream/ngx_stream_log_module.xml b/xml/en/docs/stream/ngx_stream_log_module.xml --- a/xml/en/docs/stream/ngx_stream_log_module.xml +++ b/xml/en/docs/stream/ngx_stream_log_module.xml @@ -9,7 +9,7 @@ + rev="8">
@@ -54,7 +54,7 @@ access_log /spool/logs/nginx-access.log Sets the path, format, and configuration for a buffered log write. -Several logs can be specified on the same level. +Several logs can be specified on the same configuration level. Logging to syslog can be configured by specifying the “syslog:” prefix in the first parameter. diff --git a/xml/ru/docs/http/ngx_http_auth_basic_module.xml b/xml/ru/docs/http/ngx_http_auth_basic_module.xml --- a/xml/ru/docs/http/ngx_http_auth_basic_module.xml +++ b/xml/ru/docs/http/ngx_http_auth_basic_module.xml @@ -10,7 +10,7 @@ + rev="10">
@@ -61,7 +61,7 @@ location / { “HTTP Basic Authentication”. Заданный параметр используется в качестве realm. В значении параметра допустимо использование переменных (1.3.10, 1.2.7). -Специальное значение off позволяет отменить действие +Специальное значение off отменяет действие унаследованной с предыдущего уровня конфигурации директивы auth_basic. diff --git a/xml/ru/docs/http/ngx_http_core_module.xml b/xml/ru/docs/http/ngx_http_core_module.xml --- a/xml/ru/docs/http/ngx_http_core_module.xml +++ b/xml/ru/docs/http/ngx_http_core_module.xml @@ -10,7 +10,7 @@ + rev="92">
@@ -725,8 +725,8 @@ error_page 404 =301 http://example.com/n -Директивы наследуются с предыдущего уровня при условии, что на данном уровне -не описаны свои директивы error_page. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы error_page. diff --git a/xml/ru/docs/http/ngx_http_fastcgi_module.xml b/xml/ru/docs/http/ngx_http_fastcgi_module.xml --- a/xml/ru/docs/http/ngx_http_fastcgi_module.xml +++ b/xml/ru/docs/http/ngx_http_fastcgi_module.xml @@ -10,7 +10,7 @@ + rev="53">
@@ -1211,8 +1211,8 @@ fastcgi_no_cache $http_pragma $http_a Задаёт параметр, который будет передаваться FastCGI-серверу. В качестве значения можно использовать текст, переменные и их комбинации. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы fastcgi_param. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы fastcgi_param. diff --git a/xml/ru/docs/http/ngx_http_grpc_module.xml b/xml/ru/docs/http/ngx_http_grpc_module.xml --- a/xml/ru/docs/http/ngx_http_grpc_module.xml +++ b/xml/ru/docs/http/ngx_http_grpc_module.xml @@ -10,7 +10,7 @@ + rev="4">
@@ -434,8 +434,8 @@ grpc_pass grpcs://127.0.0.1:443; Позволяет переопределять или добавлять поля заголовка запроса, передаваемые gRPC-серверу. В качестве значения можно использовать текст, переменные и их комбинации. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы grpc_set_header. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы grpc_set_header. diff --git a/xml/ru/docs/http/ngx_http_headers_module.xml b/xml/ru/docs/http/ngx_http_headers_module.xml --- a/xml/ru/docs/http/ngx_http_headers_module.xml +++ b/xml/ru/docs/http/ngx_http_headers_module.xml @@ -10,7 +10,7 @@ + rev="13">
@@ -62,8 +62,8 @@ 307 (1.1.16, 1.0.13) или 308 (1.13.0). Директив add_header может быть несколько. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы add_header. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы add_header. @@ -93,8 +93,8 @@ 307 (1.1.16, 1.0.13) или 308 (1.13.0). Директив add_trailer может быть несколько. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы add_trailer. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы add_trailer. diff --git a/xml/ru/docs/http/ngx_http_limit_conn_module.xml b/xml/ru/docs/http/ngx_http_limit_conn_module.xml --- a/xml/ru/docs/http/ngx_http_limit_conn_module.xml +++ b/xml/ru/docs/http/ngx_http_limit_conn_module.xml @@ -10,7 +10,7 @@ + rev="14">
@@ -99,8 +99,8 @@ server { -Директивы наследуются с предыдущего уровня при условии, что на данном уровне -не описаны свои директивы limit_conn. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы limit_conn. diff --git a/xml/ru/docs/http/ngx_http_limit_req_module.xml b/xml/ru/docs/http/ngx_http_limit_req_module.xml --- a/xml/ru/docs/http/ngx_http_limit_req_module.xml +++ b/xml/ru/docs/http/ngx_http_limit_req_module.xml @@ -10,7 +10,7 @@ + rev="16">
@@ -118,8 +118,8 @@ server { -Директивы наследуются с предыдущего уровня при условии, что на данном уровне -не описаны свои директивы limit_req. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы limit_req. diff --git a/xml/ru/docs/http/ngx_http_log_module.xml b/xml/ru/docs/http/ngx_http_log_module.xml --- a/xml/ru/docs/http/ngx_http_log_module.xml +++ b/xml/ru/docs/http/ngx_http_log_module.xml @@ -10,7 +10,7 @@ + rev="21">
@@ -65,7 +65,7 @@ access_log /spool/logs/nginx-access.log Задаёт путь, формат и настройки буферизованной записи в лог. -На одном уровне может использоваться несколько логов. +На одном уровне конфигурации может использоваться несколько логов. Запись в syslog настраивается указанием префикса “syslog:” в первом параметре. @@ -158,7 +158,7 @@ access_log /path/to/log.gz combined gzip корневого каталога для запроса — если этот каталог не существует, то лог не создаётся. Поэтому access_log нужно описывать на одном уровне: +и access_log нужно описывать на одном уровне конфигурации: server { root /spool/vhost/data/$host; diff --git a/xml/ru/docs/http/ngx_http_mirror_module.xml b/xml/ru/docs/http/ngx_http_mirror_module.xml --- a/xml/ru/docs/http/ngx_http_mirror_module.xml +++ b/xml/ru/docs/http/ngx_http_mirror_module.xml @@ -9,7 +9,7 @@ + rev="4">
@@ -53,7 +53,7 @@ location = /mirror { Задаёт URI, на который будет зеркалироваться исходный запрос. -На одном уровне может быть задано несколько зеркал. +На одном уровне конфигурации может быть задано несколько зеркал. diff --git a/xml/ru/docs/http/ngx_http_proxy_module.xml b/xml/ru/docs/http/ngx_http_proxy_module.xml --- a/xml/ru/docs/http/ngx_http_proxy_module.xml +++ b/xml/ru/docs/http/ngx_http_proxy_module.xml @@ -10,7 +10,7 @@ + rev="67">
@@ -1798,8 +1798,8 @@ proxy_redirect / /; Позволяет переопределять или добавлять поля заголовка запроса, передаваемые проксируемому серверу. В качестве значения можно использовать текст, переменные и их комбинации. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы proxy_set_header. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы proxy_set_header. По умолчанию переопределяются только два поля: proxy_set_header Host $proxy_host; diff --git a/xml/ru/docs/http/ngx_http_scgi_module.xml b/xml/ru/docs/http/ngx_http_scgi_module.xml --- a/xml/ru/docs/http/ngx_http_scgi_module.xml +++ b/xml/ru/docs/http/ngx_http_scgi_module.xml @@ -10,7 +10,7 @@ + rev="41">
@@ -1129,8 +1129,8 @@ scgi_no_cache $http_pragma $http_auth Задаёт параметр, который будет передаваться SCGI-серверу. В качестве значения можно использовать текст, переменные и их комбинации. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы scgi_param. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы scgi_param. diff --git a/xml/ru/docs/http/ngx_http_sub_module.xml b/xml/ru/docs/http/ngx_http_sub_module.xml --- a/xml/ru/docs/http/ngx_http_sub_module.xml +++ b/xml/ru/docs/http/ngx_http_sub_module.xml @@ -10,7 +10,7 @@ + rev="6">
@@ -56,9 +56,9 @@ location / { Задаёт строку, которую нужно заменить, и строку замены. Заменяемая строка проверяется без учёта регистра. В заменяемой строке (1.9.4) и в строке замены можно использовать переменные. -На одном уровне может +На одном уровне конфигурации может быть указано несколько директив sub_filter (1.9.4). -Директивы наследуются с предыдущего уровня при условии, что +Директивы наследуются с предыдущего уровня конфигурации при условии, что на данном уровне не описаны свои директивы sub_filter. diff --git a/xml/ru/docs/http/ngx_http_uwsgi_module.xml b/xml/ru/docs/http/ngx_http_uwsgi_module.xml --- a/xml/ru/docs/http/ngx_http_uwsgi_module.xml +++ b/xml/ru/docs/http/ngx_http_uwsgi_module.xml @@ -10,7 +10,7 @@ + rev="45">
@@ -1157,8 +1157,8 @@ uwsgi_no_cache $http_pragma $http_aut Задаёт параметр, который будет передаваться uwsgi-серверу. В качестве значения можно использовать текст, переменные и их комбинации. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы uwsgi_param. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы uwsgi_param. diff --git a/xml/ru/docs/http/ngx_http_xslt_module.xml b/xml/ru/docs/http/ngx_http_xslt_module.xml --- a/xml/ru/docs/http/ngx_http_xslt_module.xml +++ b/xml/ru/docs/http/ngx_http_xslt_module.xml @@ -10,7 +10,7 @@ + rev="3">
@@ -114,9 +114,9 @@ location / { Директив xslt_param может быть несколько. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы xslt_param и -. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы xslt_param. @@ -138,9 +138,9 @@ location / { Директив xslt_string_param может быть несколько. -Директивы наследуются с предыдущего уровня при условии, что на данном -уровне не описаны свои директивы и -xslt_string_param. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы xslt_string_param. diff --git a/xml/ru/docs/ngx_core_module.xml b/xml/ru/docs/ngx_core_module.xml --- a/xml/ru/docs/ngx_core_module.xml +++ b/xml/ru/docs/ngx_core_module.xml @@ -10,7 +10,7 @@ + rev="26">
@@ -219,7 +219,7 @@ env OPENSSL_ALLOW_PROXY_CERTS=1; Конфигурирует запись в лог. -На одном уровне может использоваться несколько логов (1.5.2). +На одном уровне конфигурации может использоваться несколько логов (1.5.2). Если на уровне конфигурации main запись лога в файл явно не задана, то используется файл по умолчанию. diff --git a/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml b/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml --- a/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml +++ b/xml/ru/docs/stream/ngx_stream_limit_conn_module.xml @@ -10,7 +10,7 @@ + rev="7">
@@ -79,8 +79,8 @@ IP-адреса. -Директивы наследуются с предыдущего уровня при условии, что на данном уровне -не описаны свои директивы limit_conn. +Директивы наследуются с предыдущего уровня конфигурации при условии, что +на данном уровне не описаны свои директивы limit_conn. diff --git a/xml/ru/docs/stream/ngx_stream_log_module.xml b/xml/ru/docs/stream/ngx_stream_log_module.xml --- a/xml/ru/docs/stream/ngx_stream_log_module.xml +++ b/xml/ru/docs/stream/ngx_stream_log_module.xml @@ -9,7 +9,7 @@ + rev="8">
@@ -54,7 +54,7 @@ access_log /spool/logs/nginx-access.log Задаёт путь, формат и настройки буферизованной записи в лог. -На одном уровне может использоваться несколько логов. +На одном уровне конфигурации может использоваться несколько логов. Запись в syslog настраивается указанием префикса “syslog:” в первом параметре.