diff options
author | Norbert Preining <norbert@preining.info> | 2021-05-26 03:05:34 +0000 |
---|---|---|
committer | Norbert Preining <norbert@preining.info> | 2021-05-26 03:05:34 +0000 |
commit | 8982c52e00ffb3fb5a913fc60913ebd9070f091a (patch) | |
tree | 6a395986e3502fefcf42364f8dd87519b45a2441 /macros/latex/contrib/l3kernel/l3box.dtx | |
parent | 07dc96bc3bbd691fc52aca15a172eaf41a89d873 (diff) |
CTAN sync 202105260305
Diffstat (limited to 'macros/latex/contrib/l3kernel/l3box.dtx')
-rw-r--r-- | macros/latex/contrib/l3kernel/l3box.dtx | 24 |
1 files changed, 23 insertions, 1 deletions
diff --git a/macros/latex/contrib/l3kernel/l3box.dtx b/macros/latex/contrib/l3kernel/l3box.dtx index 1eb6848d85..f9cef57a96 100644 --- a/macros/latex/contrib/l3kernel/l3box.dtx +++ b/macros/latex/contrib/l3kernel/l3box.dtx @@ -43,15 +43,37 @@ % }^^A % } % -% \date{Released 2021-05-11} +% \date{Released 2021-05-25} % % \maketitle % % \begin{documentation} % +% Box variables contain typeset material that can be inserted on the +% page or in other boxes. Their contents cannot be converted back to +% lists of tokens. % There are three kinds of box operations: horizontal mode denoted % with prefix |\hbox_|, vertical mode with prefix |\vbox_|, and the % generic operations working in both modes with prefix |\box_|. +% For instance, a new box variable containing the words \enquote{Hello, +% world!} (in a horizontal box) can be obtained by the following code. +% \begin{verbatim} +% \box_new:N \l_hello_box +% \hbox_set:Nn \l_hello_box { Hello, ~ world! } +% \end{verbatim} +% The argument is typeset inside a \TeX{} group so that any variables +% assigned during the construction of this box restores its value +% afterwards. +% +% Box variables from \pkg{l3box} are compatible with those of \LaTeXe{} +% and plain \TeX{} and can be used interchangeably. The \pkg{l3box} +% commands to construct boxes, such as \cs{hbox:n} or \cs{hbox_set:Nn}, +% are \enquote{color-safe}, meaning that +% \begin{verbatim} +% \hbox:n { \color_select:n { blue } Hello, } ~ world! +% \end{verbatim} +% will result in \enquote{Hello,} taking the color blue, but +% \enquote{world!} remaining with the prevailing color outside the box. % % \section{Creating and initialising boxes} % |