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

[Vincent Belaiche]

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

Modified:
   trunk/ChangeLog
   trunk/latex2e-fr.texi
Log:
[fr] new node Control sequence.
* latex2e-fr.texi (Control sequence): Create node.


Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2021-08-12 21:36:47 UTC (rev 980)
+++ trunk/ChangeLog	2021-08-12 21:36:49 UTC (rev 981)
@@ -1,5 +1,9 @@
 2021-08-12  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
 
+	* latex2e-fr.texi (Control sequence): Create node.
+
+2021-08-12  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>
+
 	* latex2e-fr.texi (Making paragraph): align on English.
 
 2021-08-12  Vincent Bela\"iche  <vincentb1 at users.sourceforge.net>

Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi	2021-08-12 21:36:47 UTC (rev 980)
+++ trunk/latex2e-fr.texi	2021-08-12 21:36:49 UTC (rev 981)
@@ -159,6 +159,11 @@
 
 @c Best Effort Symbol
 @iftex
+ at macro visiblespace
+ at tex%
+{@tt at char`@ }%
+ at end tex at c
+ at end macro
 @macro BES {utf8,math}
 @math{\math\}
 @end macro
@@ -167,6 +172,9 @@
 @end macro
 @end iftex
 @ifnottex
+ at macro visiblespace
+␣
+ at end macro
 @macro BES {utf8,math}
 \utf8\
 @end macro
@@ -9493,11 +9501,11 @@
 
 @end table
 
- at TeX{} ignore les espaces dans le code source à la suite d'une séquence
-de contrôle alphabétique, comme dans @samp{\cmd }. Si vous désirez une
-espace réellement à cet endroit, une solution est de taper @code{@{@}}
-après la commande (@samp{\cmd@{@} }), et un autre est d'utiliser un
-espace de contrôle explicite (@samp{\cmd\ }).
+ at TeX{} ignore les blancs dans le code source à la suite d'un mot de
+contrôle (@pxref{Control sequences}), comme dans @samp{\cmd }. Si vous
+désirez une espace réellement à cet endroit, une solution est de taper
+ at code{@{@}} après la commande (@samp{\cmd@{@} }), et un autre est
+d'utiliser un espace de contrôle explicite (@samp{\cmd\ }).
 
 Un exemple simple de définition d'une nouvelle commande :
 @code{\newcommand@{\JM@}@{Jean Martin@}} a pour effet le remplacement de
@@ -9570,7 +9578,53 @@
 italique. Une paire supplémentaire d'accolades est nécessaire, au sein
 de la définition : @code{\newcommand@{\nomnavire@}[1]@{@{\it #1@}@}}.
 
+ at menu
+* Control sequences:: Séquence de contrôle, mot de contrôle et symbole de contrôle.
+ at end menu
 
+ at node Control sequences
+ at subsection Séquence de contrôle, mot de contrôle et symbole de contrôle
+
+En lisant l'entrée @TeX{} convertit la séquence des caractères lus en une
+sésuence d'@dfn{unités lexicales}, encore apelées
+ at dfn{lexèmes}@footnote{En anglais c'est le terme jeton --- token --- qui
+est utilisé.}. Lorsque @TeX{} voit une contr'oblique @code{\}, il gère
+les caractères suivant d'une manière spéciale de sorte à former une
+unité lexicale @dfn{séquence de contrôle}.
+
+Les séquences de contrôle peuvent être classées en deux catégories :
+
+ at itemize
+ at item
+Les @dfn{mots de contrôle}, quand la séquence de contrôle est formée à
+partir d'une @code{\} suivie par au moins une lettre ASCII, suivie par
+au moins un blanc. La séquence des au moins une lettre ASCII forme ce
+qu'on appel le @dfn{nom de la séquence de contrôle}.
+ at item
+Les @dfn{symboles de contrôle}, quand la séquence de contrôle est formée
+à partier d'une @code{\} suivi d'un unique caractère qui n'est pas une
+lettre.
+ at end itemize
+
+Les blancs suivant un mot de contrôle sont ignorés et ne produisent
+aucun espace blanc en sortie (@pxref{\newcommand & \renewcommand} et
+ at ref{\(SPACE)}).
+
+Étant donné que la commande @code{\relax} ne fait rien, l'exemple
+suivant imprime @samp{Bonjour !} --- on a utilisé des espaces visible
+ at samp{@visiblespace{}} au lieu de blancs pour la clareté de l'exemple :
+
+ at example
+Bon\relax at visiblespace{}@visiblespace{}@visiblespace{}
+ at visiblespace{}@visiblespace{}@visiblespace{}jour !
+ at end example
+
+ at noindent
+Ceci parce que les blancs suivant @code{\relax}, y compris le caractère
+saut-de-ligne, sont ignorés, et que les blancs en début de ligne sont
+aussi ignorés (@pxref{Leading blanks}).
+
+
 @node \providecommand
 @section @code{\providecommand}
 
@@ -9797,14 +9851,14 @@
 @end example
 
 Alloue un nouveau registre de longueur (@pxref{Lengths}). L'argument
-obligatoire @code{\@var{longueur}} doit être une séquence de contrôle,
-et donc commencer par une contr'oblique @code{\} dans les circonstances
-normales. Le nouveau registre détient des longueurs (élastiques) telles
-que @code{72.27pt} ou @code{1in plus.2in minus.1in} (un registre de
-longueur @LaTeX{} est ce que @value{PlainTeX} appelle un registre
- at code{skip}, ou registre de pas). Le registre est créé avec une valeur
-initiale de zéro. La séquence de contrôle @code{\@var{longueur}} doit ne
-pas être déjà définie.
+obligatoire @code{\@var{longueur}} doit être une séquence de contrôle
+(@pxref{Control sequences}), et donc commencer par une contr'oblique
+ at code{\} dans les circonstances normales. Le nouveau registre détient
+des longueurs (élastiques) telles que @code{72.27pt} ou @code{1in
+plus.2in minus.1in} (un registre de longueur @LaTeX{} est ce que
+ at value{PlainTeX} appelle un registre @code{skip}, ou registre de
+pas). Le registre est créé avec une valeur initiale de zéro. La séquence
+de contrôle @code{\@var{longueur}} doit ne pas être déjà définie.
 
 Voici une exemple :
 
@@ -9818,8 +9872,6 @@
 Error: Command \graphichgt already defined.  Or name \end... illegal,
 see p.192 of the manual}.
 
-
-
 @node \newsavebox
 @section @code{\newsavebox} : allouer une boîte
 
@@ -10697,11 +10749,11 @@
 
 La commande @code{\setlength} règle la longueur \@var{longueur} à
 @var{quantité}. Le nom @code{\@var{longueur}} doit être une séquence de
-contrôle, et donc commencer par une contr'oblique @code{\} dans les
-circonstances normales. La @var{quantité} peut être une longueur
-élastique (@pxref{Lengths}). Elle peut être positve, négative ou nulle,
-et peut être exprimée dans n'importe quelle unité comprise par @LaTeX{}
-(@pxref{Units of length}).
+contrôle (@pxref{Control sequences}), et donc commencer par une
+contr'oblique @code{\} dans les circonstances normales. La
+ at var{quantité} peut être une longueur élastique (@pxref{Lengths}). Elle
+peut être positve, négative ou nulle, et peut être exprimée dans
+n'importe quelle unité comprise par @LaTeX{} (@pxref{Units of length}).
 
 Ci-dessous, avec les réglages par défaut de @LaTeX{} le premier
 paragraphe est renfoncé alors que le second ne l'est pas.
@@ -10734,12 +10786,12 @@
 @end example
 
 Incrémente la longueur @code{\@var{longueur}} par @var{quantité}. Le nom
- at code{\@var{longueur}} doit être une séquence de contrôle, et donc
-commencer par une contr'oblique @code{\} dans les circonstances
-normales. La @var{quantité} peut être une longueur
-élastique (@pxref{Lengths}). Elle peut être positve, négative ou nulle,
-et peut être exprimée dans n'importe quelle unité comprise par @LaTeX{}
-(@pxref{Units of length}).
+ at code{\@var{longueur}} doit être une séquence de contrôle
+(@pxref{Control sequences}), et donc commencer par une contr'oblique
+ at code{\} dans les circonstances normales. La @var{quantité} peut être
+une longueur élastique (@pxref{Lengths}). Elle peut être positve,
+négative ou nulle, et peut être exprimée dans n'importe quelle unité
+comprise par @LaTeX{} (@pxref{Units of length}).
 
 Dans l'exemple ci-dessous, si @code{\parskip} commmence avec la valeur
 @code{0pt plus 1pt}
@@ -10783,8 +10835,8 @@
 La commande @code{\settodepth} règle la longueur @code{\@var{longueur}}
 à la profondeur de la boîte que @LaTeX{} obtient en composant l'argument
 @code{texte}. Le nom @code{\@var{longueur}} doit être une séquence de
-contrôle, et donc commencer par une contr'oblique @code{\} dans les
-circonstances normales.
+contrôle (@pxref{Control sequences}), et donc commencer par une
+contr'oblique @code{\} dans les circonstances normales.
 
 L'exemple ci-dessous imprime la profondeur maximale des descendantes de
 l'alphabet :
@@ -10818,8 +10870,8 @@
 La commande @code{\settoheight} règle la longueur @code{\@var{longueur}}
 à la hauteur de la boîte ue @LaTeX{} obtient en composant l'argument
 @code{texte}. Le nom @code{\@var{longueur}} doit être une séquence de
-contrôle, et donc commencer par une contr'oblique @code{\} dans les
-circonstances normales.
+contrôle (@pxref{Control sequences}), et donc commencer par une
+contr'oblique @code{\} dans les circonstances normales.
 
 L'exemple suivant imprime la hauteur maximale des ascendantes de
 l'alphabet ASCII bas de casse :
@@ -10855,8 +10907,8 @@
 La commande @code{\settowidth} règle la longueur @code{\@var{longueur}}
 à la largeur de la boîte que @LaTeX{} obtient en composant l'argument
 @code{texte}. Le nom @code{\@var{longueur}} doit être une séquence de
-contrôle, et donc commencer par une contr'oblique @code{\} dans les
-circonstances normales.
+contrôle (@pxref{Control sequences}), et donc commencer par une
+contr'oblique @code{\} dans les circonstances normales.
 
 L'exemple suivant imprime la largeur de l'alphabet ASCII bas de casse :
 
@@ -13749,6 +13801,18 @@
 @code{\}@key{sautdeligne} sont équivalents à contr'oblique-espace,
 @code{\ }.
 
+ at anchor{Leading blanks}
+Veuillez aussi noter que de sorte à autoriser le renfoncement du code, dans les criconstances normales, @TeX{} ignore les blancs au début de chaque ligne. Ainsi l'exemple suivant imprime @samp{À moi comte deux mots}:
+
+ at example
+À moi, Comte,
+ deux mots !
+ at end example
+
+ at noindent
+où l'espace blanc entre @samp{Comte,} et @samp{deux} est produit par le
+saut de ligne après @samp{comte}, et non par l'espace avant @samp{deux}.
+
 @c @PkgIndex{xspace}
 @c Certaines commandes, notamment celles définies avec le paquetage
 @c @code{xspace}, ne suivent pas ce comportement standard.