From: Ben Reser Date: Sun, 20 Oct 2013 18:12:23 +0000 (+0000) Subject: Followup to r1533810: Put the rotatelogs docs in the right place. X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=41f1e0f648b6f189d661a7b44ace64de82de0488;p=thirdparty%2Fapache%2Fhttpd.git 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. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1533935 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/man/rotatelogs.8 b/docs/man/rotatelogs.8 index 35693877762..cbbe5863b23 100644 --- a/docs/man/rotatelogs.8 +++ b/docs/man/rotatelogs.8 @@ -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 rotate Apache logs .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 if empty\&. -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 produced and log rotation would keep writing to the same file\&. .TP diff --git a/docs/manual/programs/rotatelogs.html.en b/docs/manual/programs/rotatelogs.html.en index 23e163f3916..841ed1265da 100644 --- a/docs/manual/programs/rotatelogs.html.en +++ b/docs/manual/programs/rotatelogs.html.en @@ -44,7 +44,6 @@ [ -L linkname ] [ -p program ] [ -f ] - [ -d ] [ -v ] [ -e ] [ -c ] @@ -90,11 +89,6 @@ and when the first request is handled, meaning that the associated logfile does not "exist" until then, which causes problems from some automated logging tools) -
-d
-
Creates the parent directories of the path 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.
-
-t
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(); } //--> - + \ No newline at end of file diff --git a/docs/manual/programs/rotatelogs.xml b/docs/manual/programs/rotatelogs.xml index f6c6aec5086..ca25a405338 100644 --- a/docs/manual/programs/rotatelogs.xml +++ b/docs/manual/programs/rotatelogs.xml @@ -38,6 +38,7 @@ [ -L linkname ] [ -p program ] [ -f ] + [ -d ] [ -v ] [ -e ] [ -c ] @@ -83,6 +84,11 @@ and when the first request is handled, meaning that the associated logfile does not "exist" until then, which causes problems from some automated logging tools)
+
-d
+
Creates the parent directories of the path 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.
+
-t
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,