[latexrefman-commits] [SCM] latexrefman updated: r628 - trunk

jimhefferon at gnu.org.ua jimhefferon at gnu.org.ua
Thu May 24 17:23:34 CEST 2018


Author: jimhefferon
Date: 2018-05-24 18:23:34 +0300 (Thu, 24 May 2018)
New Revision: 628

Modified:
   trunk/ChangeLog
   trunk/latex2e.html
   trunk/latex2e.info
   trunk/latex2e.pdf
   trunk/latex2e.texi
Log:
verbatim, verse

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2018-05-23 13:12:13 UTC (rev 627)
+++ trunk/ChangeLog	2018-05-24 15:23:34 UTC (rev 628)
@@ -1,3 +1,9 @@
+2018-05-24  Jim Hefferon  <jhefferon at smcvt.edu>
+
+	* latex2e.texi (verbatim)  Expand on problems putting
+	it in argument of macros, add examples.
+	(verse)  Adjust wording.
+
 2018-05-23  Jim Hefferon  <jhefferon at smcvt.edu>
 
 	* latex2e.texi Continue going through latex-info.  Through that

Modified: trunk/latex2e.html
===================================================================
--- trunk/latex2e.html	2018-05-23 13:12:13 UTC (rev 627)
+++ trunk/latex2e.html	2018-05-24 15:23:34 UTC (rev 628)
@@ -6549,7 +6549,6 @@
 <a name="index-package_002c-fancyvrb"></a>
 <a name="index-fancyvrb-package"></a>
 
