[latexrefman-commits] [SCM] latexrefman updated: r887 - trunk
vincentb1 at gnu.org.ua
vincentb1 at gnu.org.ua
Thu Dec 24 23:17:24 CET 2020
Author: vincentb1
Date: 2020-12-25 00:17:24 +0200 (Fri, 25 Dec 2020)
New Revision: 887
Modified:
trunk/ChangeLog
trunk/latex2e-fr.texi
trunk/latex2e.texi
Log:
[fr,en] \mbox & \makebox, \sbox & \savebox.
* latex2e-fr.texi (\mbox & \makebox, \sbox & \savebox): Align on English.
* latex2e.texi (\mbox & \makebox): Replace example with table
reference by soviet tank T-34, reference should be made with \ref
& \label. Fix redundant ``space after points'' text. Avoid
negative sentences describing what \\ or \par do, and remind this
is LR mode.
(\sbox & \savebox): ``storage bin'' -> ``box register''
Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog 2020-12-24 17:59:50 UTC (rev 886)
+++ trunk/ChangeLog 2020-12-24 22:17:24 UTC (rev 887)
@@ -1,5 +1,16 @@
2020-12-24 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+ * latex2e-fr.texi (\mbox & \makebox, \sbox & \savebox): Align on English.
+
+ * latex2e.texi (\mbox & \makebox): Replace example with table
+ reference by soviet tank T-34, reference should be made with \ref
+ & \label. Fix redundant ``space after points'' text. Avoid
+ negative sentences describing what \\ or \par do, and remind this
+ is LR mode.
+ (\sbox & \savebox): ``storage bin'' -> ``box register''
+
+2020-12-24 Vincent Bela\"iche <vincentb1 at users.sourceforge.net>
+
* latex2e.texi (Using BibTeX): Forward reference to CTAN node.
* latex2e-fr.texi (Using BibTeX): Align on English.
Modified: trunk/latex2e-fr.texi
===================================================================
--- trunk/latex2e-fr.texi 2020-12-24 17:59:50 UTC (rev 886)
+++ trunk/latex2e-fr.texi 2020-12-24 22:17:24 UTC (rev 887)
@@ -6211,7 +6211,7 @@
@end table
- at xref{\makebox}.
+ at xref{\mbox & \makebox}.
@node \framebox (picture)
@@ -9024,7 +9024,7 @@
Ce dernier exemple montre comment sauvegarder la valeur d'un argument
pour l'utiliser dans @var{déffin}, dans ce cas dans une boîte
-(@pxref{\sbox}).
+(@pxref{\sbox & \savebox}).
@example
\newsavebox@{\quoteauthor@}
@@ -12043,95 +12043,89 @@
de boîtes.
@menu
-* \mbox & \makebox:: Boîtes horizontales.
-* \fbox and \framebox:: Mettre un cadre autour d'une boîte.
-* lrbox:: Un environnement similaire à @code{\sbox}.
-* \makebox:: Boîte, adjustable position.
+* \mbox & \makebox:: Boîtes horizontales.
+* \fbox & \framebox:: Mettre un cadre autour d'une boîte.
* \parbox:: Boîte avec du texte en mode paragraphe.
* \raisebox:: Élève ou abaisse le texte.
-* \savebox:: Comme @code{\makebox}, mais sauvegarde le texte pour usage ultérieur.
-* \sbox:: Comme @code{\mbox}, mais sauvegarde le texte pour usage ultérieur.
+* \sbox & \savebox:: Comme @code{\makebox}, mais sauvegarde le texte pour usage ultérieur.
+* lrbox:: Un environnement similaire à @code{\sbox}.
* \usebox:: Compose le texte sauvegardé.
@end menu
@node \mbox & \makebox
- at section @code{\mbox@{@var{texte@}}}
+ at section @code{\mbox} & @code{\makebox}
+
@findex \mbox
-
+ at findex \makebox
+ at cindex boîte
+ at cindex fabriquer une boîte
@cindex césure, empécher
@cindex coupure de mot, empécher
-La commande @code{\mbox} crée un boîte qui a la largeur juste du texte
-créé par son argument. Le @var{texte} n'est pas coupé en plusieurs
-lignes, c'est pourquoi cette commande peut être utilisée pour empécher
-la césure.
+Synopsis, l'un parmi les suivants :
- at node \fbox and \framebox
- at section @code{\fbox} and @code{\framebox}
+ at example
+\mbox@{@var{texte}@}
+\makebox@{@var{texte}@}
+\makebox[@var{largeur}]@{@var{texte}@}
+\makebox[@var{largeur}][@var{position}]@{@var{texte}@}
+ at end example
- at findex \fbox
- at findex \framebox
+La commande @code{\mbox} crée un boîte, un conteneur pour du
+matériel. Le @var{texte} est composé en mode LR (@pxref{Modes}) ainsi il
+n'est pas coupé en plusieurs lignes. La commande @code{\mbox} est
+robuste, alors que @code{\makebox} est fragile (@pxref{\protect}).
-Synopsis :
+Comme @code{texte} n'est pas coupé en plusieurs ligne, on peut utiliser
+ at code{\mbox} pour empécher une césure. Dans l'exemple suivant, @LaTeX{}
+ne peut pas faire de césure dans le nom du char,
+ at samp{T-34}.
@example
-\fbox@{@var{texte}@}
-\framebox[@var{largeur}][@var{position}]@{@var{texte}@}
+Le char soviétique \mbox@{T-34@} est l'un des symboles de la victoire
+sur le nazisme.
@end example
-Les commandes @code{\fbox} et @code{\framebox} sont similaires à
- at code{\mbox}, à ceci près qu'elle mettent un cadre autour de l'extérieur
-de la boîte ainsi créée.
+Dans les deux première version du synopsys, @code{\mbox} et
+ at code{\makebox} sont sensiblement équivalente. Elles créent une boîte
+juste assez large pour contenir le @var{texte}. (Elle sont comme le
+ at code{\hbox} du @value{PlainTeX}).
-De plus, la commande @code{\framebox} permet de spécifier explicitement
-la largeur de la boîte avec l'argument optionnel @var{largeur}
-(une longueur), et sa position sur la ligne avec l'argument optionnel @var{position}. @c xxref
+Dans la troisième version l'argument optionnel @var{largeur} spécifie la
+largeur de la boîte. Notez que l'espace occupé par le texte n'est pas
+nécessairement équivalent à la largeur de la boîte. D'une part,
+ at var{texte} peut être trop petit ; l'exemple suivant crée une boîte
+d'une ligne entière de largeur :
- at findex \fboxrule
- at findex \fboxsep
-Les deux commandes produisent un filet d'épaisseur @code{\fboxrule}
-(valant par défaut @samp{.4pt}), et laisse un espace de @code{\fboxsep}
-(valant par défaut @samp{3pt}) entre le filet et le contenu de la boîte.
-
- at xref{\framebox (picture)}, pour la commande @code{\framebox} dans
-l'environnement @code{picture}.
-
-
- at node lrbox
- at section @code{lrbox}
- at findex lrbox
-
-Synopsis :
-
@example
-\begin@{lrbox@}@{\@var{cmd}@}
- @var{texte }
-\end@{lrbox@}
+\makebox[\linewidth]@{Examen du chapitre@}
@end example
-Ceci est la forme environnement de la commande @ref{\sbox, at code{\sbox}}.
+ at noindent
+où @samp{Examen du chapitre} est centré. Mais @var{texte} peut aussi
+être trop large pour @var{largeur}. Voir l'exemple plus bas pour des
+boîtes de largeur nulle.
-Le @var{texte} au sein de l'environnement est sauvegarder dans une boîte
- at code{\@var{cmd}} qui doit avoir préalablement été déclarée avec
- at code{\newsavebox}.
+ at anchor{mbox makebox depth}
+ at anchor{mbox makebox height}
+ at anchor{mbox makebox width}
+ at anchor{mbox makebox totalheight}
+Au sein de l'argument @var{largeur} vous pouvez utiliser les longueur
+suivante qui font référence aux dimensions de la boîte que @LaTeX{}
+obtient en composant @var{texte} : @code{\depth}, @code{\height},
+ at code{\width}, @code{\totalheight} (la somme de la hauteur et de la
+profondeur de la boîte). Par exemple, pour fabriquer une boîte où le
+texte est dilaté au double de sa largeur naturelle vous pouvez écrire
+ceci :
-
- at node \makebox
- at section @code{\makebox}
- at findex \makebox
-
-Synopsis :
-
@example
-\makebox[@var{largeur}][@var{position}]@{@var{texte}@}
+\makebox[2\width]@{Get a stretcher@}
@end example
-La commande @code{\makebox} crée une boîte juste assez large pour
-contenir le @var{texte} spécifié. La largeur de la boîte peut-être
-emportée par l'argument optionnel @var{largeur}. La position du
-texte au sein de la boîte est determinée par l'argument optionnel
- at var{position} qui peut prendre l'une des valeurs suivantes :
+Pour la quatrième version du synopsis, la position du texte au sein de
+la boîte est determinée par l'argument optionnel @var{position} qui peut
+prendre l'une des valeurs suivantes :
@table @code
@item c
@@ -12142,13 +12136,77 @@
(Right) justifié à droite.
@item s
(Stretch) justifié à travers la @var{largeur} entière ; @var{texte} doit
-contenir de l'espace dilatable pour que cela marche.
+contenir de l'espace dilatable pour que cela marche. Par exemple, ceci
+pourrait être le libellé d'un communiqué de presse :
+ at code{\noindent\makebox[\textwidth][s]@{\large\hfil DÉPÊCHE\hfil IMMÉDIATE\hfil@}}
@end table
- at code{\makebox} est aussi utilisé au sein de l'environnement @code{picture},
- at pxref{\makebox (picture)}.
+Une utilisation courante de @code{\makebox} est de fabriquer des boîtes
+de texte de largeur nulle. Dans l'exemple suivant on place dans un
+questionnaire la valeur des questions à leur gauche.
+ at example
+\newcommand@{\pts@}[1]@{\makebox[0em][r]@{#1 points\hspace*@{1em@}@}@}
+\pts@{10@}Quelle est la vitesse aérodynamique d'une hirondelle à vide ?
+\pts@{90@}Une hirondelle africaine ou européenne ?
+ at end example
+
+ at noindent
+ at PkgIndex{TikZ}
+ at PkgIndex{Asymptote}
+Le bord droit de la sortie @samp{10 points } (notez l'espace finale
+après @samp{points}) est juste avant le @samp{Quelle}. Vous pouvez
+utiliser @code{\makebox} de la même manière quand vous faites des
+graphiques, comme en @file{TikZ} ou @file{Asymptote}, où vous mettez le
+bord du texte à une position connue, quelle que soit la longueur de ce
+texte.
+
+Pour des boîtes avec cadre voir @ref{\fbox & \framebox}. Pour des boîtes
+de couleurs voir @ref{Colored boxes}.
+
+Il y a une version apparentée de @code{\makebox} qui utilisée au sein de
+l'environnement @code{picture}, où la longueur est données en termes
+d'@code{\unitlength} (@pxref{\makebox (picture)}).
+
+Comme @var{texte} est composé en mode LR, ni une double contr'oblique
+ at code{\\}, ni @code{\par} ne produisent un saut de ligne ; par exemple
+ at code{\makebox@{abc def \\ ghi@}} produit en sortie @samp{abc defghi}
+alors que @code{\makebox@{abc def \par ghi@}} produit @samp{abc def
+ghi}, tout deux sur une seule ligne. Pour obtenir des lignes multiples
+voir @ref{\parbox} et @ref{minipage}.
+
+ at node \fbox & \framebox
+ at section @code{\fbox} & @code{\framebox}
+
+ at findex \fbox
+ at findex \framebox
+
+Synopsis :
+
+ at example
+\fbox@{@var{texte}@}
+\framebox[@var{largeur}][@var{position}]@{@var{texte}@}
+ at end example
+
+Les commandes @code{\fbox} et @code{\framebox} sont similaires à
+ at code{\mbox}, à ceci près qu'elle mettent un cadre autour de l'extérieur
+de la boîte ainsi créée.
+
+De plus, la commande @code{\framebox} permet de spécifier explicitement
+la largeur de la boîte avec l'argument optionnel @var{largeur}
+(une longueur), et sa position sur la ligne avec l'argument optionnel @var{position}. @c xxref
+
+ at findex \fboxrule
+ at findex \fboxsep
+Les deux commandes produisent un filet d'épaisseur @code{\fboxrule}
+(valant par défaut @samp{.4pt}), et laisse un espace de @code{\fboxsep}
+(valant par défaut @samp{3pt}) entre le filet et le contenu de la boîte.
+
+ at xref{\framebox (picture)}, pour la commande @code{\framebox} dans
+l'environnement @code{picture}.
+
+
@node \parbox
@section @code{\parbox}
@findex \parbox
@@ -12282,39 +12340,127 @@
second est celle de @file{meta.png}.
- at node \savebox
- at section @code{\savebox}
+
+ at node \sbox & \savebox
+ at section @code{\sbox} & @code{\savebox}
+ at findex \sbox
@findex \savebox
+ at cindex boîte, sauvegarde
-Synopsis :
+Synopsis, l'un parmi les suivants :
+
@example
-\savebox@{@var{\boxcmd}@}[@var{largeur}][@var{pos}]@{@var{texte}@}
+\sbox@{@var{cmd-boîte}@}@{@var{texte}@}
+\savebox@{@var{cmd-boîte}@}@{@var{texte}@}
+\savebox@{@var{cmd-boîte}@}[@var{largeur}]@{@var{texte}@}
+\savebox@{@var{cmd-boîte}@}[@var{largeur}][@var{pos}]@{@var{texte}@}
@end example
Cette commande compose @var{texte} dans une boîte de la même façon
-qu'avec @code{\makebox} (@pxref{\makebox}), à ceci près qu'au lieu
-d'imprimer la boîte résultante, elle la sauvegarde dans une boîte
-étiquettée @var{\boxcmd}, ce qui doit avoir été déclaré avec
- at code{\newsavebox} (@pxref{\newsavebox}).
+qu'avec @code{\makebox} (@pxref{\mbox & \makebox}), à ceci près qu'au
+lieu de sortir la boîte résultante, elle la sauvegarde dans un registre
+boîte référencé par la variable nommée @var{cmd-boîte}. Le nom de
+variable @var{cmd-boîte} commence avec une contr'oblique, @code{\}. Vous
+devez préalablement avoir alloué le registre boîte @var{cmd-boîte} avec avec
+ at code{\newsavebox} (@pxref{\newsavebox}). La commande @code{\sbox} est
+robuste, alors que @code{\savebox} est fragile (@pxref{\protect}).
+L'exemple suivant crée et utilise un registre boîte.
- at node \sbox
- at section @code{\sbox@{@var{\boxcmd}@}@{@var{texte}@}}
- at findex \sbox
+ at example
+\newsavebox@{\nomcomplet@}
+\sbox@{\nomcomplet@}@{Cadet Rousselle@}
+ ...
+\usebox@{\nomcomplet@} a trois maisons qui n'ont ni poutres, ni chevrons !
+C'est pour loger les hirondelles,
+Que direz-vous d'\usebox@{\nomcomplet@} ?
+ at end example
+ at noindent
+Un avantage de l'usage répété d'un registre boîte par rapport à une
+variable macro @code{\newcommand} est l'efficacité, c-à-d.@: que
+ at LaTeX{} n'a pas besoin de répeter la composition du contenu. Voir
+l'exemple plus bas.
+
+Les deux invocations de commande
+ at code{\sbox@{@var{cmd-boîte}@}@{@var{texte}@}} et
+ at code{\savebox@{@var{cmd-boîte}@}@{@var{texte}@}} sont sensiblement
+équivalentes. Quant à la troisième et la quatrième, les arguments
+optionnels vous permettent de spécifier la largeur de la boîte comme
+ at var{largeur}, et la position du texte au sein de cette boîte comme
+ at var{position}. @xref{\mbox & \makebox}, pour une description complète.
+
+Dans les commandes @code{\sbox} et @code{\savebox} le @var{texte} est
+composé en mode LR, aussi il n'a pas de sauts de lignes (@pxref{Modes}).
+Si vous utilisez ce qui suit alors @LaTeX{} ne produit pas d'erreur mais
+ignore ce que vous voulez faire : si vous entrez
+ at code{\sbox@{\nouvreg@}@{test \\ test@}} et @code{\usebox@{\nouvreg@}}
+alors vous obtenez @samp{testtest}, et si vous entrez
+ at code{\sbox@{\nouvreg@}@{test \par test@}} et @code{\usebox@{\nouvreg@}}
+alors vous obtenez @samp{test test}, mais ni erreur ni avertissement.
+La solution est d'utiliser une @code{\parbox} ou une @code{minipage}
+comme dans l'exemple qui suit :
+
+ at c credit: egreg https://tex.stackexchange.com/a/41668/121234
+ at example
+\savebox@{\unreg@}@{%
+ \begin@{minipage@}@{\linewidth@}
+ \begin@{enumerate@}
+ \item Premier article
+ \item Second article
+ \end@{enumerate@}
+ \end@{minipage@}@}
+ ...
+\usebox@{\unreg@}
+ at end example
+
+En exemple de l'efficacité de réutiliser le contenu d'un registre boîte,
+ce qui suit place la même image sur chaque page du document en le
+plaçant dans l'en-tête. @LaTeX{} ne la compose qu'une fois.
+
+ at example
+\usepackage@{graphicx@} % tout cela dans le préambule
+\newsavebox@{\cachetreg@}
+\savebox@{\cachetreg@}@{%
+ \setlength@{\unitlength@}@{2.5cm@}%
+ \begin@{picture@}(0,0)%
+ \put(1.5,-2.5)@{%
+ \begin@{tabular@}@{c@}
+ \includegraphics[height=5cm]@{companylogo.png@} \\
+ Bureau du Président
+ \end@{tabular@}@}
+ \end@{picture@}%
+@}
+\markright@{\usebox@{\cachetreg@}@}
+\pagestyle@{headings@}
+ at end example
+
+ at noindent
+L'environnment @code{picture} est bien adapté pour régler finement le
+placement.
+
+Si le registre @code{\noreg} n'a pas déjà été défini alors vous obtenez
+quelque-chose du genre de @samp{Undefined control sequence. <argument>
+\noreg}.
+
+ at node lrbox
+ at section @code{lrbox}
+ at findex lrbox
+
Synopsis :
@example
-\sbox@{@var{\boxcmd}@}@{@var{texte}@}
+\begin@{lrbox@}@{\@var{cmd}@}
+ @var{texte }
+\end@{lrbox@}
@end example
- at code{\sbox} tape @var{texte} au sein d'une boîte tout comme @code{\mbox}
-(@pxref{\mbox & \makebox}) à ceci près qu'au lieu que la boîte résultante soit
-incluse dans la sortie normale, elle est sauvegardée dans la boîte
-étiquetée @var{\boxcmd}. @var{\boxcmd} doit avoir été préalablement
-déclarée avec @code{\newsavebox} (@pxref{\newsavebox}).
+Ceci est la forme par environnement de la commande @ref{\sbox & \savebox,\sbox}.
+Le @var{texte} au sein de l'environnement est sauvegarder dans une boîte
+ at code{\@var{cmd}} qui doit avoir préalablement été déclarée avec
+ at code{\newsavebox}.
@node \usebox
@section @code{\usebox@{@var{\boxcmd}@}}
@@ -12327,7 +12473,7 @@
@end example
@code{\usebox} produit la boîte la plus récemment sauvegardée dans le
-bac @var{\boxcmd} par une commande @code{\savebox} (@pxref{\savebox}).
+bac @var{\boxcmd} par une commande @code{\savebox} (@pxref{\sbox & \savebox}).
@node Color
@chapter Couleur
@@ -12654,7 +12800,7 @@
@end example
La commande @code{\fcolorbox} utilise les mêmes paramètres que
- at code{\fbox} (@pxref{\fbox and \framebox}), à savoir @code{\fboxrule} et
+ at code{\fbox} (@pxref{\fbox & \framebox}), à savoir @code{\fboxrule} et
@code{\fboxsep}, pour régler l'épaisseur du filet et de la séparation
entre l'intérieur de la boîte et le filet l'entourant. Les valeurs par
défaut de @LaTeX{} sont @code{0.4pt} et @code{3pt} respectivement.
Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi 2020-12-24 17:59:50 UTC (rev 886)
+++ trunk/latex2e.texi 2020-12-24 22:17:24 UTC (rev 887)
@@ -15370,13 +15370,13 @@
Because @code{text} is not broken into lines, you can use @code{\mbox}
to prevent hyphenation. In this example, @LaTeX{} will not hyphenate
-the table name, @samp{T-4}.
+the tank name, @samp{T-34}.
@example
-See Table~\mbox@{T-4@}
+The soviet tank \mbox@{T-34@} is a symbol of victory against nazism.
@end example
-The first two command versions, @code{\mbox} and @code{\makebox}, are
+The first two command synopsis versions, @code{\mbox} and @code{\makebox}, are
roughly equivalent. They create a box just wide enough to contain the
@var{text}. (They are like plain @TeX{}'s @code{\hbox}.)
@@ -15408,7 +15408,7 @@
\makebox[2\width]@{Get a stretcher@}
@end example
-For the fourth command version the optional argument @var{position}
+For the fourth command synopsis version the optional argument @var{position}
gives position of the text within the box. It may take the following
values:
@@ -15443,12 +15443,11 @@
@noindent
@PkgIndex{TikZ}
@PkgIndex{Asymptote}
-The right edge of the output @samp{10 points } (note the ending space)
-will be just before the @samp{What} (note the space after
- at samp{points}). You can use @code{\makebox} similarly when making
-graphics, such as in @file{TikZ} or @file{Asymptote}, where you put the
-edge of the text at a known location, regardless of the length of that
-text.
+The right edge of the output @samp{10 points } (note the ending space
+after @samp{points}) will be just before the @samp{What}. You can use
+ at code{\makebox} similarly when making graphics, such as in @file{TikZ}
+or @file{Asymptote}, where you put the edge of the text at a known
+location, regardless of the length of that text.
For boxes with frames see at tie{}@ref{\fbox & \framebox}. For colors
see at tie{}@ref{Colored boxes}.
@@ -15457,11 +15456,12 @@
@code{picture} environment, where the length is given in terms of
@code{\unitlength} (@pxref{\makebox (picture)}).
-If you put a double-backslash into @var{text} then @LaTeX{} will not
-give you a new line; for instance @code{\makebox@{abc def \\ ghi@}}
-outputs @samp{abc defghi} while @code{\makebox@{abc def \par ghi@}}
-outputs @samp{abc def ghi}, but neither go to a second line. To get
-multiple lines see at tie{}@ref{\parbox} and at tie{}@ref{minipage}.
+As @var{text} is typeset in LR mode, neither a double backslash
+ at code{\\} nor @code{\par} will give you a new line; for instance
+ at code{\makebox@{abc def \\ ghi@}} outputs @samp{abc defghi} while
+ at code{\makebox@{abc def \par ghi@}} outputs @samp{abc def ghi}, both on
+a single line. To get multiple lines see at tie{}@ref{\parbox}
+and at tie{}@ref{minipage}.
@node \fbox & \framebox
@@ -15704,13 +15704,13 @@
Typeset @var{text} just as with @code{\makebox} (@pxref{\mbox &
\makebox}) except that @LaTeX{} does not output it but instead saves it
-in a storage bin named @var{box-cmd}. The bin name @var{box-cmd} begins
-with a backslash, @code{\}. You must have previously allocated the bin
- at var{box-cmd} with @code{\newsavebox} (@pxref{\newsavebox}).The
- at code{\sbox} command is robust while @code{\savebox} is fragile
-(@pxref{\protect}).
+in a box register referred to by a variable named @var{box-cmd}. The
+variable name @var{box-cmd} begins with a backslash, @code{\}. You must
+have previously allocated the box register @var{box-cmd} with @code{\newsavebox}
+(@pxref{\newsavebox}). The @code{\sbox} command is robust while
+ at code{\savebox} is fragile (@pxref{\protect}).
-This creates and uses a bin.
+This creates and uses a box register.
@example
\newsavebox@{\fullname@}
@@ -15718,13 +15718,13 @@
...
\usebox@{\fullname@}! His name is my name, too!
Whenever we go out, the people always shout!
-There goes \\usebox@{\fullname@}! Ya da da da da da da.
+There goes \usebox@{\fullname@}! Ya da da da da da da.
@end example
@noindent
-One advantage of using and reusing a bin over a @code{\newcommand} is
-efficiency, that @LaTeX{} need not repeatedly retypeset the contents.
-See the example below.
+One advantage of using and reusing a box register over a
+ at code{\newcommand} macro variable is efficiency, that @LaTeX{} need not
+repeatedly retypeset the contents. See the example below.
The first two command invocations,
@code{\sbox@{@var{box-cmd}@}@{@var{text}@}} and
@@ -15737,15 +15737,15 @@
In the @code{\sbox} and @code{\savebox} commands the @var{text} is
typeset in LR mode so it does not have line breaks (@pxref{Modes}). If
you use these then @LaTeX{} doesn't give you an error but it ignores
-what you want: if you enter @code{\sbox@{\newbin@}@{test \\ test@}} and
- at code{\usebox@{\newbin@}} then you get @samp{testtest}, while if you
-enter @code{\sbox@{\newbin@}@{test \par test@}} and
- at code{\usebox@{\newbin@}} then you get @samp{test test}, but no error or
+what you want: if you enter @code{\sbox@{\newreg@}@{test \\ test@}} and
+ at code{\usebox@{\newreg@}} then you get @samp{testtest}, while if you
+enter @code{\sbox@{\newreg@}@{test \par test@}} and
+ at code{\usebox@{\newreg@}} then you get @samp{test test}, but no error or
warning. To fix this use a @code{\parbox} or @code{minipage} as here.
@c credit: egreg https://tex.stackexchange.com/a/41668/121234
@example
-\savebox@{\abin@}@{%
+\savebox@{\areg@}@{%
\begin@{minipage@}@{\linewidth@}
\begin@{enumerate@}
\item First item
@@ -15753,17 +15753,17 @@
\end@{enumerate@}
\end@{minipage@}@}
...
-\usebox@{\abin@}
+\usebox@{\areg@}
@end example
-As an example of the efficiency of reusing a bin's contents, this puts
+As an example of the efficiency of reusing a register's contents, this puts
the same picture on each page of the document by putting it in the
header. @LaTeX{} only typesets it once.
@example
\usepackage@{graphicx@} % all this in the preamble
-\newsavebox@{\sealbin@}
-\savebox@{\sealbin@}@{%
+\newsavebox@{\sealreg@}
+\savebox@{\sealreg@}@{%
\setlength@{\unitlength@}@{1in@}%
\begin@{picture@}(0,0)%
\put(1.5,-2.5)@{%
@@ -15773,15 +15773,15 @@
\end@{tabular@}@}
\end@{picture@}%
@}
-\markright@{\usebox@{\sealbin@}@}
+\markright@{\usebox@{\sealreg@}@}
\pagestyle@{headings@}
@end example
@noindent
The @code{picture} environment is good for fine-tuning the placement.
-If the bin has not already been defined then you get something like
- at samp{Undefined control sequence. <argument> \nobin}.
+If the register @code{\noreg} has not already been defined then you get something like
+ at samp{Undefined control sequence. <argument> \noreg}.
@node lrbox
More information about the latexrefman-commits
mailing list.