Merging upstream version 2.4.59.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 62 insertions, 29 deletions

diff --git a/docs/manual/programs/rotatelogs.html.fr.utf8 b/docs/manual/programs/rotatelogs.html.fr.utf8
index d5dba96..5b109d6 100644
--- a/docs/manual/programs/rotatelogs.html.fr.utf8
+++ b/docs/manual/programs/rotatelogs.html.fr.utf8
@@ -71,10 +71,16 @@ de temps ou pour le formatage de <code>strftime(3)</code> avec une
 rotation basée sur la taille.</dd>
 
 <dt><code>-L</code> <var>nom-lien</var></dt>
-<dd>Etablit un lien physique entre le fichier journal courant et le lien
+<dd><p>Etablit un lien physique entre le fichier journal courant et le lien
 spécifié. Cette option permet de consulter le journal de manière
 continue malgré les rotations via une commande du style <code>tail -F
-nom-lien</code>.</dd>
+nom-lien</code>.</p>
+<p>Si le nom du lien spécifié n'est pas un chemin absolu, il est relatif au
+répertoire de travail de <code>rotatelogs</code> qui correspond à la valeur de
+la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> lorsque la commande
+<code>rotatelogs</code> est exécutée par le serveur.  
+</p>
+</dd>
 
 <dt><code>-p</code> <var>programme</var></dt>
 <dd>Avec cette option, <code>rotatelogs</code> exécutera le programme
@@ -99,10 +105,9 @@ journal associé n'"existe" pas, ce qui peut causer des problèmes à
 certains utilitaires de journalisation automatiques).</dd>
 
 <dt><code>-D</code></dt>
-<dd>Crée les répertoires parents du répertoire dans lequel le fichier journal
-sera placé s'ils n'existent pas déjà. Cela permet d'utiliser le formatage
-<code>strftime(3)</code> non seulement dans le nom de fichier mais aussi dans le
-chemin.</dd>
+<dd>Crée les répertoires parents du chemin du fichier journal s'ils
+n'existent pas déjà, ce qui permet d'utiliser le format
+<code>strftime(3)</code> dans les chemins au lieu du nom de fichier seul.</dd>
 
 <dt><code>-t</code></dt>
 <dd>Provoque une troncature du fichier journal au lieu d'une rotation.
@@ -113,6 +118,15 @@ chaînes de format contenant des caractères '%' sont cependant
 respectées.
 </dd>
 
+<dt><code>-T</code></dt>
+<dd>Provoque la troncature de tous les fichiers journaux lors de leur ouverture,
+à l'exception du fichier journal initial. Cela s'avère utile lorsque la chaîne
+de formatage contient quelque chose qui va se répéter de manière cyclique, comme
+le jour du mois par exemple. Disponible à partir de la version 2.4.56 du serveur
+HTTP Apache.
+</dd>
+
+
 <dt><code>-v</code></dt>
 <dd>Affiche une sortie verbeuse sur STDERR. La sortie contient le
 résultat de l'interprétation de la configuration, ainsi que toutes les
@@ -126,9 +140,20 @@ opérations d'ouverture et de fermeture de fichiers.</dd>
 utile lorsque les journaux doivent être traités par un autre programme.</dd>
 
 <dt><code>-n <var>nombre-de-fichiers</var></code></dt>
-<dd>Utilise une liste circulaire de fichiers sans repères de temps. Avec
--n 3, la série de fichiers conservés sera "logfile",
+<dd>Utilise une liste circulaire de noms de fichiers sans repères de temps.
+Cette option permet d'écraser des fichiers journaux au démarrage et au cours de
+la rotation. Avec -n 3, la série de fichiers conservés sera "logfile",
 "logfile.1", "logfile.2" avec écrasement de "logfile".
+<br />
+Lorsque ce programme ouvre «&nbsp;logfile&nbsp;», ce dernier sera seulement tronqué si
+l'option <code>-t</code> est aussi spécifiée. Toute rotation subséquente sera
+précédée d'une troncature du fichier cible. Dans le cas d'une rotation basée sur
+la taille sans l'option <code>-t</code> et si des fichiers journaux sont déjà en
+place, cette option peut provoquer des résultats inattendus comme l'envoi des
+entrées de journal initiales vers «&nbsp;logfile.1&nbsp;», les entrées de «&nbsp;logfile.1&nbsp;»
+n'étant pas conservées, même si des fichiers «&nbsp;logfile.n&nbsp;» n'ont pas encore été
+utilisés.
+<br />
 Disponible à partir de la version 2.4.5 du serveur HTTP Apache.</dd>
 
 <dt><code><var>fichier-journal</var></code></dt>
@@ -153,6 +178,11 @@ nouveau. Par exemple, si <var>fichier-journal</var> était
 mégaoctets, et si la limite de 5 mégaoctets a été atteinte deux fois
 dans la même journée, le même nom de fichier va être généré, et la
 rotation va écraser le fichier existant.</p>
