comparison xml/en/docs/debugging_log.xml @ 271:4c6d2c614d2c

Cleaned up XML tag mess: - all of <parameter> and <code>, and some of <dirname>, <value>, and <command> were replaced by <literal>; - the rest of <dirname> were replaced by links; - <argument> were replaced by <value>; - <value> is now rendered in HTML in italic; - <literal> and <path> can now contain <value>. Cleaned up terminology mess: - directives take "parameters".
author Ruslan Ermilov <ru@nginx.com>
date Fri, 23 Dec 2011 17:29:59 +0000
parents 5284967934df
children 8e1356bd281a
comparison
equal deleted inserted replaced
270:945d7299c26c 271:4c6d2c614d2c
13 13
14 <programlisting> 14 <programlisting>
15 ./configure --with-debug ... 15 ./configure --with-debug ...
16 </programlisting> 16 </programlisting>
17 17
18 Then the <value>debug</value> level should be set with the 18 Then the <literal>debug</literal> level should be set with the
19 <link doc="ngx_core_module.xml" id="error_log"/> directive: 19 <link doc="ngx_core_module.xml" id="error_log"/> directive:
20 20
21 <programlisting> 21 <programlisting>
22 error_log /path/to/log debug; 22 error_log /path/to/log debug;
23 </programlisting> 23 </programlisting>
24 24
25 The nginx binary version for Windows is always built with the debugging log 25 The nginx binary version for Windows is always built with the debugging log
26 support, so only setting the <value>debug</value> level will suffice. 26 support, so only setting the <literal>debug</literal> level will suffice.
27 </para> 27 </para>
28 28
29 <para> 29 <para>
30 Note that redefining the log without also specifying the <value>debug</value> 30 Note that redefining the log without also specifying the
31 <literal>debug</literal>
31 level will disable the debugging log. 32 level will disable the debugging log.
32 In the example below, redefining the log on the 33 In the example below, redefining the log on the
33 <link doc="http/ngx_http_core_module.xml" id="server"/> 34 <link doc="http/ngx_http_core_module.xml" id="server"/>
34 level disables the debugging log for this server: 35 level disables the debugging log for this server:
35 <programlisting> 36 <programlisting>
39 server { 40 server {
40 error_log /path/to/log; 41 error_log /path/to/log;
41 ... 42 ...
42 </programlisting> 43 </programlisting>
43 To avoid this, either the line redefining the log should be 44 To avoid this, either the line redefining the log should be
44 commented out, or the <value>debug</value> level specification should 45 commented out, or the <literal>debug</literal> level specification should
45 also be added: 46 also be added:
46 <programlisting> 47 <programlisting>
47 error_log /path/to/log debug; 48 error_log /path/to/log debug;
48 49
49 http { 50 http {