diff options
author | Karl Berry <karl@freefriends.org> | 2010-04-07 22:47:28 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2010-04-07 22:47:28 +0000 |
commit | 3f1971c9b7717818766692c9aa497e20e7472f2c (patch) | |
tree | 678de0190b6643b1b21fd9441fa1387bce180726 /Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-verbwithin.html | |
parent | c7c3b090320a234149dbe23315e2a15a2773ac79 (diff) |
FAQ-en 3.19d (7apr10)
git-svn-id: svn://tug.org/texlive/trunk@17742 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-verbwithin.html')
-rw-r--r-- | Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-verbwithin.html | 56 |
1 files changed, 28 insertions, 28 deletions
diff --git a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-verbwithin.html b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-verbwithin.html index 7aa28e7c370..ac17065aa66 100644 --- a/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-verbwithin.html +++ b/Master/texmf-dist/doc/generic/FAQ-en/html/FAQ-verbwithin.html @@ -1,21 +1,21 @@ <head> <title>UK TeX FAQ -- question label verbwithin</title> </head><body> -<h3>Why doesn’t verbatim work within …?</h3> +<h3>Why doesn’t verbatim work within …?</h3> <p/>The LaTeX verbatim commands work by changing category codes. Knuth -says of this sort of thing “Some care is needed to get the timing -right…”, since once the category code has been assigned to a -character, it doesn’t change. So <code>\</code><code>verb</code> and +says of this sort of thing “Some care is needed to get the timing +right…”, since once the category code has been assigned to a +character, it doesn’t change. So <code>\</code><code>verb</code> and <code>\</code><code>begin{verbatim}</code> have to assume that they are getting the -first look at the parameter text; if they aren’t, TeX has already -assigned category codes so that the verbatim command doesn’t have a +first look at the parameter text; if they aren’t, TeX has already +assigned category codes so that the verbatim command doesn’t have a chance. For example: <blockquote> <pre> \verb+\error+ </pre> </blockquote><p> -will work (typesetting ‘<code>\</code><code>error</code>’), but +will work (typesetting ‘<code>\</code><code>error</code>’), but <blockquote> <pre> \newcommand{\unbrace}[1]{#1} @@ -23,9 +23,9 @@ will work (typesetting ‘<code>\</code><code>error</code>’), but </pre> </blockquote><p> will not (it will attempt to execute <code>\</code><code>error</code>). Other errors one -may encounter are ‘<code>\</code><code>verb</code> ended by end of line’, or even the -rather more helpful ‘<code>\</code><code>verb</code> illegal in command argument’. The -same sorts of thing happen with <code>\</code><code>begin{verbatim}</code> … +may encounter are ‘<code>\</code><code>verb</code> ended by end of line’, or even the +rather more helpful ‘<code>\</code><code>verb</code> illegal in command argument’. The +same sorts of thing happen with <code>\</code><code>begin{verbatim}</code> … <code>\</code><code>end{verbatim}</code>: <blockquote> <pre> @@ -40,28 +40,28 @@ barfoo } </pre> </blockquote><p> -provokes errors like ‘File ended while scanning use of -<code>\</code><code>@xverbatim</code>’, as <code>\</code><code>begin{verbatim}</code> fails to see its +provokes errors like ‘File ended while scanning use of +<code>\</code><code>@xverbatim</code>’, as <code>\</code><code>begin{verbatim}</code> fails to see its matching <code>\</code><code>end{verbatim}</code>. <p/>This is why the LaTeX book insists that verbatim commands must not appear in the argument of any other command; they -aren’t just fragile, they’re quite unusable in any command parameter, +aren’t just fragile, they’re quite unusable in any command parameter, regardless of <a href="FAQ-protect.html"><code>\</code><code>protect</code>ion</a>. (The <code>\</code><code>verb</code> -command tries hard to detect if you’re misusing it; unfortunately, it -can’t always do so, and the error message is therefore not a reliable +command tries hard to detect if you’re misusing it; unfortunately, it +can’t always do so, and the error message is therefore not a reliable indication of problems.) -<p/>The first question to ask yourself is: “is <code>\</code><code>verb</code> actually -necessary?”. +<p/>The first question to ask yourself is: “is <code>\</code><code>verb</code> actually +necessary?”. <ul> <li> If <code>\</code><code>texttt{<em>your text</em>}</code> produces the same result - as <code>\</code><code>verb</code><code>+<em>your text</em>+</code>, then there’s no need of + as <code>\</code><code>verb</code><code>+<em>your text</em>+</code>, then there’s no need of <code>\</code><code>verb</code> in the first place. -<li> If you’re using <code>\</code><code>verb</code> to typeset a URL or email +<li> If you’re using <code>\</code><code>verb</code> to typeset a URL or email address or the like, then the <code>\</code><code>url</code> command from the - <i>url</i> will help: it doesn’t suffer from all the problems of - <code>\</code><code>verb</code>, though it’s still not robust; - “<a href="FAQ-setURL.html">typesetting URLs</a>” offers advice here. -<li> If you’re putting <code>\</code><code>verb</code> into the argument of a boxing + <i>url</i> will help: it doesn’t suffer from all the problems of + <code>\</code><code>verb</code>, though it’s still not robust; + “<a href="FAQ-setURL.html">typesetting URLs</a>” offers advice here. +<li> If you’re putting <code>\</code><code>verb</code> into the argument of a boxing command (such as <code>\</code><code>fbox</code>), consider using the <code>lrbox</code> environment: <blockquote> @@ -101,7 +101,7 @@ necessary?”. <code>\</code><code>string</code>. <code>\</code><code>texttt{my<code>\</code><code>string</code>_name}</code> typesets the same as <code>\verb+my_name+</code>, and will work in the argument of a command. It - won’t, however, work in a moving argument, and no amount of + won’t, however, work in a moving argument, and no amount of <a href="FAQ-protect.html"><code>\</code><code>protect</code>ion</a> will make it work in such a case. <p/> A robust alternative is: @@ -112,9 +112,9 @@ necessary?”. \section{... \texttt{my\us name}} </pre> </blockquote><p> - Such a definition is ‘naturally’ robust; the construction - “<<i>back-tick</i>><code>\</code><code><<i>char</code></i>>” may be used for any - troublesome character (though it’s plainly not necessary for things + Such a definition is ‘naturally’ robust; the construction + “<<i>back-tick</i>><code>\</code><code><<i>char</code></i>>” may be used for any + troublesome character (though it’s plainly not necessary for things like percent signs for which (La)TeX already provides robust macros). </ul> @@ -124,7 +124,7 @@ package files. <dt><tt><i>fancyvrb.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/fancyvrb.zip">macros/latex/contrib/fancyvrb</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/fancyvrb/">browse the directory</a>) <dt><tt><i>memoir.cls</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/memoir.zip">macros/latex/contrib/memoir</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/memoir/">browse the directory</a>) <dt><tt><i>url.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/url.zip">macros/latex/contrib/url</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/url/">browse the directory</a>) -<dt><tt><i>verbdef.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/misc/verbdef.sty">macros/latex/contrib/misc/verbdef.sty</a> +<dt><tt><i>verbdef.sty</i></tt><dd><a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/verbdef.zip">macros/latex/contrib/verbdef</a> (or <a href="http://www.tex.ac.uk/tex-archive/macros/latex/contrib/verbdef/">browse the directory</a>) </dl> <p/><p>This question on the Web: <a href="http://www.tex.ac.uk/cgi-bin/texfaq2html?label=verbwithin">http://www.tex.ac.uk/cgi-bin/texfaq2html?label=verbwithin</a> </body> |