[latexrefman-commits] [SCM] latexrefman updated: r799 - trunk
vincentb1 at gnu.org.ua
vincentb1 at gnu.org.ua
Mon Apr 20 07:22:58 CEST 2020
Author: vincentb1
Date: 2020-04-20 08:22:58 +0300 (Mon, 20 Apr 2020)
New Revision: 799
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
trunk/latex2e.texi
Log:
[fr] Propagate Karl's r798.
* latex2e.texi (\read): Insert space before @var{number}
(\write): Align vertically the %1, %2, %3 comments in example.
(\write): Typo ?\194?\171?\194?\16019?\194?\160?\194?\187 ?\226?\134?\146 ?\194?\171?\194?\16018?\194?\160?\194?\187 in stream number cindex entry.
(\write): Fix Security menu entry.
* latex2e-fr.texi: See Karl's r798
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2020-04-19 17:51:46 UTC (rev 798)
+++ trunk/ChangeLog 2020-04-20 05:22:58 UTC (rev 799)
@@ -1,3 +1,12 @@
+2020-04-20 Vincent Belaïche <vincentb1 at users.sourceforge.net>
+
+ * latex2e.texi (\read): Insert space before @var{number}
+ (\write): Align vertically the %1, %2, %3 comments in example.
+ (\write): Typo « 19 » → « 18 » in stream number cindex entry.
+ (\write): Fix Security menu entry.
+
+ * latex2e-fr.texi: See Karl's r798 in previous revision.
+
2020-04-19 Karl Berry <karl at freefriends.org>
* latex2e.texi (\write): edits throughout; more index entries.
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2020-04-19 17:51:46 UTC (rev 798)
+++ trunk/latex2e-fr.texi 2020-04-20 05:22:58 UTC (rev 799)
@@ -69,7 +69,7 @@
utilisé @cite{Hypertext Help with @LaTeX{}}, de Sheldon Green, et
@cite{@LaTeX{} Command Summary} (pour @LaTeX{}2.09) de L. Botway et
C. Biemesderfer (publié par le @TeX{} Users Group en tant que
- at cite{@TeX{}niques} numéro 10)i ; il a utilisé ces documents en tant que matériel de
+ at cite{@TeX{}niques} numéro 10) ; il a utilisé ces documents en tant que matériel de
référence et n'en a copié aucun texte directement.
Tous droits réservés @copyright{} 2015-2020 Vincent Belaïche --- traduction.@*
@@ -14293,7 +14293,7 @@
Synopsis :
@example
-\read at var{numéro} to at var{macro}
+\read @var{numéro} to at var{macro}
@end example
Fait que la commande @var{macro} contienne la ligne suivante d'entrée du
@@ -14378,8 +14378,8 @@
\write at var{numéro}@{@var{chaîne}@}
@end example
-Write @var{chaîne} dans le fichier journal (@file{.log}), vers le
-terminal, ou dans un fichier ouvert par @code{\openout}. Par exemple,
+Écrit @var{chaîne} vers le fichier journal (@file{.log}), vers le
+terminal, ou vers un fichier ouvert par @code{\openout}. Par exemple,
@code{\write6} écrit vers le flux textuel numéro 6
Si le code suivant apparaît dans le fichier @file{@var{fichierbase}.tex}
@@ -14388,22 +14388,26 @@
@example
\newwrite\monfichier
-\immediate\openout\monfichier=\jobname.jh % \jobname le the nom de base fichier racine
- ...
+\immediate\openout\monfichier=\jobname.jh % \jobname est le nom de base fichier racine
+...
\immediate\write\monfichier@{Bonjour tout le monde !@}
...
\immediate\closeout\monfichier
@end example
+ at findex \newwrite
@noindent
Le @code{\newwrite} alloue un numéro de flux, en lui donnant un nom
-symbolique pour se faciliter la vie, de sorte que @code{test
+symbolique pour se faciliter la vie, de sorte que @code{flux
\newwrite\monfichier\the\monfichier} produit quelque-chose du genre de
- at samp{test 3}. Ensuite @code{\openout} associe le numéro de flux avec
-le nom de fichier fourni. Avec ceci, @code{\write3} place la chaîne
-dans le fichier.
+ at samp{flux 3}. Ensuite @code{\openout} associe le numéro de flux avec
+le nom de fichier fourni. Et puis à la fin @TeX{} exécute
+ at code{\write3} ce qui place la chaîne dans le fichier.
-Typiquement @var{numéro} est compris entre 0 et 15 parce que typiquement
+ at cindex journal, écrire vers le fichier
+ at cindex terminal, écrire vers le
+ at cindex @math{-1}, écrire dans le flux numéro
+Typiquement @var{numéro} est compris entre 0 et 15, parce que typiquement
les auteurs @LaTeX{} suivent l'exemple précédent et le numéro est alloué
par le système. Si @var{numéro} est hors de l'intervalle de 0 à 15 ou
si il n'est pas associé à un fichier ouvert alors @LaTeX{} écrit
@@ -14417,80 +14421,128 @@
saut de ligne dans la sortie terminal. (Mais 16, 17, et 18 sont des
valeurs spéciales de @var{numéro} ; voir ci-dessous.)
+ at cindex Lua at TeX{}, 256 flux de sortie dans
Dans Lua at TeX{}, au lieu de 16 flux de sortie il y en a 256
(@pxref{@TeX{} engines}).
-On écrit dans le fichier @file{.aux} courant qui est associé au fichier
-racine ou au fichier inclus courant, en utilisant
- at code{\write\@@auxout@{@var{chaîne}@}}. On écrit vers le fichier
- at file{.aux} principal en utilisant
- at code{\write\@@mainaux@{@var{chaîne}@}}.
+ at findex \@@auxout
+ at findex \@@mainaux
+Utilisez @code{\write\@@auxout@{@var{chaîne}@}} pour écrire vers le
+fichier @file{.aux} courant qui est associé soit au fichier racine soit
+au fichier inclus courant ; et utilisez
+ at code{\write\@@mainaux@{@var{chaîne}@}} pour écrire le fichier
+ at file{.aux} principal. Ces noms symboliques sont définis par @LaTeX{}.
- at c Credit: David Carlisle https://tex.stackexchange.com/a/115933/121234
+ at c credit: David Carlisle https://tex.stackexchange.com/a/115933/121234
Par défaut @LaTeX{} n'écrit pas @var{chaîne} vers le fichier
-immediatement. C'est ainsi parce que, par exemple, vous pourriez
-utiliser @code{\write} pour sauvegarder le numéro de page courant mais
-au moment où @TeX{} rencontre une commande @code{\write} il pourrait ne
-pas être encore sûr de quelle page est-ce, puisque il n'a pas encore
-découpé la sortie en pages. Ainsi vous utilisez @code{\write} dans l'un
-des trois contextes suivants.
+immediatement. C'est ainsi parce que, par exemple, vous pourriez avoir
+besoin de @code{\write} pour sauvegarder le numéro de page courant, mais
+au moment où @TeX{} rencontre une commande @code{\write} tpyiquement il
+ne connaît pas quel est le numéro de page, puisque il n'a pas encore
+découpé la sortie en pages. Ainsi, vous utilisez @code{\write} dans
+l'un des trois contextes suivants :
@example
-\immediate\write\@@auxout@{@var{chaîne}@}
-\write\@@auxout@{@var{chaîne}@}
-\protected@@write\@@auxout@{@}@{@var{chaîne}@}
+\immediate\write\@@auxout@{@var{chaîne}@} %1
+\write\@@auxout@{@var{chaîne}@} %2
+\protected@@write\@@auxout@{@}@{@var{chaîne}@} %3
@end example
-Avec le premier, @LaTeX{} écrit @var{chaîne} vers le fichier. Toutes
-les macros dans @var{chaîne} sont développés (exactement comme dans
- at code{\edef} de sorte que pour empêcher le développement vous pouvez
-utiliser @code{\noexpand} ou un @code{toks}, mais avec la différence que
-vous devez utiliser @code{#} au lieu de @code{##}). Avec le deuxième,
- at var{chaîne} est stocké dans la liste courante des choses (comme un
-« machin » de @TeX{}) et conservé jusqu'à ce que la page soit éjectée et
-de la même manière les macros ne sont pas développées jusqu'à
-l'éjection. Le troisième, @code{\protected@@write}, est sembable au
-deuxième sauf que vous pouvez utiliser @code{\protect} sur les macros
-fragiles. Le premier argument qui est en plus vous permet d'insérer
+ at enumerate
+ at item
+ at cindex @code{\write} immédiat
+ at findex \immediate\write
+Avec le premier, @LaTeX{} écrit @var{chaîne} vers le fichier
+immédiatement. Toutes les macros dans @var{chaîne} sont développées à
+fond (exactement comme dans @code{\edef} de sorte que pour empêcher le
+développement vous devez utiliser @code{\noexpand}, un @code{toks}, etc.
+mais avec la différence que vous devez utiliser @code{#} au lieu de
+ at code{##}).
+
+ at item
+ at cindex @code{\write} retardé
+ at cindex élément extraordinaire
+ at findex \shipout @r{et développement}
+Avec le deuxième, @var{chaîne} est stocké dans la liste courante des
+choses (comme un élémént « extraordinaire » de @TeX{}) et conservé
+jusqu'à ce que la page soit éjectée et de la même manière les macros ne
+sont pas développées jusqu'à l'éjection (@code{\shipout}). Au moment du
+ at code{\shipout}, @var{chaîne} est développée à fond.
+
+ at item
+ at findex \protected@@write
+Le troisième, @code{\protected@@write}, est sembable au deuxième sauf
+que vous pouvez utiliser @code{\protect} pour éviter le
+développement. Le premier argument qui est en plus vous permet d'insérer
locallement des définitions supplémentaires pour que plus de macros
-soient sûre ou aient une définition spéciale pendant l'écriture.
+soient protégées ou pour avoir d'autres définitions spéciales pendant
+l'écriture.
+ at end enumerate
-Dans l'exemple suivant @var{chaîne} contient une séquence de contrôle.
+Voici un exemple simple de développement avec @code{\write} dans lequel
+ at var{chaîne} contient une séquence de contrôle @code{\triplex} que l'on
+a définie comme le texte @samp{XYZ} :
+
@example
\newwrite\fichierjh
\openout\fichierjh=test.jh
-\newcommand@{\triplex@}@{XXX@}
+\newcommand@{\triplex@}@{XYZ@}
\write\fichierjh@{test \triplex test@}
@end example
@noindent
-Ceci résulte en ce que le fichier @file{test.jh} contienne @samp{test
-XXXtest} suivi d'un saut de ligne.
+Ceci résulte en ce que le fichier @file{test.jh} contienne le texte
+ at samp{test XYZtest} suivi d'un saut de ligne.
+ at cindex @code{\write}, flux 16, 17, 18
Les cas où @var{numéro} vaut 16, 17, ou 18 sont spéciaux. À cause du
comportement de @code{\write} quand @var{numéro} est hors de
l'intervalle de 0 à 15 qu'on a déjà décrit plus haut, dans Plain @TeX{}
@code{\write16} et @code{\write17} étaient parfois utilisés pour écrire
-dans le fichier journal et le terminal. Notez que dans @LaTeX{} la
+dans le fichier journal et le terminal ; toutefois, dans @LaTeX{}, la
façon naturelle de faire ceci est d'utiliser @code{\typeout}
(@pxref{\typeout}). La commande @code{\write18} est encore plus
spéciale ; les systèmes @TeX{} modernes l'utilisent pour passer des
commandes au système d'exploitation (@pxref{\write18}).
-D'ordinaire @code{\write} produit en sortie une unique ligne. On y
-rajoute un saut de ligne avec @code{^^J}. Ainsi, l'exemple suivant
-produit deux lignes dans le fichier journal.
+ at cindex saut de ligne, dans @code{\write}
+ at cindex @code{^^J}, dans @code{\write}
+D'ordinaire @code{\write} produit en sortie une unique ligne. On peut y
+insérer un saut de ligne avec @code{^^J}. Ainsi, l'exemple suivant
+produit deux lignes dans le fichier journal :
@example
\wlog@{Les lignes parallèles ont beaucoup en commun.^^JMais elles ne se
rencontrent jamais.@}
@end example
+ at PkgIndex{answers}
+Un cas usuel dans lequel des auteurs tentent d'écrire dans leur propre
+fichier est pour les réponses à des exerccies, ou dans quelque autre
+situation où vous désirer écrire en sortie verbatim, sans développer les
+macros. CTAN a plusieurs paquetages pour cela ; parmi lesquels
+ at file{answers}.
+
+ at menu
+* \write et la securité: \write and security. Sécurité.
+* \message:: Écrit du texte vers le fichier journal et le terminal.
+* \wlog:: Écrit du texte vers le fichier journal.
+* \write18:: Exécute une commande du système d'exploitation.
+ at end menu
+
+ at node \write and security
+ at subsection @code{\write} et la sécurité
+
+ at cindex securité et @code{\write}
+ at cindex @code{\write} et sécurité
+
La possibilité d'écrire dans des fichier soulève des problèmes de
sécurtié. Si vous compilez un fichier @LaTeX{} téléchargé et qu'il
-écrase votre fichier de mot de passe alors vous serez à juste titre
-embêté. Les systèmes @TeX{} par défaut ne vous autorise à ouvrir en
+écrase votre fichier de mots de passe alors vous serez à juste titre
+embêté.
+
+Ainsi par défaut les systèmes @TeX{} ne vous autorisent à ouvrir en
écriture que les fichiers qui sont dans le répertoire courant ou dans un
sousrépertoire. L'exemple suivant
@@ -14500,28 +14552,24 @@
@end example
@noindent
-produit une erreur du genre de @samp{Not writing to ../test.jh
-(openout_any = p). ! I can't write on file `../test.jh'}. Notez qu'il
-est possible d'avoir une telle erreur lorsqu'on essaie d'utiliser une
-commande telle que @code{\include@{../filename@}} puisque @LaTeX{} va
+produit une erreur du genre de :
+ at example
+Not writing to ../test.jh (openout_any = p).
+! I can't write on file `../test.jh'
+ at end example
+
+ at cindex répertoires parents, impossible d'écrire vers
+You can get just such an error when using commands such as
+ at code{\include@{../filename@}} because @LaTeX{} will try to open
+ at file{../filename.aux}. The simplest solution is to put the included
+files in the same directory as the root file, or in subdirectories.
+
+Il est possible d'avoir une telle erreur lorsqu'on essaie d'utiliser une
+commande telle que @code{\include@{../nomfichier@}} puisque @LaTeX{} va
essayer d'ouvrir @file{../filename.aux}. La solution la plus simple est
de placer les fichiers inclus dans le même répertoire que le fichier
-racine, ou dans des sous-répertoire.
+racine, ou dans des sous-répertoires.
- at PkgIndex{answers}
-Un cas usuel dans lequel des auteurs tentent d'écrire dans un fichier
-qui n'est pas encore fourni par @LaTeX{} est pour les réponse à des
-exerccies, ou dans quelque autre situation où vous désirer écrire en
-sortie verbatim, dans développer les macros. CTAN a plusieurs
-paquetages pour cela ; parmi lesquels @file{answers}.
-
- at menu
-* \message:: Écrit du texte vers le fichier journal et le terminal.
-* \wlog:: Écrit du texte vers le fichier journal.
-* \write18:: Exécute une commande du système d'exploitation.
- at end menu
-
-
@node \message
@subsection @code{\message}
@@ -14615,7 +14663,6 @@
@node \write18
@subsection @code{\write18}
- at c xxx À traduire
@findex \write18
@cindex externes, commandes
@cindex commandes exécutées depuis @LaTeX{}
@@ -14708,7 +14755,7 @@
@findex SHELL at r{, environnement, variables de}
@findex SHELL at r{, variables d'environnement}
Le texte @var{commande_shell} est toujours passé à @file{/bin/sh} sur
-les système d'exploitation unixiens, et à l'interpréteur de commande DOS
+les systèmes d'exploitation unixiens, et à l'interpréteur de commande DOS
@file{cmd.exe} sur Windows. @LaTeX{} ignore tout réglage d'un autre
interpréteur de commande par l'utilisateur, ainsi que la variable
d'environnement @code{SHELL}.
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2020-04-19 17:51:46 UTC (rev 798)
+++ trunk/latex2e.texi 2020-04-20 05:22:58 UTC (rev 799)
@@ -19582,7 +19582,7 @@
Synopsis:
@example
-\read at var{number} to at var{macro}
+\read @var{number} to at var{macro}
@end example
Make the command @var{macro} contain the next line of input from text
@@ -19797,8 +19797,8 @@
in one of three contexts:
@example
-\immediate\write\@@auxout@{@var{string}@} %1
-\write\@@auxout@{@var{string}@} %2
+\immediate\write\@@auxout@{@var{string}@} %1
+\write\@@auxout@{@var{string}@} %2
\protected@@write\@@auxout@{@}@{@var{string}@} %3
@end example
@@ -19845,7 +19845,7 @@
This results in the file @file{test.jh} containing the text
@samp{test XYZtest} followed by a newline.
- at cindex @code{\write} streams 16, 17, 19
+ at cindex @code{\write} streams 16, 17, 18
The cases where @var{number} is 16, 17, or 18 are special. Because of
@code{\write}'s behavior when @var{number} is outside the range from 0
to 15 described above, in Plain at tie{}@TeX{} @code{\write16} and
@@ -19872,7 +19872,7 @@
packages for this; one is @file{answers}.
@menu
-* Security: \write and security.
+* \write and security:: Security.
* \message:: Write text to the log file and terminal.
* \wlog:: Write text to the log file.
* \write18:: Run an operating system command.
More information about the latexrefman-commits
mailing list.