-
 <p>(The above example is just for illustration of the environment.  To
 actually typeset computer code in typewriter like this, a verbatim
 environment (see <a href="#verbatim">verbatim</a>) would normally suffice.  For
@@ -7440,20 +7439,59 @@
 \end{verbatim}
 </pre></div>
 
-<p>A paragraph-making environment in which LaTeX produces exactly what
-you type in; for instance the <code>\</code> character produces a printed
-‘<samp>\</samp>’.  Carriage returns and blanks are taken literally.  The output
-appears in a monospaced typewriter-like font (<code>\tt</code>).
+<p>A paragraph-making environment in which LaTeX produces as output
+exactly what you type as input.  For instance inside <var>literal-text</var>
+the backslash <code>\</code> character does not start commands, it
+produces a printed ‘<samp>\</samp>’, and carriage returns and blanks are taken
+literally.  The output appears in a monospaced typewriter-like font
+(<code>\tt</code>).
 </p>
-<p>For typesetting computer code there are quite a few packages that are an
-improvement over using the <code>verbatim</code> environment, such as
-<code>listings</code>, and <code>minted</code>.  For a list of them, see CTAN.
+<div class="example">
+<pre class="example">\begin{verbatim}
+Symbol swearing: %&$#?!.
+\end{verbatim}
+</pre></div>
+
+<p>The only restriction on <code>literal-text</code> is that it cannot include
+the string <code>\end{verbatim}</code>.
 </p>
+<a name="index-package_002c-cprotect"></a>
+<a name="index-cprotect-package"></a>
+
+<p>You cannot use the verbatim environment in the argument to macros, for
+instance in the argument to a <code>\section</code>.  This is not the same as
+commands being fragile (see <a href="#g_t_005cprotect">\protect</a>), instead it just cannot appear
+there. (But the <code>cprotect</code> package can help with this.)
+</p>
+<a name="index-package_002c-listings-1"></a>
+<a name="index-listings-package-1"></a>
+
+<a name="index-package_002c-minted-1"></a>
+<a name="index-minted-package-1"></a>
+
+<p>One common use of verbatim input is to typeset computer code.  There are
+packages that are an improvement the <code>verbatim</code> environment.  For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files.  Such packages include <code>listings</code>,
+and <code>minted</code>.
+</p>
+<a name="index-package_002c-fancyverb"></a>
+<a name="index-fancyverb-package"></a>
+
+<a name="index-package_002c-verbatimbox"></a>
+<a name="index-verbatimbox-package"></a>
+
+<p>A package that provides many more options for verbatim environments is
+<code>fancyverb</code>.  Another is <code>verbatimbox</code>.
+</p>
+<p>For a list of all the relevant packages, see CTAN.
+</p>
 <table class="menu" border="0" cellspacing="0">
 <tr><td align="left" valign="top">• <a href="#g_t_005cverb" accesskey="1">\verb</a>:</td><td>  </td><td align="left" valign="top">The macro form of the <code>verbatim</code> environment.
 </td></tr>
 </table>
 
+
 <hr>
 <a name="g_t_005cverb"></a>
 <div class="header">
@@ -7469,31 +7507,50 @@
 <p>Synopsis:
 </p>
 <div class="example">
-<pre class="example">\verb<var>char</var><var>literal text</var><var>char</var>
-\verb*<var>char</var><var>literal text</var><var>char</var>
+<pre class="example">\verb <var>char</var> <var>literal-text</var> <var>char</var>
+\verb* <var>char</var> <var>literal-text</var> <var>char</var>
 </pre></div>
 
-<p>Typeset <var>literal text</var> as it is input, including special characters
+<p>Typeset <var>literal-text</var> as it is input, including special characters
 and spaces, using the typewriter (<code>\tt</code>) font.
+<a name="index-visible-space"></a>
+The <code>*</code>-form differs only in that spaces are printed with a visible
+space character.
 </p>
-<p>The first <code>\verb</code> below has the <var>literal text</var> demarcated with
-exclamation point, <code>!</code>.  The second <code>\verb</code> instead uses plus,
-<code>+</code>, as <var>char</var>.
+<p>The single-character delimiter <var>char</var> surrounds <var>literal-text</var>;
+it is the same character before and after.  No spaces come between
+<code>\verb</code> or <code>\verb*</code> and <var>char</var>, or between <var>char</var> and
+<var>literal-text</var>, or between <var>literal-text</var> and the second
+occurrence of <var>char</var>.  The delimiter must not appear in
+<var>literal-text</var>. The <var>literal-text</var> cannot include a line break.
 </p>
+<p>This example shows two different invocations of <code>\verb</code>.
+</p>
 <div class="example">
 <pre class="example">This is \verb!literally! the biggest pumpkin ever.
 And this is the best squash, \verb+literally!+
 </pre></div>
 
-<p>No spaces can come between <code>\verb</code> or <code>\verb*</code> and the
-delimiter <var>char</var>, which begins and ends the verbatim text.  The
-delimiter must not appear in <var>literal-text</var>.
+<p>The first <code>\verb</code> has its <var>literal-text</var> surrounded with
+exclamation point, <code>!</code>.  The second instead uses plus, <code>+</code>,
+because the exclamation point is part of <code>literal-text</code>.
 </p>
-<a name="index-visible-space"></a>
-<p>The <code>*</code>-form differs only in that spaces are printed with a
-“visible space” character.
+<a name="index-package_002c-url"></a>
+<a name="index-url-package"></a>
+
+<p>For typesetting Internet addresses, URL’s, the package <code>url</code>
+provides an option that is better than the <code>\verb</code> command, since
+it allows line breaks.
 </p>
+<a name="index-package_002c-cprotect-1"></a>
+<a name="index-cprotect-package-1"></a>
 
+<p>You cannot use <code>\verb</code> in the argument to a macro, for instance in
+the argument to a <code>\section</code>.  It is not a question of <code>\verb</code>
+being fragile (see <a href="#g_t_005cprotect">\protect</a>), instead it just cannot appear there.
+(But the <code>cprotect</code> package can help with this.)
+</p>
+
 <hr>
 <a name="verse"></a>
 <div class="header">
@@ -7518,16 +7575,30 @@
 \end{verse}
 </pre></div>
 
-<p>The <code>verse</code> environment is designed for poetry, though you may find
-other uses for it.
+<p>An environment for poetry.
 </p>
+<p>Here are two lines from Shakespeare’s Romeo and Juliet.
+</p>
+<div class="example">
+<pre class="example">Then plainly know my heart's dear love is set \\
+On the fair daughter of rich Capulet.
+</pre></div>
+
 <a name="index-_005c_005c-for-verse"></a>
-<p>The margins are indented on the left and the right, paragraphs are not
-indented, and the text is not justified.  Separate the lines of each
-stanza with <code>\\</code>, and use one or more blank lines to separate the
-stanzas.
+<p>Separate the lines of each stanza with <code>\\</code>, and use one or more
+blank lines to separate the stanzas.
 </p>
+<div class="example">
+<pre class="example">A poem is a piece of poetry.
 
+And don't let the head of the poetry society \\
+tell you diff'rent.
+</pre></div>
+
+<p>The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.
+</p>
+
 <hr>
 <a name="Line-breaking"></a>
 <div class="header">
@@ -17353,6 +17424,8 @@
 <tr><td></td><td valign="top"><a href="#index-counters_002c-getting-value-of">counters, getting value of</a>:</td><td> </td><td valign="top"><a href="#g_t_005cvalue">\value</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-counters_002c-printing">counters, printing</a>:</td><td> </td><td valign="top"><a href="#g_t_005calph-_005cAlph-_005carabic-_005croman-_005cRoman-_005cfnsymbol">\alph \Alph \arabic \roman \Roman \fnsymbol</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-counters_002c-setting">counters, setting</a>:</td><td> </td><td valign="top"><a href="#g_t_005csetcounter">\setcounter</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cprotect-package"><code>cprotect</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-cprotect-package-1"><code>cprotect</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-creating-pictures">creating pictures</a>:</td><td> </td><td valign="top"><a href="#picture">picture</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-creating-tables">creating tables</a>:</td><td> </td><td valign="top"><a href="#table">table</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-credit-footnote">credit footnote</a>:</td><td> </td><td valign="top"><a href="#g_t_005cmaketitle">\maketitle</a></td></tr>
@@ -17451,6 +17524,7 @@
 <tr><td colspan="4"> <hr></td></tr>
 <tr><th><a name="Concept-Index_cp_letter-F">F</a></th><td></td><td></td></tr>
 <tr><td></td><td valign="top"><a href="#index-families_002c-of-fonts">families, of fonts</a>:</td><td> </td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-fancyverb-package"><code>fancyverb</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-fancyvrb-package"><code>fancyvrb</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-feminine-ordinal-symbol">feminine ordinal symbol</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-figure-number_002c-cross-referencing">figure number, cross referencing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cref">\ref</a></td></tr>
@@ -17613,6 +17687,7 @@
 <tr><td></td><td valign="top"><a href="#index-list-of-figures-file">list of figures file</a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-list-of-tables-file">list of tables file</a>:</td><td> </td><td valign="top"><a href="#Output-files">Output files</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-listings-package"><code>listings</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-listings-package-1"><code>listings</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-lists-of-items">lists of items</a>:</td><td> </td><td valign="top"><a href="#itemize">itemize</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-lists-of-items_002c-generic">lists of items, generic</a>:</td><td> </td><td valign="top"><a href="#list">list</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-lists-of-items_002c-numbered">lists of items, numbered</a>:</td><td> </td><td valign="top"><a href="#enumerate">enumerate</a></td></tr>
@@ -17655,6 +17730,7 @@
 <tr><td></td><td valign="top"><a href="#index-Millimeter">Millimeter</a>:</td><td> </td><td valign="top"><a href="#Units-of-length">Units of length</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-minipage_002c-creating-a">minipage, creating a</a>:</td><td> </td><td valign="top"><a href="#minipage">minipage</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-minted-package"><code>minted</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-minted-package-1"><code>minted</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-modes">modes</a>:</td><td> </td><td valign="top"><a href="#Modes">Modes</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-monospace-font">monospace font</a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-moving-arguments">moving arguments</a>:</td><td> </td><td valign="top"><a href="#g_t_005cprotect">\protect</a></td></tr>
@@ -17716,9 +17792,12 @@
 <tr><td></td><td valign="top"><a href="#index-package_002c-babel"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </td><td valign="top"><a href="#thebibliography">thebibliography</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-babel-1"><span class="roman">package</span>, <code>babel</code></a>:</td><td> </td><td valign="top"><a href="#Accents">Accents</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-cleveref"><span class="roman">package</span>, <code>cleveref</code></a>:</td><td> </td><td valign="top"><a href="#Cross-references">Cross references</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cprotect"><span class="roman">package</span>, <code>cprotect</code></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-cprotect-1"><span class="roman">package</span>, <code>cprotect</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-datetime"><span class="roman">package</span>, <code>datetime</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005ctoday">\today</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-enumitem"><span class="roman">package</span>, <code>enumitem</code></a>:</td><td> </td><td valign="top"><a href="#list">list</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-etoolbox"><span class="roman">package</span>, <code>etoolbox</code></a>:</td><td> </td><td valign="top"><a href="#Class-and-package-commands">Class and package commands</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-fancyverb"><span class="roman">package</span>, <code>fancyverb</code></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-fancyvrb"><span class="roman">package</span>, <code>fancyvrb</code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-flafter"><span class="roman">package</span>, <code>flafter</code></a>:</td><td> </td><td valign="top"><a href="#Floats">Floats</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-float"><span class="roman">package</span>, <code>float</code></a>:</td><td> </td><td valign="top"><a href="#Floats">Floats</a></td></tr>
@@ -17726,16 +17805,20 @@
 <tr><td></td><td valign="top"><a href="#index-package_002c-geometry"><span class="roman">package</span>, <code>geometry</code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-geometry-1"><span class="roman">package</span>, <code>geometry</code></a>:</td><td> </td><td valign="top"><a href="#Document-class-options">Document class options</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-listings"><span class="roman">package</span>, <code>listings</code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-listings-1"><span class="roman">package</span>, <code>listings</code></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-macros2e"><span class="roman">package</span>, <code>macros2e</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cmakeatletter-and-_005cmakeatother">\makeatletter and \makeatother</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-makeidx"><span class="roman">package</span>, <code>makeidx</code></a>:</td><td> </td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-mfirstuc"><span class="roman">package</span>, <code>mfirstuc</code></a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-minted"><span class="roman">package</span>, <code>minted</code></a>:</td><td> </td><td valign="top"><a href="#tabbing">tabbing</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-minted-1"><span class="roman">package</span>, <code>minted</code></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-multind"><span class="roman">package</span>, <code>multind</code></a>:</td><td> </td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-picture"><span class="roman">package</span>, <code>picture</code></a>:</td><td> </td><td valign="top"><a href="#picture">picture</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-setspace"><span class="roman">package</span>, <code>setspace</code></a>:</td><td> </td><td valign="top"><a href="#Low_002dlevel-font-commands">Low-level font commands</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-showidx"><span class="roman">package</span>, <code>showidx</code></a>:</td><td> </td><td valign="top"><a href="#Indexes">Indexes</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-textcase"><span class="roman">package</span>, <code>textcase</code></a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-textcomp"><span class="roman">package</span>, <code>textcomp</code></a>:</td><td> </td><td valign="top"><a href="#Font-styles">Font styles</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-url"><span class="roman">package</span>, <code>url</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-package_002c-verbatimbox"><span class="roman">package</span>, <code>verbatimbox</code></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-package_002c-xspace"><span class="roman">package</span>, <code>xspace</code></a>:</td><td> </td><td valign="top"><a href="#g_t_005c_0028SPACE_0029-after-control-sequence">\(SPACE) after control sequence</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-packages_002c-loading-additional">packages, loading additional</a>:</td><td> </td><td valign="top"><a href="#Additional-packages">Additional packages</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-page-break_002c-forcing">page break, forcing</a>:</td><td> </td><td valign="top"><a href="#g_t_005cpagebreak-_0026-_005cnopagebreak">\pagebreak & \nopagebreak</a></td></tr>
@@ -17944,6 +18027,7 @@
 <tr><td></td><td valign="top"><a href="#index-unofficial-nature-of-this-manual">unofficial nature of this manual</a>:</td><td> </td><td valign="top"><a href="#About-this-document">About this document</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-unordered-lists">unordered lists</a>:</td><td> </td><td valign="top"><a href="#itemize">itemize</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-Upper-case">Upper case</a>:</td><td> </td><td valign="top"><a href="#Upper-and-lower-case">Upper and lower case</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-url-package"><code>url</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-using-BibTeX">using BibTeX</a>:</td><td> </td><td valign="top"><a href="#Using-BibTeX">Using BibTeX</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-UTF_002d8">UTF-8</a>:</td><td> </td><td valign="top"><a href="#TeX-engines">TeX engines</a></td></tr>
 <tr><td colspan="4"> <hr></td></tr>
@@ -17952,6 +18036,7 @@
 <tr><td></td><td valign="top"><a href="#index-vector-symbol_002c-math">vector symbol, math</a>:</td><td> </td><td valign="top"><a href="#Math-accents">Math accents</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-verbatim-text">verbatim text</a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-verbatim-text_002c-inline">verbatim text, inline</a>:</td><td> </td><td valign="top"><a href="#g_t_005cverb">\verb</a></td></tr>
+<tr><td></td><td valign="top"><a href="#index-verbatimbox-package"><code>verbatimbox</code> <span class="roman">package</span></a>:</td><td> </td><td valign="top"><a href="#verbatim">verbatim</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-vertical-bar_002c-double_002c-in-text">vertical bar, double, in text</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-vertical-bar_002c-in-text">vertical bar, in text</a>:</td><td> </td><td valign="top"><a href="#Text-symbols">Text symbols</a></td></tr>
 <tr><td></td><td valign="top"><a href="#index-vertical-space">vertical space</a>:</td><td> </td><td valign="top"><a href="#g_t_005caddvspace">\addvspace</a></td></tr>

Modified: trunk/latex2e.info
===================================================================
--- trunk/latex2e.info	2018-05-23 13:12:13 UTC (rev 627)
+++ trunk/latex2e.info	2018-05-24 15:23:34 UTC (rev 628)
@@ -4911,15 +4911,35 @@
      LITERAL-TEXT
      \end{verbatim}
 
-   A paragraph-making environment in which LaTeX produces exactly what
-you type in; for instance the '\' character produces a printed '\'.
-Carriage returns and blanks are taken literally.  The output appears in
-a monospaced typewriter-like font ('\tt').
+   A paragraph-making environment in which LaTeX produces as output
+exactly what you type as input.  For instance inside LITERAL-TEXT the
+backslash '\' character does not start commands, it produces a printed
+'\', and carriage returns and blanks are taken literally.  The output
+appears in a monospaced typewriter-like font ('\tt').
 
-   For typesetting computer code there are quite a few packages that are
-an improvement over using the 'verbatim' environment, such as
-'listings', and 'minted'.  For a list of them, see CTAN.
+     \begin{verbatim}
+     Symbol swearing: %&$#?!.
+     \end{verbatim}
 
+   The only restriction on 'literal-text' is that it cannot include the
+string '\end{verbatim}'.
+
+   You cannot use the verbatim environment in the argument to macros,
+for instance in the argument to a '\section'.  This is not the same as
+commands being fragile (*note \protect::), instead it just cannot appear
+there.  (But the 'cprotect' package can help with this.)
+
+   One common use of verbatim input is to typeset computer code.  There
+are packages that are an improvement the 'verbatim' environment.  For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files.  Such packages include 'listings', and
+'minted'.
+
+   A package that provides many more options for verbatim environments
+is 'fancyverb'.  Another is 'verbatimbox'.
+
+   For a list of all the relevant packages, see CTAN.
+
 * Menu:
 
 * \verb::       The macro form of the 'verbatim' environment.
@@ -4932,26 +4952,37 @@
 
 Synopsis:
 
-     \verbCHARLITERAL TEXTCHAR
-     \verb*CHARLITERAL TEXTCHAR
+     \verb CHAR LITERAL-TEXT CHAR
+     \verb* CHAR LITERAL-TEXT CHAR
 
-   Typeset LITERAL TEXT as it is input, including special characters and
-spaces, using the typewriter ('\tt') font.
+   Typeset LITERAL-TEXT as it is input, including special characters and
+spaces, using the typewriter ('\tt') font.  The '*'-form differs only in
+that spaces are printed with a visible space character.
 
-   The first '\verb' below has the LITERAL TEXT demarcated with
-exclamation point, '!'.  The second '\verb' instead uses plus, '+', as
-CHAR.
+   The single-character delimiter CHAR surrounds LITERAL-TEXT; it is the
+same character before and after.  No spaces come between '\verb' or
+'\verb*' and CHAR, or between CHAR and LITERAL-TEXT, or between
+LITERAL-TEXT and the second occurrence of CHAR.  The delimiter must not
+appear in LITERAL-TEXT.  The LITERAL-TEXT cannot include a line break.
 
+   This example shows two different invocations of '\verb'.
+
      This is \verb!literally! the biggest pumpkin ever.
      And this is the best squash, \verb+literally!+
 
-   No spaces can come between '\verb' or '\verb*' and the delimiter
-CHAR, which begins and ends the verbatim text.  The delimiter must not
-appear in LITERAL-TEXT.
+   The first '\verb' has its LITERAL-TEXT surrounded with exclamation
+point, '!'.  The second instead uses plus, '+', because the exclamation
+point is part of 'literal-text'.
 
-   The '*'-form differs only in that spaces are printed with a "visible
-space" character.
+   For typesetting Internet addresses, URL's, the package 'url' provides
+an option that is better than the '\verb' command, since it allows line
+breaks.
 
+   You cannot use '\verb' in the argument to a macro, for instance in
+the argument to a '\section'.  It is not a question of '\verb' being
+fragile (*note \protect::), instead it just cannot appear there.  (But
+the 'cprotect' package can help with this.)
+
 
 File: latex2e.info,  Node: verse,  Prev: verbatim,  Up: Environments
 
@@ -4966,14 +4997,24 @@
        ...
      \end{verse}
 
-   The 'verse' environment is designed for poetry, though you may find
-other uses for it.
+   An environment for poetry.
 
-   The margins are indented on the left and the right, paragraphs are
-not indented, and the text is not justified.  Separate the lines of each
-stanza with '\\', and use one or more blank lines to separate the
-stanzas.
+   Here are two lines from Shakespeare's Romeo and Juliet.
 
+     Then plainly know my heart's dear love is set \\
+     On the fair daughter of rich Capulet.
+
+   Separate the lines of each stanza with '\\', and use one or more
+blank lines to separate the stanzas.
+
+     A poem is a piece of poetry.
+
+     And don't let the head of the poetry society \\
+     tell you diff'rent.
+
+   The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.
+
 
 File: latex2e.info,  Node: Line breaking,  Next: Page breaking,  Prev: Environments,  Up: Top
 
@@ -11351,6 +11392,8 @@
 * counters, printing:                    \alph \Alph \arabic \roman \Roman \fnsymbol.
                                                               (line   6)
 * counters, setting:                     \setcounter.         (line   6)
+* cprotect package:                      verbatim.            (line  26)
+* cprotect package <1>:                  \verb.               (line  34)
 * creating pictures:                     picture.             (line   6)
 * creating tables:                       table.               (line   6)
 * credit footnote:                       \maketitle.          (line  22)
@@ -11461,6 +11504,7 @@
 * external files, writing:               filecontents.        (line   6)
 * families, of fonts:                    Low-level font commands.
                                                               (line  21)
+* fancyverb package:                     verbatim.            (line  37)
 * fancyvrb package:                      tabbing.             (line 145)
 * feminine ordinal symbol:               Text symbols.        (line 135)
 * figure number, cross referencing:      \ref.                (line   6)
@@ -11641,6 +11685,7 @@
 * list of figures file:                  Output files.        (line  43)
 * list of tables file:                   Output files.        (line  43)
 * listings package:                      tabbing.             (line 145)
+* listings package <1>:                  verbatim.            (line  31)
 * lists of items:                        itemize.             (line   6)
 * lists of items, generic:               list.                (line   6)
 * lists of items, numbered:              enumerate.           (line   6)
@@ -11687,6 +11732,7 @@
 * Millimeter:                            Units of length.     (line  27)
 * minipage, creating a:                  minipage.            (line   6)
 * minted package:                        tabbing.             (line 145)
+* minted package <1>:                    verbatim.            (line  31)
 * modes:                                 Modes.               (line   6)
 * monospace font:                        Font styles.         (line  92)
 * moving arguments:                      \protect.            (line  19)
@@ -11762,10 +11808,13 @@
 * package, babel:                        thebibliography.     (line  28)
 * package, babel <1>:                    Accents.             (line   6)
 * package, cleveref:                     Cross references.    (line  38)
+* package, cprotect:                     verbatim.            (line  26)
+* package, cprotect <1>:                 \verb.               (line  34)
 * package, datetime:                     \today.              (line  22)
 * package, enumitem:                     list.                (line 247)
 * package, etoolbox:                     Class and package commands.
                                                               (line 110)
+* package, fancyverb:                    verbatim.            (line  37)
 * package, fancyvrb:                     tabbing.             (line 145)
 * package, flafter:                      Floats.              (line  82)
 * package, float:                        Floats.              (line  52)
@@ -11776,12 +11825,14 @@
 * package, geometry <1>:                 Document class options.
                                                               (line  44)
 * package, listings:                     tabbing.             (line 145)
+* package, listings <1>:                 verbatim.            (line  31)
 * package, macros2e:                     \makeatletter and \makeatother.
                                                               (line  39)
 * package, makeidx:                      Indexes.             (line  28)
 * package, mfirstuc:                     Upper and lower case.
                                                               (line  45)
 * package, minted:                       tabbing.             (line 145)
+* package, minted <1>:                   verbatim.            (line  31)
 * package, multind:                      Indexes.             (line  39)
 * package, picture:                      picture.             (line 100)
 * package, setspace:                     Low-level font commands.
@@ -11790,6 +11841,8 @@
 * package, textcase:                     Upper and lower case.
                                                               (line  42)
 * package, textcomp:                     Font styles.         (line 134)
+* package, url:                          \verb.               (line  30)
+* package, verbatimbox:                  verbatim.            (line  37)
 * package, xspace:                       \(SPACE) after control sequence.
                                                               (line  20)
 * packages, loading additional:          Additional packages. (line   6)
@@ -12022,18 +12075,20 @@
 * unordered lists:                       itemize.             (line   6)
 * Upper case:                            Upper and lower case.
                                                               (line   6)
+* url package:                           \verb.               (line  30)
 * using BibTeX:                          Using BibTeX.        (line   6)
 * UTF-8:                                 TeX engines.         (line   6)
 * variables, a list of:                  Counters.            (line   6)
 * vector symbol, math:                   Math accents.        (line  47)
 * verbatim text:                         verbatim.            (line   6)
 * verbatim text, inline:                 \verb.               (line   6)
+* verbatimbox package:                   verbatim.            (line  37)
 * vertical bar, double, in text:         Text symbols.        (line  79)
 * vertical bar, in text:                 Text symbols.        (line  76)
 * vertical space:                        \addvspace.          (line   6)
 * vertical space <1>:                    \vspace.             (line   6)
 * vertical space before paragraphs:      \parskip.            (line   6)
-* visible space:                         \verb.               (line  25)
+* visible space:                         \verb.               (line  12)
 * visible space symbol, in text:         Text symbols.        (line 181)
 * weights, of fonts:                     Low-level font commands.
                                                               (line  58)
@@ -13103,7 +13158,7 @@
 * \\ for flushleft:                      flushleft.           (line  14)
 * \\ for letters:                        Letters.             (line  50)
 * \\ for tabular:                        tabular.             (line  34)
-* \\ for verse:                          verse.               (line  17)
+* \\ for verse:                          verse.               (line  21)
 * \\ for \author:                        \maketitle.          (line  12)
 * \\ for \title:                         \maketitle.          (line  26)
 * \\ force line break:                   \\.                  (line   6)
@@ -13386,166 +13441,166 @@
 Node: theorem185352
 Node: titlepage186274
 Node: verbatim187547
-Node: \verb188262
-Node: verse189042
-Node: Line breaking189542
-Node: \\190639
-Node: \obeycr & \restorecr191677
-Node: \newline192079
-Node: \- (hyphenation)192913
-Node: \discretionary193528
-Node: \fussy193820
-Node: \sloppy194210
-Node: \hyphenation194537
-Node: \linebreak & \nolinebreak195162
-Node: Page breaking195814
-Node: \cleardoublepage196422
-Node: \clearpage196851
-Node: \newpage197148
-Node: \enlargethispage197379
-Node: \pagebreak & \nopagebreak197906
-Node: Footnotes198600
-Node: \footnote199854
-Node: \footnotemark201650
-Node: \footnotetext202894
-Node: Footnotes in a table203384
-Node: Footnotes in section headings205241
-Node: Footnotes of footnotes206097
-Node: Multiple reference to footnotes206864
-Node: Footnote parameters207722
-Node: Definitions208472
-Node: \newcommand & \renewcommand209349
-Node: \providecommand213595
-Node: \newcounter214256
-Node: \newlength215407
-Node: \newsavebox216053
-Node: \newenvironment & \renewenvironment216663
-Node: \newtheorem221394
-Node: \newfont224867
-Node: \protect226162
-Node: \ignorespaces & \ignorespacesafterend228548
-Node: Counters231297
-Node: \alph \Alph \arabic \roman \Roman \fnsymbol232970
-Node: \usecounter235799
-Node: \value236662
-Node: \setcounter237591
-Node: \addtocounter238193
-Node: \refstepcounter238658
-Node: \stepcounter239316
-Node: \day \month \year239658
-Node: Lengths240203
-Node: Units of length241993
-Node: \setlength243487
-Node: \addtolength243891
-Node: \settodepth244209
-Node: \settoheight244500
-Node: \settowidth244797
-Node: Predefined lengths245105
-Node: Making paragraphs245620
-Node: \indent246192
-Node: \noindent246654
-Node: \parskip247163
-Node: Marginal notes247421
-Node: Math formulas249233
-Node: Subscripts & superscripts251017
-Node: Math symbols252355
-Node: Math functions277684
-Node: Math accents278627
-Node: Spacing in math mode279599
-Node: Math miscellany281066
-Node: Modes283616
-Node: \ensuremath285456
-Node: Page styles286372
-Node: \maketitle286866
-Node: \pagenumbering287936
-Node: \pagestyle288432
-Node: \thispagestyle289573
-Node: Spaces289879
-Node: \hspace290749
-Node: \hfill291704
-Node: \spacefactor292096
-Node: \(SPACE) and \@294808
-Ref: \AT294951
-Node: \frenchspacing296428
-Node: \normalsfcodes297044
-Node: \(SPACE) after control sequence297233
-Node: \thinspace298144
-Node: \/298464
-Node: \hrulefill \dotfill299646
-Node: \addvspace300639
-Node: \bigskip \medskip \smallskip301685
-Node: \vfill302577
-Node: \vspace303446
-Node: Boxes304439
-Node: \mbox305151
-Node: \fbox and \framebox305438
-Node: lrbox306242
-Node: \makebox306600
-Node: \parbox307320
-Node: \raisebox309431
-Node: \savebox310044
-Node: \sbox310459
-Node: \usebox310908
-Node: Color311169
-Node: Color package options312013
-Node: Color models313659
-Node: Commands for color315968
-Node: Define colors316383
-Node: Colored text317098
-Node: Colored boxes319473
-Node: Colored pages320912
-Node: Graphics321605
-Node: Graphics package options323724
-Node: Graphics package configuration326480
-Node: \graphicspath327282
-Node: \DeclareGraphicsExtensions330205
-Node: \DeclareGraphicsRule332002
-Node: Commands for graphics335191
-Node: \includegraphics335696
-Node: \rotatebox348665
-Node: \scalebox351460
-Node: \resizebox352512
-Node: Special insertions353704
-Node: Reserved characters354508
-Node: Upper and lower case355709
-Node: Symbols by font position357624
-Node: Text symbols358244
-Node: Accents361692
-Node: Additional Latin letters364234
-Ref: Non-English characters364405
-Node: \rule365422
-Node: \today365851
-Node: Splitting the input366605
-Node: \endinput367982
-Node: \include & \includeonly369249
-Node: \input373266
-Node: Front/back matter373974
-Node: Tables of contents374179
-Node: \addcontentsline375240
-Node: \addtocontents376258
-Node: Glossaries376791
-Node: Indexes377310
-Node: Letters378943
-Node: \address382621
-Node: \cc383491
-Node: \closing383909
-Node: \encl384220
-Node: \location384635
-Node: \makelabels384904
-Node: \name385905
-Node: \opening386135
-Node: \ps386475
-Node: \signature386764
-Node: \telephone387856
-Node: Terminal input/output388221
-Node: \typein388486
-Node: \typeout389071
-Node: Command line389694
-Node: Document templates390646
-Node: beamer template391053
-Node: book template391704
-Node: tugboat template392072
-Node: Concept Index394436
-Node: Command Index457701
+Node: \verb189058
+Node: verse190528
+Node: Line breaking191256
+Node: \\192353
+Node: \obeycr & \restorecr193391
+Node: \newline193793
+Node: \- (hyphenation)194627
+Node: \discretionary195242
+Node: \fussy195534
+Node: \sloppy195924
+Node: \hyphenation196251
+Node: \linebreak & \nolinebreak196876
+Node: Page breaking197528
+Node: \cleardoublepage198136
+Node: \clearpage198565
+Node: \newpage198862
+Node: \enlargethispage199093
+Node: \pagebreak & \nopagebreak199620
+Node: Footnotes200314
+Node: \footnote201568
+Node: \footnotemark203364
+Node: \footnotetext204608
+Node: Footnotes in a table205098
+Node: Footnotes in section headings206955
+Node: Footnotes of footnotes207811
+Node: Multiple reference to footnotes208578
+Node: Footnote parameters209436
+Node: Definitions210186
+Node: \newcommand & \renewcommand211063
+Node: \providecommand215309
+Node: \newcounter215970
+Node: \newlength217121
+Node: \newsavebox217767
+Node: \newenvironment & \renewenvironment218377
+Node: \newtheorem223108
+Node: \newfont226581
+Node: \protect227876
+Node: \ignorespaces & \ignorespacesafterend230262
+Node: Counters233011
+Node: \alph \Alph \arabic \roman \Roman \fnsymbol234684
+Node: \usecounter237513
+Node: \value238376
+Node: \setcounter239305
+Node: \addtocounter239907
+Node: \refstepcounter240372
+Node: \stepcounter241030
+Node: \day \month \year241372
+Node: Lengths241917
+Node: Units of length243707
+Node: \setlength245201
+Node: \addtolength245605
+Node: \settodepth245923
+Node: \settoheight246214
+Node: \settowidth246511
+Node: Predefined lengths246819
+Node: Making paragraphs247334
+Node: \indent247906
+Node: \noindent248368
+Node: \parskip248877
+Node: Marginal notes249135
+Node: Math formulas250947
+Node: Subscripts & superscripts252731
+Node: Math symbols254069
+Node: Math functions279398
+Node: Math accents280341
+Node: Spacing in math mode281313
+Node: Math miscellany282780
+Node: Modes285330
+Node: \ensuremath287170
+Node: Page styles288086
+Node: \maketitle288580
+Node: \pagenumbering289650
+Node: \pagestyle290146
+Node: \thispagestyle291287
+Node: Spaces291593
+Node: \hspace292463
+Node: \hfill293418
+Node: \spacefactor293810
+Node: \(SPACE) and \@296522
+Ref: \AT296665
+Node: \frenchspacing298142
+Node: \normalsfcodes298758
+Node: \(SPACE) after control sequence298947
+Node: \thinspace299858
+Node: \/300178
+Node: \hrulefill \dotfill301360
+Node: \addvspace302353
+Node: \bigskip \medskip \smallskip303399
+Node: \vfill304291
+Node: \vspace305160
+Node: Boxes306153
+Node: \mbox306865
+Node: \fbox and \framebox307152
+Node: lrbox307956
+Node: \makebox308314
+Node: \parbox309034
+Node: \raisebox311145
+Node: \savebox311758
+Node: \sbox312173
+Node: \usebox312622
+Node: Color312883
+Node: Color package options313727
+Node: Color models315373
+Node: Commands for color317682
+Node: Define colors318097
+Node: Colored text318812
+Node: Colored boxes321187
+Node: Colored pages322626
+Node: Graphics323319
+Node: Graphics package options325438
+Node: Graphics package configuration328194
+Node: \graphicspath328996
+Node: \DeclareGraphicsExtensions331919
+Node: \DeclareGraphicsRule333716
+Node: Commands for graphics336905
+Node: \includegraphics337410
+Node: \rotatebox350379
+Node: \scalebox353174
+Node: \resizebox354226
+Node: Special insertions355418
+Node: Reserved characters356222
+Node: Upper and lower case357423
+Node: Symbols by font position359338
+Node: Text symbols359958
+Node: Accents363406
+Node: Additional Latin letters365948
+Ref: Non-English characters366119
+Node: \rule367136
+Node: \today367565
+Node: Splitting the input368319
+Node: \endinput369696
+Node: \include & \includeonly370963
+Node: \input374980
+Node: Front/back matter375688
+Node: Tables of contents375893
+Node: \addcontentsline376954
+Node: \addtocontents377972
+Node: Glossaries378505
+Node: Indexes379024
+Node: Letters380657
+Node: \address384335
+Node: \cc385205
+Node: \closing385623
+Node: \encl385934
+Node: \location386349
+Node: \makelabels386618
+Node: \name387619
+Node: \opening387849
+Node: \ps388189
+Node: \signature388478
+Node: \telephone389570
+Node: Terminal input/output389935
+Node: \typein390200
+Node: \typeout390785
+Node: Command line391408
+Node: Document templates392360
+Node: beamer template392767
+Node: book template393418
+Node: tugboat template393786
+Node: Concept Index396150
+Node: Command Index460437
 
 End Tag Table

Modified: trunk/latex2e.pdf
===================================================================
(Binary files differ)

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2018-05-23 13:12:13 UTC (rev 627)
+++ trunk/latex2e.texi	2018-05-24 15:23:34 UTC (rev 628)
@@ -26,7 +26,7 @@
 @c xx JH picture: put vs multiput vs qspline to put things in picture
 @c xx JH expand BiBTeX
 @c xx JH expand theorem, AMS math
- at c xx JH expand verbatim, verb, add something on code listings
+ at c xx JH add something on code listings
 @c
 @c xx The typeset source2e has an index with all kernel
 @c xx commands, though some are internal and shouldn't be included.
@@ -5337,7 +5337,6 @@
 
 @PkgIndex{algorithm2e} @PkgIndex{listings} @PkgIndex{minted}
 @PkgIndex{fancyvrb}
-
 (The above example is just for illustration of the environment.  To
 actually typeset computer code in typewriter like this, a verbatim
 environment (@pxref{verbatim}) would normally suffice.  For
@@ -6098,20 +6097,48 @@
 \end@{verbatim@}
 @end example
 
-A paragraph-making environment in which @LaTeX{} produces as ooutput
-exactly what you type as input.  For instance the @code{\} character
-produces a printed @samp{\}.  Carriage returns and blanks are taken
+A paragraph-making environment in which @LaTeX{} produces as output
+exactly what you type as input.  For instance inside @var{literal-text}
+the backslash at tie{}@code{\} character does not start commands, it
+produces a printed @samp{\}, and carriage returns and blanks are taken
 literally.  The output appears in a monospaced typewriter-like font
 (@code{\tt}).
 
-For typesetting computer code there are quite a few packages that are an
-improvement over using the @code{verbatim} environment, such as
- at code{listings}, and @code{minted}.  For a list of them, see CTAN.
+ at example
+\begin@{verbatim@}
+Symbol swearing: %&$#?@!.
+\end@{verbatim@}
+ at end example
 
+The only restriction on @code{literal-text} is that it cannot include
+the string @code{\end@{verbatim@}}.
+
+ at 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.)
+
+ at PkgIndex{listings}
+ at PkgIndex{minted}
+One common use of verbatim input is to typeset computer code.  There are
+packages that are an improvement the @code{verbatim} environment.  For
+instance, one improvement is to allow the verbatim inclusion of external
+files, or parts of those files.  Such packages include @code{listings},
+and @code{minted}.
+
+ at PkgIndex{fancyverb}
+ at PkgIndex{verbatimbox}
+A package that provides many more options for verbatim environments is
+ at code{fancyverb}.  Another is @code{verbatimbox}.
+
+For a list of all the relevant packages, see CTAN.
+
 @menu
 * \verb::       The macro form of the @code{verbatim} environment.
 @end menu
 
+
 @node \verb
 @subsection @code{\verb}
 
@@ -6121,34 +6148,49 @@
 Synopsis:
 
 @example
-\verb at var{char}@var{literal text}@var{char}
-\verb*@var{char}@var{literal text}@var{char}
+\verb @var{char} @var{literal-text} @var{char}
+\verb* @var{char} @var{literal-text} @var{char}
 @end example
 
-Typeset @var{literal text} as it is input, including special characters
+Typeset @var{literal-text} as it is input, including special characters
 and spaces, using the typewriter (@code{\tt}) font.
+ at cindex visible space
+The @code{*}-form differs only in that spaces are printed with a visible
+space character.
+ at tex
+(Namely, {\tt\char`\ }.)
+ at end tex
 
-The first @code{\verb} below has the @var{literal text} demarcated with
-exclamation point, @code{!}.  The second @code{\verb} instead uses plus,
- at code{+}, as @var{char}.
+The single-character delimiter @var{char} surrounds @var{literal-text};
+it is the same character before and after.  No spaces come between
+ at code{\verb} or @code{\verb*} and @var{char}, or between @var{char} and
+ at var{literal-text}, or between @var{literal-text} and the second
+occurrence of @var{char}.  The delimiter must not appear in
+ at var{literal-text}. The @var{literal-text} cannot include a line break.
 
+This example shows two different invocations of @code{\verb}.
+
 @example
 This is \verb!literally! the biggest pumpkin ever.
 And this is the best squash, \verb+literally!+
 @end example
 
-No spaces can come between @code{\verb} or @code{\verb*} and the
-delimiter @var{char}, which begins and ends the verbatim text.  The
-delimiter must not appear in @var{literal-text}.
+The first @code{\verb} has its @var{literal-text} surrounded with
+exclamation point, @code{!}.  The second instead uses plus, @code{+},
+because the exclamation point is part of @code{literal-text}.
 
- at cindex visible space
-The @code{*}-form differs only in that spaces are printed with a
-``visible space'' character.
- at tex
-(Namely, {\tt\char`\ }.)
- at end tex
+ at PkgIndex{url}
+For typesetting Internet addresses, URL's, the package @code{url}
+provides an option that is better than the @code{\verb} command, since
+it allows line breaks.
 
+ at PkgIndex{cprotect}
+You cannot use @code{\verb} in the argument to a macro, for instance in
+the argument to a @code{\section}.  It is not a question of @code{\verb}
+being fragile (@pxref{\protect}), instead it just cannot appear there.
+(But the @code{cprotect} package can help with this.)
 
+
 @node verse
 @section @code{verse}
 
@@ -6165,16 +6207,30 @@
 \end@{verse@}
 @end example
 
-The @code{verse} environment is designed for poetry, though you may find
-other uses for it.
+An environment for poetry.
 
+Here are two lines from Shakespeare's Romeo and Juliet.
+
+ at example
+Then plainly know my heart's dear love is set \\
+On the fair daughter of rich Capulet.
+ at end example
+
 @findex \\ @r{for @code{verse}}
-The margins are indented on the left and the right, paragraphs are not
-indented, and the text is not justified.  Separate the lines of each
-stanza with @code{\\}, and use one or more blank lines to separate the
-stanzas.
+Separate the lines of each stanza with @code{\\}, and use one or more
+blank lines to separate the stanzas.
 
+ at example
+A poem is a piece of poetry.
 
+And don't let the head of the poetry society \\
+tell you diff'rent.
+ at end example
+
+The output has margins indented on the left and the right, paragraphs
+are not indented, and the text is not right-justified.
+
+
 @node Line breaking
 @chapter Line breaking
 



More information about the latexrefman-commits mailing list