+<p>Si le nom du fichier journal n'est pas un chemin absolu, il est relatif au
+répertoire de travail de <code>rotatelogs</code> qui correspond à la valeur de
+la directive <code class="directive"><a href="../mod/core.html#serverroot">ServerRoot</a></code> lorsque la commande
+<code>rotatelogs</code> est exécutée par le serveur.  
+</p>
 </dd>
 
 <dt><code><var>temps-rotation</var></code></dt>
@@ -191,9 +221,8 @@ spécifier un décalage.</dd>
 <div class="section">
 <h2><a name="examples" id="examples">Exemples</a></h2>
 
-<div class="example"><p><code>
-     CustomLog "|bin/rotatelogs /var/log/fichier-journal 86400" common
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/fichier-journal 86400" common</pre>
+</div>
 
      <p>Cette directive crée les fichiers /var/log/fichier-journal.nnnn
      où nnnn correspond au temps système auquel la journalisation
@@ -202,38 +231,42 @@ spécifier un décalage.</dd>
      avec lui). A la fin de chaque temps de rotation (ici après 24
      heures), une nouvelle journalisation démarre.</p>
 
-<div class="example"><p><code>
-     CustomLog "|bin/rotatelogs -l /var/log/fichier-journal.%Y.%m.%d 86400" common
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -l /var/log/fichier-journal.%Y.%m.%d 86400" common</pre>
+</div>
 
      <p>Cette directive crée les fichiers
      /var/log/fichier-journal.yyyy.mm.dd où yyyy correspond à l'année,
      mm au mois et dd au jour du mois. La journalisation basculera vers
      un nouveau fichier chaque jour à minuit, temps local.</p>
 
-<div class="example"><p><code>
-     CustomLog "|bin/rotatelogs /var/log/fichier-journal 5M" common
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs /var/log/fichier-journal 5M" common</pre>
+</div>
 
      <p>Cette directive va effectuer une rotation du fichier journal
      chaque fois que la taille de ce dernier atteindra 5 MOctets.</p>
 
-<div class="example"><p><code>
-     ErrorLog "|bin/rotatelogs /var/log/journal-erreurs.%Y-%m-%d-%H_%M_%S 5M"
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">ErrorLog "|bin/rotatelogs /var/log/journal-erreurs.%Y-%m-%d-%H_%M_%S 5M"</pre>
+</div>
      <p>Cette directive va effectuer une rotation du fichier journal des
      erreurs chaque fois que la taille de ce dernier atteindra 5
      MOctets, et le nom du fichier journal se présentera sous
      la forme <code>journal-erreurs.YYYY-mm-dd-HH_MM_SS</code>.</p>
 
-<div class="example"><p><code>
-     CustomLog "|bin/rotatelogs -t /var/log/journal 86400" common
-</code></p></div>
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -t /var/log/journal 86400" common</pre>
+</div>
+
+     <p>Cet exemple crée le fichier <code>/var/log/journal</code> en le
+     tronquant au démarrage, puis une fois par jour. Ce scénario implique qu'un
+     processus séparé (tel que tail) traite le fichier en temps réel.</p>
+
+<div class="example"><pre class="prettyprint lang-config">CustomLog "|bin/rotatelogs -T /var/log/logfile.%d 86400" common</pre>
+</div>
 
-     <p>Cet exemple crée le fichier /var/log/journal en le tronquant
-     au démarrage, puis une fois par jour. Ce scénario implique qu'un
-     processus séparé (tel que tail) traite le fichier en temps
-     réel.</p>
+<p>Si le serveur est démarré ou redémarré le premier du mois, cela s'ajoute à la
+fin de <code>/var/log/logfile.01</code>. Lorsqu'une entrée de journal est écrite
+le deux du mois, <code>/var/log/logfile.02</code> est tronqué et les nouvelles
+entrées seront ajoutées à partir du début du fichier. Cet exemple conserve
+environ 1 mois de journaux sans nécessiter de maintenance externe.</p>
 
 </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
 <div class="section">
@@ -281,7 +314,7 @@ caractères (localisé)</td></tr>
 <a href="../fr/programs/rotatelogs.html" title="Français">&nbsp;fr&nbsp;</a> |
 <a href="../ko/programs/rotatelogs.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 <a href="../tr/programs/rotatelogs.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
-</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Libera.chat, or sent to our <a href="https://httpd.apache.org/lists.html">mailing lists</a>.</div>
 <script type="text/javascript"><!--//--><![CDATA[//><!--
 var comments_shortname = 'httpd';
 var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/rotatelogs.html';
@@ -299,7 +332,7 @@ var comments_identifier = 'http://httpd.apache.org/docs/2.4/programs/rotatelogs.
     }
 })(window, document);
 //--><!]]></script></div><div id="footer">
-<p class="apache">Copyright 2019 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="apache">Copyright 2024 The Apache Software Foundation.<br />Autorisé sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="../glossary.html">Glossaire</a> | <a href="../sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
 if (typeof(prettyPrint) !== 'undefined') {
     prettyPrint();