[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.