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

[Vincent Belaiche]

Author: vincentb1
Date: 2021-08-12 21:36:59 +0000 (Thu, 12 Aug 2021)
New Revision: 986

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
Log:
[fr] \@@dottedtocline, \numberline, add+translate.

* latex2e-fr.texi (\@@dottedtocline, \numberline): New nodes,
translate them to English.


Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2021-08-12 21:36:57 UTC (rev 985)
+++ trunk/ChangeLog	2021-08-12 21:36:59 UTC (rev 986)
@@ -1,5 +1,10 @@
 2021-08-12  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
+	* latex2e-fr.texi (\@@dottedtocline, \numberline): New nodes,
+	translate them to English.
+
+2021-08-12  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
 	* latex2e-fr.texi (Table of contents etc., \contentsline): Add
 	node \contentsline and translate it.
 	(\addcontentsline): Realign on English.

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2021-08-12 21:36:57 UTC (rev 985)
+++ trunk/latex2e-fr.texi	2021-08-12 21:36:59 UTC (rev 986)
@@ -17621,13 +17621,64 @@
 matières.
 
 @menu
+* \@@dottedtocline::    Formate une entrée dans la table des matières etc.
 * \addcontentsline::    Ajouter une entrée dans la table des matières etc.
 * \addtocontents::      Ajouter du texte directement au fichier table des matières etc.
 * \contentsline::       Règle une ligne de table des matières, etc.
 * \nofiles::            Empêche l'écriture dans les fichiers auxiliaires.
+* \numberline::         Place le numéro en argument fer a gauche dans une boîte.
 @end menu
 
 
+ at node \@@dottedtocline
+ at subsection @code{\@@dottedtocline}
+
+ at findex \@@dottedtocline
+ at cindex table des matières, crée une ligne pointillée
+
+Synopsis :
+
+ at example
+\@@dottedtocline@{@var{numnivrubrique}@}@{@var{renfoncement}@}@{@var{largeurnum}@}@{@var{texte}@}@{@var{numpage}@}
+ at end example
+
+Uitlisée en interne par @LaTeX{} pour formater une ligne d'article dans
+la table des matières, table des figures ou table des tableaux. Les
+auteurs ne saisissent pas directement des commandes
+ at code{\@@dottedtocline}.
+
+Cette commande est typiquement utilisée par @code{\l@@section},
+ at code{\l@@subsection}, etc., pour formater le contenu de ces tables.
+Par exemple, le fichier @file{article.cls} contient ces définitions :
+
+ at example
+\newcommand*\l@@section@{\@@dottedtocline@{1@}@{1.5em@}@{2.3em@}@}
+\newcommand*\l@@subsection@{\@@dottedtocline@{2@}@{3.8em@}@{3.2em@}@}
+\newcommand*\l@@subsubsection@{\@@dottedtocline@{3@}@{7.0em@}@{4.1em@}@}
+ at end example
+
+ at noindent
+Dans cet exemple, on dirait @code{\@@dottedcline} ne prend que trois
+argument. Mais en remontant le code on s'aperçoit qu'elle prend
+également les deux arguments finaux @var{texte} et @var{numéro-page} du
+synopsis d'appel de @code{\contentsline} (@pxref{\contentsline}).
+
+ at cindex points de suite, pointillés dans la table des matières
+Entre la boîte du texte de titre de rubrique et la marge de droite, ces
+commandes @code{\@@dottedtocline} insèrent des @dfn{points de suite},
+c-à-d.@: une ligne en pointillés uniformément espacés. L'espace
+inter-point est donné par la commande @code{\@@dotsep}.  Par défaut
+c'est 4.5 (exprimé en unités de longueur mathématique, ou @code{mu},
+soit @code{1/18}@dmn{em}.  On peut le modifier avec
+ at code{\renewcommand}, comme dans
+ at code{\renewcommand@{\@@dotsep@}@{3.5@}}.
+
+Dans la classe standarde @file{book}, @LaTeX{} n'utilise pas de points
+de suite pour articles de la table correspondant aux rubriques de niveau
+ at code{\part} ou @code{\chapter}, et dans la classe @file{article}, il
+n'en utilise pas pour les articles de niveau @code{\section}.
+
+
 @node \addcontentsline
 @subsection @code{\addcontentsline}
 @findex \addcontentsline@{@var{ext}@}@{@var{unit}@}@{@var{texte}@}
@@ -17774,6 +17825,7 @@
 
 Synopsis :
 
+ at c attention référence au synoposis dans nœud \@dottedtocline
 @example
 \contentsline@{@var{unit}@}@{@var{texte}@}@{@var{numéro-page}@}
 @end example
@@ -17858,6 +17910,46 @@
 matières contiendra l'ancienne information.
 
 
+ at node \numberline
+ at subsection @code{\numberline}
+
+ at findex \numberline
+
+Synopsis :
+
+ at example
+\numberline@{\@var{numéro}@}
+ at end example
+
+Compose son argument fer à gauche dans une boîte. Cela est utilisé au
+sein d'une commande @code{\contentsline} pour composer les numéros de
+rubrique (@pxref{\contentsline}).
+
+Par exemple, cette ligne dans un fichier @file{.toc} a pour effer que le
+ at code{1.1} est composé fer à gauche :
+
+ at example
+\contentsline @{subsection@}@{\numberline @{1.1@}Motivation@}@{2@}
+ at end example
+
+Par défaut, @LaTeX{} compose tout numéro de rubrique au sein d'une boîte
+de longueur @code{\@@tempdima}.  Cette longueur est réglée par les
+commandes @code{\l@@section}, @code{\l@@subsection}, etc.  Pour Mettre
+les numéros de rubrique dans des boîtes de longueur naturelle utiliser le
+code @code{\renewcommand@{\numberline@}[1]@{#1~@}} avant
+ at code{\tableofcontents}.
+
+Cette commande est fragile, aussi vous pourriez avoir besoin de la
+précéder d'un @code{\protect} (@pxref{\protect}).  Un exemple
+est l'utilisation de @code{\protect} dans la commande
+ at code{\addcontentsline@{toc@}@{section@}@{\protect\numberline@{@}Sommaire@}}
+de sorte à obtenir le @code{\numberline} dans la commande
+ at code{\contentsline} dans le fichier @file{.toc} ainsi :
+ at code{\contentsline @{section@}@{\numberline @{@}Sommaire@}@{6@}} (le
+numéro de page @samp{6} est ajouté automatiquement par @LaTeX{} ;
+ at pxref{\addcontentsline}).
+
+
 @node Glossaries
 @section Glossaires
 @cindex glossaires