Proposed documentation change for ticket #1176

[selivan]

https://trac.nginx.org/nginx/ticket/1176

Specified at compile time default error log(--error-log-path) is always used at 
global level if there are no other file-based logs configured. I think this 
should be mentioned in documentation.

Patch in attachment.
# HG changeset patch
# User Pavel Selivenov <selivan.at.git...@gmail.com>
# Date 1484158783 -10800
#      Wed Jan 11 21:19:43 2017 +0300
# Node ID ad1938436b8463c58157a64b9e9053868a90bab6
# Parent  ee5f7260d63bef9e6eef38e8d5568e52c8879c7e
Documentation: added info about nuances of using error_log with syslog.

diff -r ee5f7260d63b -r ad1938436b84 xml/en/docs/ngx_core_module.xml
--- a/xml/en/docs/ngx_core_module.xml	Mon Jan 09 13:14:16 2017 +0300
+++ b/xml/en/docs/ngx_core_module.xml	Wed Jan 11 21:19:43 2017 +0300
@@ -168,8 +168,10 @@
 -->
 The special value <literal>stderr</literal> selects the standard error file.
 Logging to <link doc="syslog.xml">syslog</link> can be configured by specifying
-the “<literal>syslog:</literal>” prefix.
-Logging to a
+the “<literal>syslog:</literal>” prefix. If "<literal>syslog:</literal>" is used
+then specified at compile time default error log(configure directive
+<value>--error-log-path</value>) is always used at global level if there are no
+other configured file-based error logs. Logging to a
 <link doc="debugging_log.xml" id="memory">cyclic memory buffer</link>
 can be configured by specifying the “<literal>memory:</literal>” prefix and
 buffer <value>size</value>, and is generally used for debugging (1.7.11).
diff -r ee5f7260d63b -r ad1938436b84 xml/en/docs/syslog.xml
--- a/xml/en/docs/syslog.xml	Mon Jan 09 13:14:16 2017 +0300
+++ b/xml/en/docs/syslog.xml	Wed Jan 11 21:19:43 2017 +0300
@@ -18,7 +18,10 @@
 <link doc="ngx_core_module.xml" id="error_log"/>
 and
 <link doc="http/ngx_http_log_module.xml" id="access_log"/>
-directives support logging to syslog.
+directives support logging to syslog. If syslog is used for writing
+<link doc="ngx_core_module.xml" id="error_log"/> then specified at compile time
+default error log(configure directive <value>--error-log-path</value>) is always
+used at global level if there are no other configured file-based error logs.
 The following parameters configure logging to syslog:
 <list type="tag">
 
diff -r ee5f7260d63b -r ad1938436b84 xml/ru/docs/ngx_core_module.xml
--- a/xml/ru/docs/ngx_core_module.xml	Mon Jan 09 13:14:16 2017 +0300
+++ b/xml/ru/docs/ngx_core_module.xml	Wed Jan 11 21:19:43 2017 +0300
@@ -168,8 +168,11 @@
 -->
 Специальное значение <literal>stderr</literal> выбирает стандартный файл ошибок.
 Запись в <link doc="syslog.xml">syslog</link> настраивается указанием префикса
-“<literal>syslog:</literal>”.
-Запись в
+“<literal>syslog:</literal>”. При использовании
+<literal>syslog:</literal> заданный во время компиляции файл
+ошибок по-умолчанию (директива конфигурации <value>--error-log-path</value>)
+всегда используется на глобальном уровне, если нету других сконфигурированных
+файловых логов ошибок. Запись в
 <link doc="debugging_log.xml" id="memory">кольцевой буфер в памяти</link>
 настраивается указанием префикса “<literal>memory:</literal>” и
 <value>размера</value> буфера и как правило используется для отладки (1.7.11).
diff -r ee5f7260d63b -r ad1938436b84 xml/ru/docs/syslog.xml
--- a/xml/ru/docs/syslog.xml	Mon Jan 09 13:14:16 2017 +0300
+++ b/xml/ru/docs/syslog.xml	Wed Jan 11 21:19:43 2017 +0300
@@ -18,8 +18,12 @@
 <link doc="ngx_core_module.xml" id="error_log"/>
 и
 <link doc="http/ngx_http_log_module.xml" id="access_log"/>
-поддерживают запись в syslog.
-Запись в syslog настраивается при помощи следующих параметров:
+поддерживают запись в syslog. При использовании syslog для записи
+<link doc="ngx_core_module.xml" id="error_log"/> заданный во время компиляции
+файл ошибок по-умолчанию (директива конфигурации
+<value>--error-log-path</value>) всегда используется на глобальном уровне, если
+нету других сконфигурированных файловых логов ошибок. Запись в syslog
+настраивается при помощи следующих параметров:
 <list type="tag">
 
 <tag-name><literal>server=</literal><value>адрес</value></tag-name>

_______________________________________________
nginx-devel mailing list
nginx-devel@nginx.org
http://mailman.nginx.org/mailman/listinfo/nginx-devel