[latexrefman-commits] [SCM] latexrefman updated: r943 - trunk
Vincent Belaiche
INVALID.NOREPLY at gnu.org.ua
Wed Aug 4 07:27:18 CEST 2021
Author: vincentb1
Date: 2021-08-04 05:27:18 +0000 (Wed, 04 Aug 2021)
New Revision: 943
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
Log:
[fr] node \newcommand & \renewcommand align on English.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2021-08-04 05:25:04 UTC (rev 942)
+++ trunk/ChangeLog 2021-08-04 05:27:18 UTC (rev 943)
@@ -1,5 +1,9 @@
2021-08-04 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+ * latex2e-fr.texi (\newcommand & \renewcommand): Align node on English version.
+
+2021-08-04 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+
* latex2e-fr.texi (\clearpage & \cleardoublepage): Align node on English version.
2021-08-04 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2021-08-04 05:25:04 UTC (rev 942)
+++ trunk/latex2e-fr.texi 2021-08-04 05:27:18 UTC (rev 943)
@@ -9407,22 +9407,33 @@
@cindex définir une nouvelle commande
@cindex nouvelle commandes, définir
- at code{\newcommand} définit une nouvelle commande, et
- at code{\renewcommand} la redéfinit.
+Synopsis, l'un parmi :
-Synopsis :
+ at example
+\newcommand@{\@var{cmd}@}@{@var{défn}@}
+\newcommand@{\@var{cmd}@}[@var{nargs}]@{@var{défn}@}
+\newcommand@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@}
+\newcommand*@{\@var{cmd}@}@{@var{défn}@}
+\newcommand*@{\@var{cmd}@}[@var{nargs}]@{@var{défn}@}
+\newcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@}
+ at end example
+ at noindent
+ou parmi :
+
@example
- \newcommand@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@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}@}
- \newcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@}
+\renewcommand*@{\@var{cmd}@}@{@var{défn}@}
+\renewcommand*@{\@var{cmd}@}[@var{nargs}]@{@var{défn}@}
\renewcommand*@{\@var{cmd}@}[@var{nargs}][@var{optargdéfaut}]@{@var{défn}@}
@end example
- at c xxx Revoir la trad.
Définit ou redéfinit une commande (voir aussi la discussion de
@code{\DeclareRobustCommand} dans @ref{Class and package commands}).
+
@cindex forme en *, définir de nouvelles commandes
@cindex forme étoilée, définir de nouvelles commandes
@findex \long
@@ -9432,16 +9443,19 @@
@value{PlainTeX}). Avec la forme par défaut, il est possible qu'un
argument soit une multiplicité de paragraphes.
+Description des paramètres :
+
@table @var
@item cmd
-Obligatoire ; @code{\@var{cmd}} est le nom de la commande. Pour
- at code{\newcommand}, il ne doit pas être déja défini et ne doit pas
-commencer avec @code{\end} ; pour @code{\renewcommand}, il doit être
-déja défini.
+Obligatoire ; @code{\@var{cmd}} est le nom de la commande. Il doit
+commencer par une contr'olbique, @code{\}, et ne doit pas commencer avec
+la chaîne de 4 caractères @code{\end}. Pour @code{\newcommand}, il ne
+doit pas être déja défini et ne doit pas commencer avec @code{\end} ;
+pour @code{\renewcommand}, il doit être déja défini.
@item nargs
Optionnel ; un entier compris entre 1 et 9 spécifiant le nombre
-d'arguments que commande peut prendre, y compris un éventuel argument
+d'arguments que la commande prend, y compris un éventuel argument
optionnel. Si cet argument n'est pas présent, alors la spécification par
défaut est que la commande ne prend aucun argument. Lorsque on redéfinit
une commande, la nouvelle version peut prendre un nombre différent
@@ -9456,9 +9470,9 @@
@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{maval}]}, alors au sein de
+suite, comme dans @code{\@var{cmd}[@var{valopt}]}, alors au sein de
@var{défn} le premier @dfn{paramètre positionnel} @code{#1} se développe
-en @var{maval}. Par contre si @code{\@var{cmd}} est appelé sans crochet à
+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}.
@@ -9469,33 +9483,46 @@
alors que dans le second @code{#1} se développe en une chaîne vide.
@item défn
-Le texte par lequel substituer chaque occurrence de @code{\@var{cmd}} ; le
-paramètre positionnel @code{#@var{n}} au sein de @var{défn} est
-remplacée par le texte passé comme @var{n}ième argument.
+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).
@end table
- at TeX{} ignore les espaces dans le code source à la suite d'une commande (ou de
-toute séquence de contrôle), 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 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\ }).
Un exemple simple de définition d'une nouvelle commande :
@code{\newcommand@{\JM@}@{Jean Martin@}} a pour effet le remplacement de
-l'abréviation @code{\JM} par le texte plus long de la définition.
-
-La redéfinition d'une commande existante est similaire :
+ at code{\JM} par le texte plus long de la définition. La redéfinition
+d'une commande existante est similaire :
@code{\renewcommand@{\symbolecqfd@}@{@{\small CQFD@}@}}.
-Voici la définition d'une commande avec un argument obligatoire :
+Si vous tentez de définir une commande et que son nom 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}.
+Voici une première définition créant une commande sans
+argument, et une seconde avec un argument obligatoire.
+
@example
+\newcommand@{\etudiant@}@{Melle~O'Leary@}
\newcommand@{\defref@}[1]@{Définition~\ref@{#1@}@}
@end example
- at noindent Alors, @code{\defref@{def:basis@}} se développe en
- at code{Définition~\ref@{def:basis@}}, ce qui en fin de compte se développera en
+ at noindent
+Utilisez la première commande comme dans @code{Je confie \etudiant@{@} à
+vos bons soins}. La seconde commande a un argument variable, de sorte
+que @code{\defref@{def:base@}} se développe en
+ at code{Definition~\ref@{def:base@}}, ce qui en fin de compte se développera en
quelque-chose du genre de @samp{Définition~3.14}.
Un exemple avec deux arguments obligatoires :
@@ -9512,23 +9539,36 @@
@code{\salutation[Cher Jean]} donne @samp{Cher Jean,}. Et
@code{\salutation[]} donne @samp{,}.
-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 développement de @var{défn}.
-Ainsi la définition @code{\newcommand@{\nomnavire@}[1]@{\it #1@}} est problématique ;
-dans cette phrase
+Cet exemple a un argument optionnel et deux arguments obligatoires.
@example
+\newcommand@{\avocats@}[3][cie]@{#2, #3, et~#1@}
+J'emploie \avocats[Odette]@{Devoie@}@{Trichou@}.
+ at end example
+
+ at 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}.
+
+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
+développement de @var{défn}. Ainsi la définition
+ at code{\newcommand@{\nomnavire@}[1]@{\it #1@}} est problématique dans
+cette phrase :
+
+ at example
Le \nomnavire@{Monitor@} rencontra le \nomnavire@{Merrimac@}.
@end example
@noindent les mots @samp{rencontra le} sont mis incorrectement en
-italique. Une paire supplémentaire d'accolades est nécessaire, comme cela :
- at code{\newcommand@{\nomnavire@}[1]@{@{\it #1@}@}}. Ces accolades font partie de
-la définition et par conséquent définissent bien un groupe.
+italique. Une paire supplémentaire d'accolades est nécessaire, au sein
+de la définition : @code{\newcommand@{\nomnavire@}[1]@{@{\it #1@}@}}.
-
-
@node \providecommand
@section @code{\providecommand}
More information about the latexrefman-commits
mailing list.