[latexrefman-commits] [SCM] latexrefman updated: r884 - trunk
vincentb1 at gnu.org.ua
vincentb1 at gnu.org.ua
Thu Dec 24 15:23:21 CET 2020
Author: vincentb1
Date: 2020-12-24 16:23:20 +0200 (Thu, 24 Dec 2020)
New Revision: 884
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
trunk/latex2e.texi
Log:
[fr,en] verbatim.
* latex2e-fr.texi (\verb): Typoes.
(verbatim): Align on English.
* latex2e.texi (verbatim): Explain why it cannot be used within a
macro argument. Forward reference to CTAN node.
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2020-12-24 13:49:06 UTC (rev 883)
+++ trunk/ChangeLog 2020-12-24 14:23:20 UTC (rev 884)
@@ -1,5 +1,13 @@
2020-12-24 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+ * latex2e.texi (verbatim): Explain why it cannot be used within a
+ macro argument. Forward reference to CTAN node.
+
+ * latex2e-fr.texi (\verb): Typoes.
+ (verbatim): Align on English.
+
+2020-12-24 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+
* latex2e-fr.texi (titlepage): Align on English.
2020-12-24 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2020-12-24 13:49:06 UTC (rev 883)
+++ trunk/latex2e-fr.texi 2020-12-24 14:23:20 UTC (rev 884)
@@ -7663,25 +7663,60 @@
@cindex simuler du texte tapuscrit
@cindex texte tapuscrit, simulation de
@cindex code source, composer du
- at cindex source logiciel, composer du
+ at cindex programmes informatiques, composer du
Synopsis :
@example
\begin@{verbatim@}
- at var{literal-texte}
+ at var{texte-litéral}
\end@{verbatim@}
@end example
L'environnement @code{verbatim} est un environnement qui fabrique des
-paragraphes dans lequel @LaTeX{} produit exactement ce qui vous y taez ;
-par exemple le caractère @code{\} produit @samp{\} à l'impression . Il,
-fait de @LaTeX{} une machine à écrire, c.-à-d.@: que le retour chariot
-et les blancs y ont un tel effet.
+paragraphes dans lequel @LaTeX{} produit exactement ce qui vous y tapez.
+Par exemple au sein de @var{texte-litéral} le caractère @code{\} ne
+commence pas de commande, il produit @samp{\} à l'impression, et les
+retour chariot et les blancs sont pris littéralement. La sortie
+appraraît dans une police genre tapuscrit (encore appelé « machine à
+écrire ») à chasse fixe (@code{\tt}).
-L'environnement @code{verbatim} utilise une police de type tapuscrit
-(encore appelé « machine à écrire ») à chasse fixe (@code{\tt}).
+ at example
+\begin@{verbatim@}
+Juron symbolique : %&$#?@!.
+\end@{verbatim@}
+ at end example
+La seule restriction sur @code{text-literale} est qu'il ne peut pas
+inclure la chaîne @code{\end@{verbatim@}}.
+
+ at PkgIndex{cprotect}
+
+Il est impossible d'utiliser l'environnement @code{verbatim} au sein
+d'un argument de macro, par exemple dans l'argument passé à
+ at code{\section}. Ce n'est pas le même problème que celui des commandes
+fragiles (@pxref{\protect}), mais c'est juste impossible parce que
+l'environnement @code{verbatim} change le régime de catcode avant de
+traiter son contenu, et le rétablit juste après, or au sein d'un argument
+de macro le contenu de l'argument est déjà converti en une liste
+d'unités lexicales selon le régime de catcode courant à l'appel de la
+macro. Cependant, le paquetage @code{cprotect} peut être utile dans
+cette situation.
+
+ at PkgIndex{listings} @PkgIndex{minted}
+Une utilisation courante d'entrée verbatim est de composer du code
+informatique. Il y a des paquetages qui améliorent l'environnement
+ at code{verbatim}. Par exemple, une amélioration est de permettre
+l'inclusion verbatim de fichiers externes, totalement ou en
+partie. Parmi ces paquetages : @code{listings} et @code{minted}.
+
+ at PkgIndex{fancyvrb}
+ at PkgIndex{verbatimbox}
+Un paquetage qui offre beaucoup plus d'options pour les environnements
+verbatim est @code{fancyvrb}. Un autre @code{verbatimbox}.
+
+Pour une liste complète de tous les paquetages pertinents voir le CTAN (@pxref{CTAN}).
+
@menu
* \verb:: La forme macro de l'environnement @code{verbatim}.
@end menu
@@ -7734,13 +7769,12 @@
Vous ne pouvez pas utiliser @code{\verb} au sein d'un argument de macro,
par exemple dans l'argument passé à @code{\section}. Ce n'est pas une
question que @code{\verb} serait fragile (@pxref{\protect}), mais c'est
-juste imposslbe parce que la commande @code{\verb} change le régime de
-catcode avant de lire son argument et le rétabli juste après, or au sein
+juste impossible parce que la commande @code{\verb} change le régime de
+catcode avant de lire son argument et le rétablit juste après, or au sein
d'un argument de macro le contenu de l'argument a déjà été converti en
-une liste d'unités lexicale selon le régime de catcode courant lorsque
-la macro a été appelée.
-Cependant, le paquetage @code{cprotect} peut être utile dans cette
-situation.
+une liste d'unités lexicales selon le régime de catcode courant l'appel
+de la macro. Cependant, le paquetage @code{cprotect} peut être utile
+dans cette situation.
@node verse
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2020-12-24 13:49:06 UTC (rev 883)
+++ trunk/latex2e.texi 2020-12-24 14:23:20 UTC (rev 884)
@@ -8017,8 +8017,13 @@
@PkgIndex{cprotect}
You cannot use the verbatim environment in the argument to macros, for
instance in the argument to a @code{\section}. This is not the same as
-commands being fragile (@pxref{\protect}), instead it just cannot appear
-there. (But the @code{cprotect} package can help with this.)
+commands being fragile (@pxref{\protect}), instead it just cannot work,
+as the @code{verbatim} environment changes the catcode regime before
+processing its contents, and restore it immediately afterward,
+nevertheless with a macro argument the content of the argument has
+already be converted to a token list along the catcode regime in effect
+when the macro was called. However, the @code{cprotect} package can
+help with this.
@PkgIndex{listings}
@PkgIndex{minted}
@@ -8033,7 +8038,7 @@
A package that provides many more options for verbatim environments is
@code{fancyvrb}. Another is @code{verbatimbox}.
-For a list of all the relevant packages, see CTAN.
+For a list of all the relevant packages, see CTAN (@pxref{CTAN}).
@menu
* \verb:: The macro form of the @code{verbatim} environment.
More information about the latexrefman-commits
mailing list.