[latexrefman-commits] r395 - in /trunk: ChangeLog latex2e.texi

[jhefferon at domain.hid]

Author: jhefferon
Date: Sun Aug  9 20:16:34 2015
New Revision: 395

URL: http://svn.gna.org/viewcvs/latexrefman?rev=395&view=rev
Log:
description

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=395&r1=394&r2=395&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Sun Aug  9 20:16:34 2015
@@ -1,3 +1,7 @@
+2015-08-09  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (description): Add detail and an example.
+
 2015-08-08  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (center, \centering): Add detail, including

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=395&r1=394&r2=395&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Sun Aug  9 20:16:34 2015
@@ -1832,14 +1832,13 @@
 double-backslash at domain.hid{\\} (@pxref{\\}).
 @findex \\ @r{(for @code{center})}
 
-This environment inserts space above and below the text body.
- at domain.hid} to avoid such space (for example, inside a
- at domain.hid} environment).
-
-In this example, depending on how long the page's lines are, @LaTeX{} may
-choose a break for the part before the double backslash, will center
-the line or two , then will break at the double backslash, and will center
-the ending.
+This environment inserts space above and below the text body.  See
+ at ref{\centering} to avoid such space, for example inside a @code{figure}
+environment.
+
+In this example, depending on the line width, @LaTeX{} may choose a break
+for the part before the double backslash, will center the line or two,
+then will break at the double backslash, and will center the ending.
 
 @example
 My father considered that anyone who went to chapel and didn't drink 
@@ -1904,27 +1903,37 @@
 
 @example
 \begin at domain.hid@}
-\item [@var{label1}] @var{item1}
-\item [@var{label2}] @var{item2}
-...
+\item [@var{first label}] text of first item
+\item [@var{second label}] text of second item
+  ...
 \end at domain.hid@}
 @end example
 
 @findex \item
-The @code{description} environment is used to make labelled lists.  Each
- at domain.hid} is typeset in bold, flush right.  The @var{item} text may
+Environment to make labelled lists.  Each @var{label} is typeset in
+bold, flush-right in a fixed-width box.  The text of each item may
 contain multiple paragraphs.
 
 @cindex bold typewriter, avoiding
 @cindex typewriter labels in lists
-Another variation: since the bold style is applied to the labels, if
-you typeset a label in typewriter using @code{\texttt}, you'll get
-bold typewriter: @code{\item[\texttt at domain.hid and typewriter@}]}.  This
-may be too bold, among other issues.  To get just typewriter, use
- at domain.hid}, which resets all other style variations: @code{\item[@{\tt
-plain typewriter@}]}.
-
-For details about list spacing, see @ref{itemize}.
+Since the labels are in bold style, if you typeset a label in typewriter
+with @code{\item[\texttt at domain.hid text@}]} then the label text will appear
+in bold typewriter (if that is available).  To get non-bolded
+typewriter, use @code{\item[@{\tt label text@}]} (to get normal text use
+ at code{\item[@{\rm label text@}]}).
+
+For other major @LaTeX{} list environments, see @ref{itemize} and
+ at ref{enumerate}.  For information about customizing list layout, see
+ at ref{list}; also, the package @file{enumitem} is useful for this.
+
+This example shows the environment used for a sequence of definitions.
+
+ at example
+\begin at domain.hid@}
+  \item[lama] A priest.
+  \item[llama] A beast.
+\end at domain.hid@}
+ at end example 
 
 
 @node displaymath