[latexrefman-commits] [SCM] latexrefman updated: r1100 - trunk

[Vincent Bela?che]

Author: vincentb1
Date: 2022-08-13 15:24:22 +0000 (Sat, 13 Aug 2022)
New Revision: 1100

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
Log:
[fr] \addtocontents, align on en.

* latex2e-fr.texi (\addtocontents): Align on English version.


Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2022-08-13 15:24:20 UTC (rev 1099)
+++ trunk/ChangeLog	2022-08-13 15:24:22 UTC (rev 1100)
@@ -1,5 +1,9 @@
 2022-08-13  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
+	* latex2e-fr.texi (\addtocontents): Align on English version.
+
+2022-08-13  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
 	[fr] Various translation improvements.
 
 2022-08-13  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2022-08-13 15:24:20 UTC (rev 1099)
+++ trunk/latex2e-fr.texi	2022-08-13 15:24:22 UTC (rev 1100)
@@ -19786,22 +19786,80 @@
 @subsection @code{\addtocontents}
 @findex \addtocontents@{@var{ext}@}@{@var{texte}@}
 
-La commande @code{\addtocontents}@{@var{ext}@}@{@var{texte}@} ajoute du
-texte (ou des commandes de formatage) directement au fichier
- at file{. at var{ext}} qui génère la tables des matières, ou la liste des
-figures ou des tableaux.  generates the table of contents or listes of
-figures or tables.
+Synopsis :
 
+ at example
+\addtocontents@{@var{ext}@}@{@var{texte}@}
+ at end example
+
+Ajoute @var{texte}, qui peut être du texte ou des commandes de formatage,
+directement au fichier auxiliaire dont le nom a l'extension
+ at file{. at var{ext}}. Cela est utilisé d'ordinaire pour la table des
+matières, mais aussi pour la liste des figures ou celle des tableaux.
+
+L'exemple suivant place un peu d'espace vertical dans la table des
+matières après l'en-tête @samp{Table des matières} :
+
+ at example
+\tableofcontents\newpage
+\addtocontents@{toc@}@{\protect\vspace*@{3ex@}@}
+ at end example
+
+ at noindent
+L'exemple suivant place le mot @samp{page}, en caractères gras, au
+dessus de la colonne des numéros de page après l'en-tête.
+
+ at example
+\tableofcontents
+\addtocontents@{toc@}@{~\hfill\textbf@{page@}\par@}
+\chapter@{...@}
+ at end example
+
+ at noindent
+L'exemple ci-dessous ajoute une ligne annonçant l'œuvre d'un nouvel
+auteur :
+
+ at example
+\addtocontents@{toc@}@{%
+  \protect\vspace@{2ex@}
+  \textbf@{Chapitres de N. Autre Auteur@}\par@}
+ at end example
+
+La différence entre @code{\addtocontents} et @code{\addcontentsline} est
+que cette dernière commande est strictement réservée aux lignes, comme
+le cas d'une ligne donnant le numéro de page pour le début d'un nouveau
+sous-ensemble des chapitres.  Comme les exemples ci-dessus le démontrent,
+ at code{\addtocontents} permet du matériel tel que de l'espacement.
+
+La commande @code{\addtocontents} a deux arguments, tous deux
+obligatoires.
+
 @table @var
 @item ext
-L'extension de nom de fichier du fichier dans lequel l'information est à
-écrire : @file{toc} (table des matières), @file{lof} (liste des
-figures), ou @file{lot} (liste des tableaux).
+Typiquement l'un parmi : @file{toc} pour la table des matières,
+ at file{lof} por la liste des figures, ou @file{lot} pour la liste des
+tableaux. L'extension de nom de fichier du fichier dans lequel
+l'information est à écrire.
 
 @item texte
-Le texte à écrire.
+Le texte, et possiblement les commandes, à écrire.
 @end table
 
+Les commandes de rubricage telles que @code{\chapter} utilisent la
+commande @code{\addcontentsline} pour stocker l'information.  Cette
+commande crée des lignes dans le fichier auxiliaire en @file{.toc} qui
+contient les commandes @code{\contentsline} (@pxref{\addcontentsline}).
+Contrairement à elle, la commande @code{\addtocontents} place
+directement le matériel dans ce fichier.
+
+La commande @code{\addtocontents} interagit avec @code{\include}
+(@pxref{\include & \includeonly}). Si vous les utilisez au même niveau,
+comme dans @code{\addtocontents@{...@}@{...@}\include@{...@}} alors les
+lignes de la table des matières risquent de sortir dans le mauvais
+ordre.  La solution est de déplacer @code{\addtocontents} pour la mettre
+dans le fichier à inclure.
+
+
 @node \contentsline
 @subsection @code{\contentsline}