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

[Karl Berry]

Author: karl
Date: 2024-05-24 15:44:18 +0000 (Fri, 24 May 2024)
New Revision: 1176

Modified:
   trunk/ChangeLog
   trunk/latex2e.texi
Log:
(itemize): language adaptations, margins outside env

Modified: trunk/ChangeLog
===================================================================
--- trunk/ChangeLog	2024-05-13 15:37:39 UTC (rev 1175)
+++ trunk/ChangeLog	2024-05-24 15:44:18 UTC (rev 1176)
@@ -1,3 +1,10 @@
+2024-05-24  Karl Berry  <karl at freefriends.org>
+
+	* latex2e.texi (itemize): give an example of language settings
+	changing list formatting; mention that margins must be overridden
+	outside the list. Report from Claude Quitte,
+	https://tug.org/pipermail/latexrefman/2024q2/000952.html
+
 2024-05-13  Karl Berry  <karl at freefriends.org>
 
 	* Makefile (distdiff): new target to diff against released.

Modified: trunk/latex2e.texi
===================================================================
--- trunk/latex2e.texi	2024-05-13 15:37:39 UTC (rev 1175)
+++ trunk/latex2e.texi	2024-05-24 15:44:18 UTC (rev 1176)
@@ -5590,11 +5590,12 @@
 \end@{itemize@}
 @end example
 
-Produce an @dfn{unordered list}, sometimes called a bullet list.  There
-must be at least one @code{\item} within the environment; having none causes the
- at LaTeX{} error @samp{Something's wrong--perhaps a missing \item}.
+Produce an @dfn{unordered list}, sometimes called a bullet list.
+There must be at least one @code{\item} within the environment; having
+none causes the @LaTeX{} error @samp{Something's wrong--perhaps a
+missing \item}.
 
-This gives a two-item list.
+This gives a two-item list:
 
 @example
 \begin@{itemize@}
@@ -5603,12 +5604,19 @@
 \end@{itemize@}
 @end example
 
- at noindent
-With the default locale---without loading e.g.@: @package{babel} package
-with another language than USenglish---as a top-level list each label
-would come out as a bullet, @bullet{}.  The format of the labeling
-depends on the nesting level; see below.
+By default, in a top-level list each label would come out as a bullet,
+ at bullet{}.  The format of the labeling depends on the nesting level;
+see below.
 
+Many language adaptations change list formatting, in which case this
+section may apply only partially or not at all. For instance, after this:
+
+ at example
+\usepackage[french]@{babel@} % changes list formatting!
+ at end example
+
+ at noindent the margins are smaller and the item markers are different.
+
 @findex \item
 Start list items with the @code{\item} command (@pxref{\item}).  If you
 give @code{\item} an optional argument by following it with square
@@ -5638,14 +5646,13 @@
 
 @enumerate
 @item @bullet{} (bullet, from @code{\textbullet})
- at item @b{- at w{-}} (bold en-dash, from @code{\normalfont\bfseries\textendash})
+ at item @b{--} (bold en-dash, from @code{\normalfont\bfseries\textendash})
 @item * (asterisk, from @code{\textasteriskcentered})
- at iftex
- at item @math{\cdot} (vertically centered dot, from @code{\textperiodcentered})
- at end iftex
+ at item @math{\cdot} (vertically centered dot, 
 @ifnottex
- at item . (vertically centered dot, rendered here as a period, from @code{\textperiodcentered})
+rendered here as a period,
 @end ifnottex
+from @code{\textperiodcentered})
 @end enumerate
 
 Change the labels with @code{\renewcommand}.  For instance, this makes
@@ -5671,12 +5678,13 @@
 @anchor{itemize leftmarginvi}
 The distance between the left margin of the enclosing environment and
 the left margin of the @code{itemize} list is determined by the
-parameters @code{\leftmargini} through @code{\leftmarginvi}.  (This also
-uses the convention of using lowercase roman numerals a the end of the
-command name to denote the nesting level.)  The defaults are:
- at code{2.5em} in level 1 (@code{2em} in two-column mode), @code{2.2em} in
-level 2, @code{1.87em} in level 3, and @code{1.7em} in level 4, with
-smaller values for more deeply nested levels.
+parameters @code{\leftmargini} through @code{\leftmarginvi}.  (This
+also uses the convention of using lowercase roman numerals at the end
+of the command name to denote the nesting level.)  The defaults are:
+ at code{2.5em} in level 1 (@code{2em} in two-column mode), @code{2.2em}
+in level 2, @code{1.87em} in level 3, and @code{1.7em} in level 4,
+with smaller values for more deeply nested levels.  The margin
+parameters must be overridden before the list starts.
 
 @PkgIndex{enumitem}
 For other major @LaTeX{} labeled list environments, see
@@ -5686,11 +5694,14 @@
 for information about customizing list layout, see @ref{list}.  The
 package @package{enumitem} is useful for customizing lists.
 
-This example greatly reduces the margin space for outermost itemized
-lists.
+This example greatly reduces the margin space for an outermost itemized
+list:
 
 @example
 \setlength@{\leftmargini@}@{1.25em@} % default 2.5em
+\begin@{itemize@}
+\item ...
+\end@{itemize@}
 @end example
 
 @findex \parskip @r{example}
@@ -5697,7 +5708,7 @@
 Especially for lists with short items, it may be desirable to elide
 space between items.  Here is an example defining an @code{itemize*}
 environment with no extra spacing between items, or between paragraphs
-within a single item (@code{\parskip} is not list-specific,
+within a single item (@code{\parskip} is not list-specific;
 @pxref{\parindent & \parskip}):
 
 @example