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 2022/03/28 00:18:05 UTC
svn commit: r1899273 - in /httpd/httpd/branches/2.4.x/docs: man/ manual/howto/ manual/programs/
Author: covener
Date: Mon Mar 28 00:18:05 2022
New Revision: 1899273
URL: http://svn.apache.org/viewvc?rev=1899273&view=rev
Log:
xforms
[skip ci]
Modified:
httpd/httpd/branches/2.4.x/docs/man/rotatelogs.8
httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.en
httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.es
httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta
httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.html.en
httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.fr
httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.ko
httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.meta
httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.tr
Modified: httpd/httpd/branches/2.4.x/docs/man/rotatelogs.8
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/man/rotatelogs.8?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/man/rotatelogs.8 (original)
+++ httpd/httpd/branches/2.4.x/docs/man/rotatelogs.8 Mon Mar 28 00:18:05 2022
@@ -19,7 +19,7 @@
.el .ne 3
.IP "\\$1" \\$2
..
-.TH "ROTATELOGS" 8 "2020-06-10" "Apache HTTP Server" "rotatelogs"
+.TH "ROTATELOGS" 8 "2022-03-28" "Apache HTTP Server" "rotatelogs"
.SH NAME
rotatelogs \- Piped logging program to rotate Apache logs
@@ -68,7 +68,7 @@ Echo logs through to stdout\&. Useful wh
Create log file for each interval, even if empty\&.
.TP
\fB-n \fInumber-of-files\fR\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"\&. Available in 2\&.4\&.5 and later\&.
+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"\&. When this program first opens "logfile", the file will only be truncated if \fB-t\fR is also provided\&. Every subsequent rotation will always begin with truncation of the target file\&. For size based rotation without \fB-t\fR 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\&. Available in 2\&.4\&.5 and later\&.
.TP
\fB\fIlogfile\fR\fR
.PP The path plus basename of the logfile\&. If \fIlogfile\fR includes any '%' characters, it is treated as a format string for \fBstrftime(3)\fR\&. 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 \fBstrftime(3)\fR format will all be zero, referring to the beginning of the current 24-hour period (midnight)\&. .PP When using \fBstrftime(3)\fR 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 \fB/var/log/errorlog\&.%Y-%m-%d\fR 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\&. .PP If the logfile is not an absolute path, it is relative to \fBrotatelogs\fR' working directory, which is the ServerRoot when \fBrotatelogs\fR is run by the server\&.
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.en
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.en?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.en (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/http2.html.en Mon Mar 28 00:18:05 2022
@@ -89,7 +89,7 @@
<p><code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> uses the library of <a href="https://nghttp2.org">nghttp2</a>
as its implementation base. In order to build <code class="module"><a href="../mod/mod_http2.html">mod_http2</a></code> you need at least version 1.2.1 of
<code>libnghttp2</code> installed on your system.</p>
- <p>When you <code>./configure</code> you Apache httpd source tree, you need to give it
+ <p>When you <code>./configure</code> your Apache httpd source tree, you need to give it
'<code>--enable-http2</code>' as additional argument to trigger the build of the module.
Should your <code>libnghttp2</code> reside in an unusual place (whatever that is on your
operating system), you may announce its location with '<code>--with-nghttp2=<path></code>'
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.es
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.es?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.es [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.es [utf-8] Mon Mar 28 00:18:05 2022
@@ -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.es.xsl"?>
-<!-- English Revision: 1834265:1878549 (outdated) -->
+<!-- English Revision: 1834265:1899235 (outdated) -->
<!-- Spanish translation : Daniel Ferradal -->
<!-- Reviewed & updated by Luis Gil de Bernabé Pfeiffer lgilbernabe[AT]apache.org -->
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.fr [utf-8] Mon Mar 28 00:18:05 2022
@@ -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.fr.xsl"?>
-<!-- English Revision: 1878549 -->
+<!-- English Revision: 1878549:1899235 (outdated) -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/http2.xml.meta Mon Mar 28 00:18:05 2022
@@ -9,6 +9,6 @@
<variants>
<variant>en</variant>
<variant outdated="yes">es</variant>
- <variant>fr</variant>
+ <variant outdated="yes">fr</variant>
</variants>
</metafile>
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=1899273&r1=1899272&r2=1899273&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 Mar 28 00:18:05 2022
@@ -126,9 +126,16 @@ processed in real time by a further tool
<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".
+<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>
Modified: httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.fr?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.fr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.fr [utf-8] Mon Mar 28 00:18:05 2022
@@ -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.fr.xsl"?>
-<!-- English Revision : 1877709 -->
+<!-- English Revision: 1877709:1899270 (outdated) -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
Modified: httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.ko
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.ko?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.ko [euc-kr] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.ko [euc-kr] Mon Mar 28 00:18:05 2022
@@ -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:1877709 (outdated) -->
+<!-- English Revision: 420993:1899270 (outdated) -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
Modified: httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.meta?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.meta Mon Mar 28 00:18:05 2022
@@ -8,8 +8,8 @@
<variants>
<variant>en</variant>
- <variant>fr</variant>
+ <variant outdated="yes">fr</variant>
<variant outdated="yes">ko</variant>
- <variant>tr</variant>
+ <variant outdated="yes">tr</variant>
</variants>
</metafile>
Modified: httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.tr
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.tr?rev=1899273&r1=1899272&r2=1899273&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.tr [utf-8] (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/programs/rotatelogs.xml.tr [utf-8] Mon Mar 28 00:18:05 2022
@@ -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: 1877709 -->
+<!-- English Revision: 1877709:1899270 (outdated) -->
<!-- =====================================================
Translated by: Nilgün Belma Bugüner <nilgun belgeler.gen.tr>
Reviewed by: Orhan Berent <berent belgeler.gen.tr>