summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
-rw-r--r--docs/man/rotatelogs.84
-rw-r--r--docs/manual/mod/mod_allowmethods.html.en2
-rw-r--r--docs/manual/programs/rotatelogs.html.en14
-rw-r--r--docs/manual/programs/rotatelogs.xml.ko2
-rw-r--r--docs/manual/programs/rotatelogs.xml.tr2
5 files changed, 17 insertions, 7 deletions
diff --git a/docs/man/rotatelogs.8 b/docs/man/rotatelogs.8
index 7254a57ebc..470693302d 100644
--- a/docs/man/rotatelogs.8
+++ b/docs/man/rotatelogs.8
@@ -19,7 +19,7 @@
.el .ne 3
.IP "\\$1" \\$2
..
-.TH "ROTATELOGS" 8 "2010-02-19" "Apache HTTP Server" "rotatelogs"
+.TH "ROTATELOGS" 8 "2010-10-19" "Apache HTTP Server" "rotatelogs"
.SH NAME
rotatelogs \- Piped logging program to rotate Apache logs
@@ -56,7 +56,7 @@ Causes the logfile to be truncated instead of rotated\&. This is useful when a l
Produce verbose output on STDERR\&. The output contains the result of the configuration parsing, and all file open and close actions\&.
.TP
\fIlogfile\fR
-The path plus basename of the logfile\&. If \fIlogfile\fR includes any '%' characters, it is treated as a format string for strftime(3)\&. Otherwise, the suffix \fI\&.nnnnnnnnnn\fR is automatically added and is the time in seconds (unless the -t option is used)\&. Both formats compute the start time from the beginning of the current period\&. For example, if a rotation time of 86400 is specified, the hour, minute, and second fields created from the strftime(3) format will all be zero, referring to the beginning of the current 24-hour period (midnight)\&.
+.PP The path plus basename of the logfile\&. If \fIlogfile\fR includes any '%' characters, it is treated as a format string for strftime(3)\&. Otherwise, the suffix \fI\&.nnnnnnnnnn\fR is automatically added and is the time in seconds (unless the -t option is used)\&. Both formats compute the start time from the beginning of the current period\&. For example, if a rotation time of 86400 is specified, the hour, minute, and second fields created from the strftime(3) format will all be zero, referring to the beginning of the current 24-hour period (midnight)\&. .PP When using strftime(3) filename formatting, be sure the log file format has enough granularity to produce a different file name each time the logs are rotated\&. Otherwise rotation will overwrite the same file instead of starting a new one\&. For example, if \fIlogfile\fR was /var/logs/errorlog\&.%Y-%m-%d with log rotation at 5 megabytes, but 5 megabytes was reached twice in the same day, the same log file name would be produced and log rotation would keep writing to the same file\&.
.TP
\fIrotationtime\fR
The time between log file rotations in seconds\&. The rotation occurs at the beginning of this interval\&. For example, if the rotation time is 3600, the log file will be rotated at the beginning of every hour; if the rotation time is 86400, the log file will be rotated every night at midnight\&. (If no data is logged during an interval, no file will be created\&.)
diff --git a/docs/manual/mod/mod_allowmethods.html.en b/docs/manual/mod/mod_allowmethods.html.en
index 72d512776b..296fe165b2 100644
--- a/docs/manual/mod/mod_allowmethods.html.en
+++ b/docs/manual/mod/mod_allowmethods.html.en
@@ -29,7 +29,7 @@
<tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mod_allowmethods.c</td></tr></table>
<h3>Summary</h3>
-<p>This modules makes it easy to restrict what HTTP methods can
+<p>This module makes it easy to restrict what HTTP methods can
used on an server. The most common configuration would be:</p>
<div class="example"><h3>Example</h3><p><code>
diff --git a/docs/manual/programs/rotatelogs.html.en b/docs/manual/programs/rotatelogs.html.en
index ca046a6fc0..80ecd25faf 100644
--- a/docs/manual/programs/rotatelogs.html.en
+++ b/docs/manual/programs/rotatelogs.html.en
@@ -87,7 +87,7 @@ close actions.</dd>
<dt><code><var>logfile</var></code></dt>
-<dd>The path plus basename of the logfile. If <var>logfile</var>
+<dd><p>The path plus basename of the logfile. If <var>logfile</var>
includes any '%' characters, it is treated as a format string for
<code>strftime(3)</code>. Otherwise, the suffix
<var>.nnnnnnnnnn</var> is automatically added and is the time in
@@ -96,7 +96,17 @@ start time from the beginning of the current period. For example,
if a rotation time of 86400 is specified, the hour, minute, and
second fields created from the <code>strftime(3)</code> format will
all be zero, referring to the beginning of the current 24-hour
-period (midnight).</dd>
+period (midnight).</p>
+<p>When using <code>strftime(3)</code> filename formatting,
+be sure the log file format has enough granularity to produce
+a different file name each time the logs are rotated. Otherwise
+rotation will overwrite the same file instead of starting a new
+one. For example, if <var>logfile</var> was
+<code>/var/logs/errorlog.%Y-%m-%d</code> with log rotation at 5
+megabytes, but 5 megabytes was reached twice in the same day, the
+same log file name would be produced and log rotation would keep
+writing to the same file.</p>
+</dd>
<dt><code><var>rotationtime</var></code></dt>
diff --git a/docs/manual/programs/rotatelogs.xml.ko b/docs/manual/programs/rotatelogs.xml.ko
index c9700f4cfa..9f582f63bc 100644
--- a/docs/manual/programs/rotatelogs.xml.ko
+++ b/docs/manual/programs/rotatelogs.xml.ko
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='EUC-KR' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.ko.xsl"?>
-<!-- English Revision: 420993:916377 (outdated) -->
+<!-- English Revision: 420993:1024263 (outdated) -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
diff --git a/docs/manual/programs/rotatelogs.xml.tr b/docs/manual/programs/rotatelogs.xml.tr
index 863c9fa866..68c4209486 100644
--- a/docs/manual/programs/rotatelogs.xml.tr
+++ b/docs/manual/programs/rotatelogs.xml.tr
@@ -1,7 +1,7 @@
<?xml version='1.0' encoding='UTF-8' ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.tr.xsl"?>
-<!-- English Revision: 735925:916377 (outdated) -->
+<!-- English Revision: 735925:1024263 (outdated) -->
<!-- =====================================================
Translated by: Nilgün Belma Bugüner <nilgun belgeler.org>
Reviewed by: Orhan Berent <berent belgeler.org>