diff --git a/doc/texinfo.texi b/doc/texinfo.texi index 8134324275..7ee43e3746 100644 --- a/doc/texinfo.texi +++ b/doc/texinfo.texi @@ -6675,7 +6675,7 @@ @node Introducing Lists Begin an enumerated list, for example, with an @code{@@enumerate} command and end the list with an @code{@@end enumerate} command. Begin an itemized list with an @code{@@itemize} command, followed on -the same line by a formatting command such as @code{@@bullet}, and end +the same line by a formatting command such as @code{@@bullet@{@}}, and end the list with an @code{@@end itemize} command. Precede each element of a list with an @code{@@item} or @code{@@itemx} @@ -6746,14 +6746,13 @@ @node @code{@@itemize} Begin an itemized list by writing @code{@@itemize} at the beginning of a line. Follow the command, on the same line, with a character or a Texinfo command that generates a mark. Usually, you will use -@code{@@bullet} after @code{@@itemize}, but you can use -@code{@@minus}, or any command or character that results in a single -character in the Info file. (When you write the mark command such as -@code{@@bullet} after an @code{@@itemize} command, you may omit the -@samp{@{@}}.) If you don't specify a mark command, the default is -@code{@@bullet}. If you don't want any mark at all, but still want -logical items, use @code{@@w@{@}} (in this case the braces are -required). +@code{@@bullet@{@}} after @code{@@itemize}, but you can use +@code{@@minus@{@}}, or any command or character that results in a single +character@footnote{Omitting the @samp{@{@}} of mark commands +after an @code{@@itemize} command is discouraged, but was allowed +before 2024}. If you don't specify a mark command, the default is +@code{@@bullet@{@}}. If you don't want any mark at all, but still want +logical items, use @code{@@w@{@}}. @findex item @r{in @code{@@itemize}} After the @code{@@itemize}, write your items, each starting with @@ -6776,12 +6775,12 @@ @node @code{@@itemize} make the list look better. Here is an example of the use of @code{@@itemize}, followed by the -output it produces. @code{@@bullet} produces an @samp{*} in Info and +output it produces. @code{@@bullet@{@}} produces an @samp{*} in Info and a round dot in other output formats. @example @group -@@itemize @@bullet +@@itemize @@bullet@{@} @@item Some text for foo. @@ -6811,11 +6810,11 @@ @node @code{@@itemize} @example @group -@@itemize @@bullet +@@itemize @@bullet@{@} @@item First item. -@@itemize @@minus +@@itemize @@minus@{@} @@item Inner item. @@ -6833,11 +6832,11 @@ @node @code{@@itemize} This produces: @quotation -@itemize @bullet +@itemize @bullet{} @item First item. -@itemize @minus +@itemize @minus{} @item Inner item. @@ -9647,10 +9646,6 @@ @node @code{@@bullet} the closest possible thing to one. An asterisk can also be used. Here is a bullet: @bullet{} -When you use @code{@@bullet} in @code{@@itemize}, you do not need to -type the braces, because @code{@@itemize} supplies them. -(@pxref{@code{@@itemize}}). - @node @code{@@euro} @nodedescription How to insert the euro currency symbol. @@ -19272,7 +19267,7 @@ @node Command List @item @@itemize @var{mark-generating-character-or-command} Begin an unordered list: indented paragraphs with a mark, such as -@code{@@bullet}, inside the left margin at the beginning of each item. +@code{@@bullet@{@}}, inside the left margin at the beginning of each item. Pair with @code{@@end itemize}. @xref{@code{@@itemize}}. @item @@itemx