You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by br...@apache.org on 2013/10/20 20:12:23 UTC
svn commit: r1533935 - in /httpd/httpd/trunk/docs: man/rotatelogs.8
manual/programs/rotatelogs.html.en manual/programs/rotatelogs.xml
Author: breser
Date: Sun Oct 20 18:12:23 2013
New Revision: 1533935
URL: http://svn.apache.org/r1533935
Log:
Followup to r1533810: Put the rotatelogs docs in the right place.
* docs/man/rotatelogs.8,
docs/manual/programs/rotatelogs.html.en: Remove changes from r1533810.
* docs/manual/programs/rotatelogs.xml: Adjust docs for new -d option.
Modified:
httpd/httpd/trunk/docs/man/rotatelogs.8
httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en
httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml
Modified: httpd/httpd/trunk/docs/man/rotatelogs.8
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/man/rotatelogs.8?rev=1533935&r1=1533934&r2=1533935&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/man/rotatelogs.8 (original)
+++ httpd/httpd/trunk/docs/man/rotatelogs.8 Sun Oct 20 18:12:23 2013
@@ -19,7 +19,7 @@
.el .ne 3
.IP "\\$1" \\$2
..
-.TH "ROTATELOGS" 8 "2013-08-19" "Apache HTTP Server" "rotatelogs"
+.TH "ROTATELOGS" 8 "2013-06-12" "Apache HTTP Server" "rotatelogs"
.SH NAME
rotatelogs \- Piped logging program to rotate Apache logs
@@ -27,7 +27,7 @@ rotatelogs \- Piped logging program to r
.SH "SYNOPSIS"
.PP
-\fBrotatelogs\fR [ -\fBl\fR ] [ -\fBL\fR \fIlinkname\fR ] [ -\fBp\fR \fIprogram\fR ] [ -\fBf\fR ] [ -\fBd\fR ] [ -\fBv\fR ] [ -\fBe\fR ] [ -\fBc\fR ] [ -\fBn\fR \fInumber-of-files\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fR(B|K|M|G) [ \fIoffset\fR ]
+\fBrotatelogs\fR [ -\fBl\fR ] [ -\fBL\fR \fIlinkname\fR ] [ -\fBp\fR \fIprogram\fR ] [ -\fBf\fR ] [ -\fBv\fR ] [ -\fBe\fR ] [ -\fBc\fR ] [ -\fBn\fR \fInumber-of-files\fR ] \fIlogfile\fR \fIrotationtime\fR|\fIfilesize\fR(B|K|M|G) [ \fIoffset\fR ]
.SH "SUMMARY"
@@ -67,9 +67,6 @@ Create log file for each interval, even
-n \fInumber-of-files\fR
Use a circular list of filenames without timestamps\&. With -n 3, the series of log files opened would be "logfile", "logfile\&.1", "logfile\&.2", then overwriting "logfile"\&.
.TP
--d
-Creates the parent directories that the log file will be placed in if they do not already exist\&. This allows strftime(3) formatting to be used in the path and not just the filename\&.
-.TP
\fIlogfile\fR
.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 prod
uced and log rotation would keep writing to the same file\&.
.TP
Modified: httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en?rev=1533935&r1=1533934&r2=1533935&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en (original)
+++ httpd/httpd/trunk/docs/manual/programs/rotatelogs.html.en Sun Oct 20 18:12:23 2013
@@ -44,7 +44,6 @@
[ -<strong>L</strong> <var>linkname</var> ]
[ -<strong>p</strong> <var>program</var> ]
[ -<strong>f</strong> ]
- [ -<strong>d</strong> ]
[ -<strong>v</strong> ]
[ -<strong>e</strong> ]
[ -<strong>c</strong> ]
@@ -90,11 +89,6 @@ and when the first request is handled, m
associated logfile does not "exist" until then, which
causes problems from some automated logging tools)</dd>
-<dt><code>-d</code></dt>
-<dd>Creates the parent directories of the path that the log file will be
-placed in if they do not already exist. This allows <code>strftime(3)</code>
-formatting to be used in the path and not just the filename.</dd>
-
<dt><code>-t</code></dt>
<dd>Causes the logfile to be truncated instead of rotated. This is
useful when a log is processed in real time by a command like tail,
@@ -283,4 +277,4 @@ if (typeof(prettyPrint) !== 'undefined')
prettyPrint();
}
//--><!]]></script>
-</body></html>
+</body></html>
\ No newline at end of file
Modified: httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml?rev=1533935&r1=1533934&r2=1533935&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml (original)
+++ httpd/httpd/trunk/docs/manual/programs/rotatelogs.xml Sun Oct 20 18:12:23 2013
@@ -38,6 +38,7 @@
[ -<strong>L</strong> <var>linkname</var> ]
[ -<strong>p</strong> <var>program</var> ]
[ -<strong>f</strong> ]
+ [ -<strong>d</strong> ]
[ -<strong>v</strong> ]
[ -<strong>e</strong> ]
[ -<strong>c</strong> ]
@@ -83,6 +84,11 @@ and when the first request is handled, m
associated logfile does not "exist" until then, which
causes problems from some automated logging tools)</dd>
+<dt><code>-d</code></dt>
+<dd>Creates the parent directories of the path that the log file will be
+placed in if they do not already exist. This allows <code>strftime(3)</code>
+formatting to be used in the path and not just the filename.</dd>
+
<dt><code>-t</code></dt>
<dd>Causes the logfile to be truncated instead of rotated. This is
useful when a log is processed in real time by a command like tail,