From 3731208d7fb52ead680b0a31cae7e086b536a97b Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 6 Mar 2014 22:10:33 +0000 Subject: numberedblock (6mar14) git-svn-id: svn://tug.org/texlive/trunk@33109 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/numberedblock/testnumberedblock.pdf | Bin 35138 -> 75098 bytes .../doc/latex/numberedblock/testnumberedblock.tex | 24 +++++++++++---------- 2 files changed, 13 insertions(+), 11 deletions(-) (limited to 'Master/texmf-dist/doc/latex/numberedblock') diff --git a/Master/texmf-dist/doc/latex/numberedblock/testnumberedblock.pdf b/Master/texmf-dist/doc/latex/numberedblock/testnumberedblock.pdf index cdfd2713b3f..2a4066df62f 100644 Binary files a/Master/texmf-dist/doc/latex/numberedblock/testnumberedblock.pdf and b/Master/texmf-dist/doc/latex/numberedblock/testnumberedblock.pdf differ diff --git a/Master/texmf-dist/doc/latex/numberedblock/testnumberedblock.tex b/Master/texmf-dist/doc/latex/numberedblock/testnumberedblock.tex index b12dc3c6725..0e66a6a2628 100644 --- a/Master/texmf-dist/doc/latex/numberedblock/testnumberedblock.tex +++ b/Master/texmf-dist/doc/latex/numberedblock/testnumberedblock.tex @@ -1,11 +1,11 @@ \documentclass[10pt]{article} \usepackage{numberedblock} - +\textheight 7.7in \begin{document} - -\parindent 0.3in +%DEFAULTS: %\setlength\maxblocklabelsize{-.4in} -\setlength\blockindent{0.0in} +%\setlength\blockindent{0.2in} +%\renewcommand\blocklabel[1]{[\textit{\arabic{#1}}]} This is a test of the \textsf{numberedblock} style packcage, which is specially designed to produce sequentially numbered BLOCKS of code (note @@ -15,20 +15,21 @@ can get numbered in a document). While specialized for numbering code blocks, the commands can actually number other items, as well, in fact anything that fits in a \LaTeX{} box. -If the code block contains no special characters, one can simply use the +If the code block contains no special characters +(or is already a box), one can simply use the command form, called \verb,\numblock,. It cannot handle verbatim text, but must use standard \LaTeX{} escape sequences (for line breaks, contiguous spaces, special characters, etc.). It puts the output in a -tt font , which is the same used in the verbatim environment: +tt font, which is the same as used in the verbatim environment: \numblock{This text is the\\argument to the command\\where double -slashes have been\\used for line breaks} +slashes have been\\used for line breaks\nblabel{nb:A}} Most useful, however, there is also the \verb,numVblock, environment, which handles verbatim text, as seen in the next example: -\begin{numVblock} -This is the numVblock +\begin{numVblock}[\nbVlabel{nb:B}] +This is a labeled numVblock environment, which (<--see contiguous spaces here) succeeds in incorporating verbatim text like @@ -36,7 +37,9 @@ incorporating verbatim text like \end{numVblock} As envisioned the \verb,numVblock, environment would be ideally suited -for displaying small code blocks as part of documentation. The code can +for displaying small code blocks as part of documentation, and I can +{\bfseries (NEW!!)} even reference +the numbered blocks~\ref{nb:A} and \ref{nb:B}. The code can contain contiguous spaces and special characters: \begin{numVblock} @@ -60,5 +63,4 @@ box, rather than as formatted text. Don't forget, there are settable parameters to define the block left-indent, the format of the label, and (if needed) the labels' max width/placement. - \end{document} -- cgit v1.2.3