[latexrefman-commits] [SCM] latexrefman updated: r1114 - trunk
Vincent Bela?che
INVALID.NOREPLY at gnu.org.ua
Mon Aug 22 11:56:26 CEST 2022
Author: vincentb1
Date: 2022-08-22 09:56:26 +0000 (Mon, 22 Aug 2022)
New Revision: 1114
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
Log:
[fr] Propagate Karl's r1083.
Clarify ``sequences of read characters'' -> ``stream of read
characters'', after discussing this with Karl.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2022-08-22 09:56:23 UTC (rev 1113)
+++ trunk/ChangeLog 2022-08-22 09:56:26 UTC (rev 1114)
@@ -1,5 +1,12 @@
2022-08-22 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+ [fr] Propagate Karl's r1083.
+
+ Clarify ``sequences of read characters'' -> ``stream of read
+ characters'', after discussing this with Karl.
+
+2022-08-22 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+
[fr] Propate Jim's r370.
2022-08-22 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2022-08-22 09:56:23 UTC (rev 1113)
+++ trunk/latex2e-fr.texi 2022-08-22 09:56:26 UTC (rev 1114)
@@ -10258,12 +10258,17 @@
@node \newcommand & \renewcommand
@section @code{\newcommand} & @code{\renewcommand}
+
+ at anchor{\newcommand}
+ at anchor{\renewcommand}
@findex \newcommand
@cindex commandes, en définir de nouvelles
+ at cindex commandes, redéfinir
@cindex définir une nouvelle commande
+ at cindex redéfinir une commande
@cindex nouvelle commandes, définir
-Synopsis, l'un parmi :
+Synopsis, l'un parmi (trois formes ordinaires, trois formes étoilées) :
@example
\newcommand@{\@var{cmd}@}@{@var{défn}@}
@@ -10275,11 +10280,12 @@
@end example
@noindent
-ou parmi :
+ou toutes les mêmes possibilités avec @code{\renewcommand} au lieu de
+ at code{\newcommand} :
@example
+\renewcommand@{\@var{cmd}@}@{@var{défn}@}
\renewcommand@{\@var{cmd}@}[@var{nargs}]@{@var{défn}@}
-\renewcommand@{\@var{cmd}@}[@var{nargs}]@{@var{défn}@}
\renewcommand@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@}
\renewcommand*@{\@var{cmd}@}@{@var{défn}@}
\renewcommand*@{\@var{cmd}@}[@var{nargs}]@{@var{défn}@}
@@ -10286,7 +10292,7 @@
\renewcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@}
@end example
-Définit ou redéfinit une commande (voir aussi la discussion de
+Définit ou redéfinit une commande (voir aussi
@code{\DeclareRobustCommand} dans @ref{Class and package commands}).
@@ -10299,7 +10305,7 @@
@value{PlainTeX}). Avec la forme par défaut, il est possible qu'un
argument soit une multiplicité de paragraphes.
-Description des paramètres :
+Description des paramètres (des exemples suivront) :
@table @var
@item cmd
@@ -10318,6 +10324,8 @@
d'arguments par rapport à l'ancienne.
@item optargdéfaut
+ at cindex optionnels, arguments, définir et utiliser
+ at cindex arguments optionnels, définir et utiliser
Optionnel ; si cet argument est présent, alors le premier argument de la
commande @code{\@var{cmd}} en définition est optionnel, et sa valeur par
défaut est @var{optargdéfaut} (qui peut être une chaîne vide). Si cet
@@ -10324,33 +10332,49 @@
argument n'est pas présent, alors @code{\@var{cmd}} ne prend pas
d'argument optionnel.
- at cindex paramètre positionnel
-C'est à dire que si @code{\@var{cmd}} est utilisé avec des crochets à la
-suite, comme dans @code{\@var{cmd}[@var{valopt}]}, alors au sein de
- at var{défn} le premier @dfn{paramètre positionnel} @code{#1} se développe
-en @var{valopt}. Par contre si @code{\@var{cmd}} est appelé sans crochet à
-la suite, alors au sein de @var{défn} le paramètre positionnel @code{#1}
-se développe en la valeur par défaut @var{optargdéfaut}. Dans tous les
-cas, tout argument obligatoire sera désigné en commençant par @code{#2}.
+C'est à dire que si @code{\@var{cmd}} est appelée avec à la suite un
+argument entre crochets, comme dans @code{\@var{cmd}[@var{valopt}]},
+alors au sein de @var{défn} le paramètre @code{#1} est réglé à
+ at var{valopt}. Par contre si @code{\@var{cmd}} est appelé sans crochet à
+la suite, alors au sein de @var{défn} le paramètre @code{#1} est réglé à
+ at var{optargdéfaut}. Dans les deux cas, les arguments obligatoires
+commencent par @code{#2}.
-Omettre @code{[@var{maval}]} dans un appel n'est pas la même chose
-qu'avoir les crochets ne contenant rien, comme dans @code{[]}. Dans le
-premier cas le paramètre @code{#1} se développe en @var{optargdéfaut} ;
-alors que dans le second @code{#1} se développe en une chaîne vide.
+Omettre @code{[@var{optargdéfaut}]} d'une définition est très différent
+de mettre des crochets vides, comme dans @code{[]}. Dans le premier cas
+on dit que la commande ainsi définie ne prend pas d'argument optionnel,
+de sorte que @code{#1} est le premier argument obligatoire (à supposer
+que @math{@var{nargs} @geq{} 1}) ; dans le second cas on règle
+l'argument optionnel @code{#1} à être une chaîne vide par défaut,
+c.-à-d.@: si aucun argument optionnel n'est donné à l'appel.
+De même, omettre @code{[@var{valopt}]} d'un appel est également très
+différent que de donner des crochets vides, comme dans @code{[]}. Dans
+le premier cas on règle @code{#1} à la valeur de @var{valopt} (à
+supposer que la commande a été définie pour prendre un argument
+optionnel) ; alors que dans le second on règle @code{#1} à la chaîne
+vide, comme on le ferait pour n'importe quelle autre valeur.
+
+Si une commande n'est pas définie pour prendre un argument optionnel,
+mais qu'elle est appelée avec un argument optionnel, les résultats sont
+imprévisibles : il peut y avoir une erreur @LaTeX{}, une sortie
+incorrectement composée, ou les deux.
+
@item défn
+ at cindex paramètres, substitution
Obligatoire ; le texte par lequel substituer chaque occurrence de
- at code{\@var{cmd}}. Les paramètres @code{#1}, @code{#2}, ...,
- at code{#@var{nargs}} sont remplacés par les valeurs que vous fournissez
-en appelant la command (ou par la valeur par défaut s'il y a un argument
-par défaut et que vous n'exercez pas l'option).
+ at code{\@var{cmd}}. Les paramètres @code{#1}, @code{#2}, @dots{},
+ at code{#@var{nargs}} sont remplacés par les valeurs fournies en appelant
+la commande (ou par @var{optargdéfaut} dans le cas d'un argument
+optionnel non spécifié dans l'appel, comme cela vient d'être expliqué).
@end table
+ at cindex blancs, après une séquence de contrôle
@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
+ at code{@{@}} après la commande (@samp{\cmd@{@} }), et une autre est
d'utiliser un espace de contrôle explicite (@samp{\cmd\ }).
Un exemple simple de définition d'une nouvelle commande :
@@ -10359,15 +10383,15 @@
d'une commande existante est similaire :
@code{\renewcommand@{\symbolecqfd@}@{@{\small CQFD@}@}}.
-Si vous tentez de définir une commande et que son nom a déjà été
+Si vous utilisez @code{\newcommand} et que le nom de commande a déjà été
utilisé alors vous obtenez quelque chose du genre de @samp{LaTeX Error:
Command \fred already defined. Or name \end... illegal, see p.192 of the
-manual}. Si vous tentez de redéfinir une command et que son nom n'a pas
-encore été utilisé alors vous obtenez quelque chose du genre de
- at samp{LaTeX Error: \hank undefined}.
+manual}. Si vous utilisez @code{\renewcommand} et que le nom de
+commande n'a pas encore été utilisé alors vous obtenez quelque chose du
+genre de @samp{LaTeX Error: \hank undefined}.
-Voici une première définition créant une commande sans
-argument, et une seconde avec un argument obligatoire.
+Dans l'exemple suivant la première définition crée une commande sans
+argument, et la seconde, une commande avec un argument obligatoire :
@example
\newcommand@{\etudiant@}@{Melle~O'Leary@}
@@ -10403,12 +10427,11 @@
@end example
@noindent
-En sortie on aura @samp{J'elmploie Devoie, Trichou, et Odette}.
-L'argument optionnel, c.-à-d.@: @code{Odette}, est associé à @code{#1},
-alors que @code{Devoie} et @code{Trichou} le sont à @code{#2}
-et @code{#3}. À cause de l'argument optionnel,
- at code{\avocats@{Devoie@}@{Trichou@}} donnera en sortie @samp{J'emploie
-Devoie, Trichou, et cie}.
+En sortie on a @samp{J'emploie Devoie, Trichou, et Odette}. L'argument
+optionnel, c.-à-d.@: @code{Odette}, est associé à @code{#1}, alors que
+ at code{Devoie} et @code{Trichou} le sont à @code{#2} et @code{#3}. À
+cause de l'argument optionnel, @code{\avocats@{Devoie@}@{Trichou@}}
+donne en sortie @samp{J'emploie Devoie, Trichou, et cie}.
Les accolades autour de @var{défn} ne définissent pas un groupe,
c.-à-d.@: qu'elle ne délimitent pas la portée du résultat du
@@ -10420,9 +10443,11 @@
Le \nomnavire@{Monitor@} rencontra le \nomnavire@{Merrimac@}.
@end example
- at noindent les mots @samp{rencontra le} sont mis incorrectement en
-italique. Une paire supplémentaire d'accolades est nécessaire, au sein
-de la définition : @code{\newcommand@{\nomnavire@}[1]@{@{\it #1@}@}}.
+ at noindent
+les mots @samp{rencontra le}, et le point, sont mis incorrectement en
+italique. La solution est de mettre une paire supplémentaire d'accolades
+au sein de la définition : @code{\newcommand@{\nomnavire@}[1]@{@{\it
+#1@}@}}.
@menu
* Control sequences:: Séquence de contrôle, mot de contrôle et symbole de contrôle.
@@ -10431,11 +10456,13 @@
@node Control sequences
@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équence d'@dfn{unités lexicales}, encore appelées
+ at cindex séquences de contrôle
+
+En lisant l'entrée @TeX{} convertit le flux des caractères lus en une
+séquence d'@dfn{unités lexicales}, encore appelées
@dfn{lexèmes}@footnote{En anglais c'est le terme jeton ---
@identity{token} --- qui est utilisé.}. Lorsque @TeX{} voit une
-contr'oblique @code{\}, il gère les caractères suivant d'une manière
+contr'oblique @code{\}, il gère les caractères suivants d'une manière
spéciale de sorte à former une unité lexicale @dfn{séquence de
contrôle}.
@@ -10443,23 +10470,30 @@
@itemize
@item
+ at cindex mot de contrôle, défini
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}.
+partir d'une @code{\} suivie par au moins une lettre ASCII (@code{A-Z}
+et @code{a-z}), suivie par au moins une non-lettre.
+
@item
+ at cindex symboles de contrôle, défini
Les @dfn{symboles de contrôle}, quand la séquence de contrôle est formée
-à partir d'une @code{\} suivi d'un unique caractère qui n'est pas une
-lettre.
+à partir d'une @code{\} suivi d'un unique caractère non-lettre.
@end itemize
+La séquence des caractères ainsi trouvés après le @code{\} est aussi
+appelé le @dfn{nom de la séquence de contrôle}.
+
Les blancs suivant un mot de contrôle sont ignorés et ne produisent
aucun espace blanc en sortie (@pxref{\newcommand & \renewcommand} et
@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 clarté de l'exemple :
+suivant imprime simplement @samp{Bonjour !}@inlinefmt{tex, on a utilisé
+des espaces visible @samp{@visiblespace{}} au lieu de
+blancs}@inlinefmt{info, (si vous utilisez la visionneuse info
+d'Emacs at comma{} activez le mode mineur @code{whitespace-mode} pour voir les
+espaces de traîne)} :
@example
Bon\relax at visiblespace{}@visiblespace{}@visiblespace{}
@@ -10508,9 +10542,9 @@
@end example
@noindent
-on a en sortie @samp{Depuis Saint Michael's College}. Contrairement
- at code{\newcommand}, on peut répéter @code{\providecommand} sans que cela
-produise une erreur.
+on a en sortie @samp{Depuis Saint Michael's College}. Contrairement à
+ at code{\newcommand}, l'utilisation répétée de @code{\providecommand} pour
+(essayer de) définir @code{\monaffiliation} ne produit pas d'erreur.
@node \makeatletter & \makeatother
@@ -11769,10 +11803,10 @@
@end ftable
-Trois autresn unités sont définies en fonction de la foute courante,
+Trois autres unités sont définies en fonction de la fonte courante,
plutôt que comme des dimensions absolues.
- at ftable code
+ at ftable @code
@item ex
@cindex x, hauteur d'un
@cindex ex
More information about the latexrefman-commits
mailing list.