[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