You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by co...@apache.org on 2023/01/09 15:31:49 UTC
svn commit: r1906508 [3/3] - in /httpd/httpd/branches/2.4.x/docs/manual: ./ mod/ programs/
Modified: httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.html.en?rev=1906508&r1=1906507&r2=1906508&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.html.en (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.html.en Mon Jan 9 15:31:48 2023
@@ -199,9 +199,8 @@ an offset.</dd>
<div class="section">
<h2><a name="examples" id="examples">Examples</a></h2>
-<div class="example"><p><code>
- CustomLog "|bin/rotatelogs /var/log/logfile 86400" common
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/logfile 86400" common</pre>
+</div>
<p>This creates the files /var/log/logfile.nnnn where nnnn is
the system time at which the log nominally starts (this time
@@ -209,34 +208,30 @@ an offset.</dd>
synchronize cron scripts with it). At the end of each rotation
time (here after 24 hours) a new log is started.</p>
-<div class="example"><p><code>
- CustomLog "|bin/rotatelogs -l /var/log/logfile.%Y.%m.%d 86400" common
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -l /var/log/logfile.%Y.%m.%d 86400" common</pre>
+</div>
<p>This creates the files /var/log/logfile.yyyy.mm.dd where
yyyy is the year, mm is the month, and dd is the day of the month.
Logging will switch to a new file every day at midnight, local time.</p>
-<div class="example"><p><code>
- CustomLog "|bin/rotatelogs /var/log/logfile 5M" common
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/logfile 5M" common</pre>
+</div>
<p>This configuration will rotate the logfile whenever it reaches
a size of 5 megabytes.</p>
-<div class="example"><p><code>
- ErrorLog "|bin/rotatelogs /var/log/errorlog.%Y-%m-%d-%H_%M_%S 5M"
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">ErrorLog "|bin/rotatelogs /var/log/errorlog.%Y-%m-%d-%H_%M_%S 5M"</pre>
+</div>
<p>This configuration will rotate the error logfile whenever it
reaches a size of 5 megabytes, and the suffix to the logfile name
will be created of the form
<code>errorlog.YYYY-mm-dd-HH_MM_SS</code>.</p>
-<div class="example"><p><code>
- CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -t /var/log/logfile 86400" common</pre>
+</div>
- <p>This creates the file /var/log/logfile, truncating the file at
+ <p>This creates the file <code>/var/log/logfile</code>, truncating the file at
startup and then truncating the file once per day. It is expected
in this scenario that a separate process (such as tail) would
process the file in real time.</p>
Modified: httpd/httpd/branches/2.4.x/docs/manual/sections.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/sections.html.en?rev=1906508&r1=1906507&r2=1906508&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/sections.html.en (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/sections.html.en Mon Jan 9 15:31:48 2023
@@ -427,7 +427,8 @@ are interpreted, it is important to unde
<li><code class="directive"><a href="./mod/core.html#location"><Location></a></code>
and <code class="directive"><a href="./mod/core.html#locationmatch"><LocationMatch></a></code> done simultaneously</li>
- <li><code class="directive"><a href="./mod/core.html#if"><If></a></code>
+ <li><code class="directive"><a href="./mod/core.html#if"><If></a></code> sections, even when
+ they are enclosed in any of the preceding contexts.
</li>
</ol>
@@ -460,6 +461,14 @@ are interpreted, it is important to unde
<code class="directive"><a href="./mod/mod_proxy.html#proxy"><Proxy></a></code>
container takes the place of the <code class="directive"><a href="./mod/core.html#directory"><Directory></a></code> container in the processing
order.</li>
+ <li> Caution should be exercised when mixing related configuration
+ directives inside and outside of <code class="directive"><a href="./mod/core.html#if"><If></a></code> because of the effect on merging order. Explicit use
+ of <code class="directive"><a href="./mod/core.html#else"><Else></a></code> can help.
+ </li>
+ <li> When <code class="directive"><a href="./mod/core.html#if"><If></a></code> is
+ used in <code>.htaccess</code>, the enclosed directives in a parent
+ directory will be merged <em>after</em> non-enclosed directives in a
+ subdirectory.</li>
</ul>
<div class="note"><h3>Technical Note</h3>