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

[jhefferon at domain.hid]

Author: jhefferon
Date: Mon Aug 17 16:09:31 2015
New Revision: 402

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

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=402&r1=401&r2=402&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Mon Aug 17 16:09:31 2015
@@ -1,3 +1,8 @@
+2015-08-17  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (description): Add error message if \item is
+	left out.
+
 2015-08-14  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (Environment, Declaration): Create these two nodes

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=402&r1=401&r2=402&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Mon Aug 17 16:09:31 2015
@@ -1980,20 +1980,27 @@
 @end example
 
 @findex \item
-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.
+Environment to make a labelled list.  Each item's @var{label} is typeset
+in bold, flush-left.  Each item's text may contain multiple paragraphs.
+Although the labels on the items are optional there is no sensible
+default, so all items should have labels.
+
+A list consists of at least one item; see at domain.hid} (having no
+items causes the @LaTeX{} error @samp{Something's wrong--perhaps a
+missing \item}).
 
 @cindex bold typewriter, avoiding
 @cindex typewriter labels in lists
-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, so to get non-bolded
-typewriter, use @code{\item[@{\tt label text@}]}.  To get normal text
-use @code{\item[@{\rm label text@}]}.
-
-For other major @LaTeX{} list environments, see @ref{itemize} and
- at domain.hid}.  For information about customizing list layout, see
+Since the labels are in bold style, if the label text calls for a font
+change given in argument style (see @ref{Font styles}) then it will come
+out bold.  For instance, if the label text calls for typewriter with
+ at code{\item[\texttt at domain.hid text@}]} then it will appear in bold
+typewriter, if that is available. The simplest way to get non-bolded
+typewriter is to use declaritive style @code{\item[@{\tt label text@}]}.
+Similarly, get normal text use @code{\item[@{\rm label text@}]}.
+
+For other major @LaTeX{} labelled list environments, see @ref{itemize}
+and @ref{enumerate}.  For information about customizing list layout, see
 @ref{list}; also, the package @file{enumitem} is useful for this.
 
 This example shows the environment used for a sequence of definitions.
@@ -2127,11 +2134,10 @@
 \end at domain.hid@}
 @end example
 
-The @code{enumerate} environment produces a numbered list.  Enumerations
-can be nested within one another, up to four levels deep.  They can also
-be nested within other paragraph-making environments, such as
- at domain.hid} (@pxref{itemize}) and @code{description}
-(@pxref{description}).
+Produce a numbered list.  Enumerations can be nested within one another,
+up to four levels deep.  They can also be nested within other
+paragraph-making environments, including @code{itemize}
+(@pxref{itemize}) and @code{description} (@pxref{description}).
 
 @findex \item
 Each item of an enumerated list begins with an @code{\item} command.