From: Eric Covener <covener@apache.org>
Date: Mon, 28 Mar 2022 00:07:49 +0000 (+0000)
Subject: xforms
X-Git-Tag: 2.5.0-alpha2-ci-test-only~428
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=41141349d146c0b263f26c7a577ef12094159555;p=thirdparty%2Fapache%2Fhttpd.git

xforms

[skip ci]



git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1899271 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/programs/rotatelogs.html.en.utf8 b/docs/manual/programs/rotatelogs.html.en.utf8
index acdcbb074aa..80c3b7f1e35 100644
--- a/docs/manual/programs/rotatelogs.html.en.utf8
+++ b/docs/manual/programs/rotatelogs.html.en.utf8
@@ -126,9 +126,16 @@ processed in real time by a further tool in the chain.</dd>
 <dd>Create log file for each interval, even if empty.</dd>
 
 <dt><code>-n <var>number-of-files</var></code></dt>
-<dd>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".<br />
+<dd>Use a circular list of filenames without timestamps. This option overwrites 
+log files at startup and during rotation.  With -n 3, the series of log 
+files opened would be "logfile", "logfile.1", "logfile.2", then overwriting 
+"logfile". 
+<br />
+When this program first opens "logfile", the file will only be truncated if <code>-t</code> is also provided. Every subsequent rotation will
+always begin with truncation of the target file.  For size based rotation without <code>-t</code> and existing log files in place,
+this option may result in unintuitive behavior such as initial log entries being sent to "logfile.1", and entries in "logfile.1" not being preserved
+even if later "logfile.n" have not yet been used.
+<br />
 Available in 2.4.5 and later.</dd>
 
 <dt><code><var>logfile</var></code></dt>