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

[jhefferon at domain.hid]

Author: jhefferon
Date: Mon Aug 17 17:30:21 2015
New Revision: 403

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

Modified:
    trunk/ChangeLog
    trunk/latex2e.texi

Modified: trunk/ChangeLog
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/ChangeLog?rev=403&r1=402&r2=403&view=diff
==============================================================================
--- trunk/ChangeLog	(original)
+++ trunk/ChangeLog	Mon Aug 17 17:30:21 2015
@@ -1,3 +1,8 @@
+2015-08-17  Jim Hefferon  <jhefferon at domain.hid>
+
+	* latex2e.texi (enumerate): Add more description. Combine best
+	parts of this and description description.
+
 2015-08-17  Jim Hefferon  <jhefferon at domain.hid>
 
 	* latex2e.texi (description): Add error message if \item is

Modified: trunk/latex2e.texi
URL: http://svn.gna.org/viewcvs/latexrefman/trunk/latex2e.texi?rev=403&r1=402&r2=403&view=diff
==============================================================================
--- trunk/latex2e.texi	(original)
+++ trunk/latex2e.texi	Mon Aug 17 17:30:21 2015
@@ -1980,14 +1980,15 @@
 @end example
 
 @findex \item
-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
+Environment to make a labelled list of items.  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.
+
+ at findex \item
+The 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}).
+missing \item}).  Each item is produced with an @code{\item} command.
 
 @cindex bold typewriter, avoiding
 @cindex typewriter labels in lists
@@ -2134,47 +2135,72 @@
 \end at domain.hid@}
 @end example
 
-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}).
+Environment to produce a numbered list of items.  The format of the
+label numbering depends on whether this environment is nested within
+another; see below.
 
 @findex \item
-Each item of an enumerated list begins with an @code{\item} command.
-There must be at least one @code{\item} command within the environment.
-
-By default, the numbering at each level is done like this:
+The list consists of at least one item.  Having no items causes the
+ at LaTeX{} error @samp{Something's wrong--perhaps a missing \item}.  Each
+item is produced with an @code{\item} command.
+
+This example lists the top two finishers in the 1908 Olympic marathon.
+
+ at example
+\begin at domain.hid@}
+ \item Johnny Hayes (USA)
+ \item Charles Hefferon (RSA) 
+\end at domain.hid@}
+ at end example
+
+Enumerations may be nested within a paragraph-making environment,
+including @code{itemize} (@pxref{itemize}), @code{description}
+(@pxref{description}) and @code{enumeration}, up to four levels deep.
+The format of the label produced depends on the place in the nesting.
+This gives @LaTeX{}'s default for the format at each nesting level
+(where 1 is the outermost level):
 
 @enumerate
- at domain.hid 1., 2., @dots{}
- at domain.hid (a), (b), @dots{}
- at domain.hid i., ii., @dots{}
- at domain.hid A., B., @dots{}
+ at item arabic number followed by a period: @samp{1.}, @samp{2.}, at tie{}@dots{}
+ at item lower case letter inside parentheses: @samp{(a)}, @samp{(b)}@tie{}@dots{}
+ at item lower case roman numeral followed by a period: @samp{i.}, @samp{ii.}, at tie{}@dots{}
+ at item upper case letter followed by a period: @samp{A.}, @samp{B.}, at tie{}@dots{}
 @end enumerate
 
 @findex \enumi
 @findex \enumii
 @findex \enumiii
 @findex \enumiv
-The @code{enumerate} environment uses the counters @code{\enumi}
-through @code{\enumiv} counters (@pxref{Counters}).  If the optional
-argument to @code{\item} is given, the counter is not incremented for
-that item.
+The @code{enumerate} environment uses the counters @code{\enumi} through
+ at code{\enumiv} counters (@pxref{Counters}).  If you use the optional
+argument to @code{\item} then the counter is not incremented for that
+item (@pxref{\item}).
 
 @findex \labelenumi
 @findex \labelenumii
 @findex \labelenumiii
 @findex \labelenumiv
-The @code{enumerate} environment uses the commands @code{\labelenumi}
-through @code{\labelenumiv} to produce the default label.  So, you can
-use @code{\renewcommand} to change the labels (@pxref{\newcommand &
-\renewcommand}).  For instance, to have the first level use uppercase
-letters:
+To change the format of the label use @code{\renewcommand}
+(@pxref{\newcommand & \renewcommand}) on the commands @code{\labelenumi}
+through @code{\labelenumiv}. For instance, this first level list will be
+labelled with uppercase letters, in boldface, and without a trailing
+period:
 
 @findex \Alph @r{example}
 @example
-\renewcommand at domain.hid@}@}
- at domain.hid example
+\renewcommand at domain.hid@}@}@}
+\begin at domain.hid@}
+  \item eI
+  \item bi:
+  \item si:
+\end at domain.hid@}
+ at end example
+
+For a list of counter-labelling commands like @code{\Alph} see
+ at ref{\alph \Alph \arabic \roman \Roman \fnsymbol}.
+
+For more on customizing the layout see @ref{list}.  Also, the package
+ at file{enumitem} is useful for this.
 
 
 
@@ -2747,18 +2773,6 @@
 
 An entry in a list.  The entries are prefixed by a label, whose default
 depends on the list type.  
-
- at domain.hid default is that an @code{itemize} list is labelled with
-bullets.  In a @code{description} list each @code{\item} should use the
- at domain.hid label}, otherwise @LaTeX{} leaves the label empty.  By
-default an @code{enumerate} list at the outermost level (that is, not
-nested inside another list) is labelled with ascending arabic numbers
-followed by a period, as in @samp{1.}.  If an @code{enumerate} list is
-nested inside another to make a second level list, then by default it is
-labelled with a lower case letter inside parentheses, as in @samp{(a)}.
-At the third level by default it is labelled with a lower case roman
-numeral followed by a period, and at the fourth level of nesting it is
-labelled with an upper case letter followed by a period.
 
 Because the optional argument @var{optional label} is surrounded by
 square brackets at domain.hid{[} and @code{]}), to use square brackets