branch master updated: * doc/texinfo.texi (Introducing Lists, @code{@@itemize}): use {} in examples with mark commands @itemize arguments.

[Gavin D. Smith]

This is an automated email from the git hooks/post-receive script.

gavin pushed a commit to branch master
in repository texinfo.

The following commit(s) were added to refs/heads/master by this push:
     new 836bce17ad * doc/texinfo.texi (Introducing Lists, @code{@@itemize}): 
use {} in examples with mark commands @itemize arguments.
836bce17ad is described below

commit 836bce17ad2c7a1ceb11b2e4a34ae7aeb61f79ba
Author: Patrice Dumas <pertusus@free.fr>
AuthorDate: Sun Mar 17 11:40:21 2024 +0000

    * doc/texinfo.texi (Introducing Lists, @code{@@itemize}): use {} in
    examples with mark commands @itemize arguments.
    
    * doc/texinfo.texi (@code{@@bullet}, Click Sequences): remove text
    stating that mark commands @itemize arguments braces are normally
    omitted that are also of dubious interest.
---
 ChangeLog        |  9 +++++++++
 doc/texinfo.texi | 27 +++++++++++----------------
 2 files changed, 20 insertions(+), 16 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 89a027e896..5e56a3a801 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2024-03-17  Patrice Dumas  <pertusus@free.fr>
+
+       * doc/texinfo.texi (Introducing Lists, @code{@@itemize}): use {} in
+       examples with mark commands @itemize arguments.
+
+       * doc/texinfo.texi (@code{@@bullet}, Click Sequences): remove text
+       stating that mark commands @itemize arguments braces are normally
+       omitted that are also of dubious interest.
+
 2024-03-16  Patrice Dumas  <pertusus@free.fr>
 
        Add TOP_FOOTER_BUTTONS customization variable
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index e8df8ccb13..13fcd4ee68 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -6685,7 +6685,7 @@ command.
 @noindent
 Here is an itemized list of the different kinds of table and lists:
 
-@itemize @bullet
+@itemize @bullet{}
 @item
 Itemized lists with and without bullets.
 
@@ -6758,7 +6758,7 @@ Here is an example of the use of @code{@@itemize}:
 
 @example
 @group
-@@itemize @@bullet
+@@itemize @@bullet@{@}
 @@item
 Some text for foo.
 
@@ -6773,7 +6773,7 @@ for bar.
 This produces:
 
 @quotation
-@itemize @bullet
+@itemize @bullet{}
 @item
 Some text for foo.
 
@@ -6783,9 +6783,9 @@ for bar.
 @end itemize
 @end quotation
 
-As you can see from this example, when you give a mark command such as
-@code{@@bullet} as the argument to @code{@@itemize} command, you may
-omit the @samp{@{@}} that would normally follow the command.
+When you give a mark command such as @code{@@bullet} as the argument
+to @code{@@itemize} command, you may omit the @samp{@{@}} that would
+normally follow the command.
 
 @cindex @code{@@w}, for blank items
 If you don't want any mark at all, but still want logical items, use
@@ -6811,11 +6811,11 @@ list marked with dashes embedded in a list marked with 
bullets:
 
 @example
 @group
-@@itemize @@bullet
+@@itemize @@bullet@{@}
 @@item
 First item.
 
-@@itemize @@minus
+@@itemize @@minus@{@}
 @@item
 Inner item.
 
@@ -6833,11 +6833,11 @@ Second outer item.
 This produces:
 
 @quotation
-@itemize @bullet
+@itemize @bullet{}
 @item
 First item.
 
-@itemize @minus
+@itemize @minus{}
 @item
 Inner item.
 
@@ -9647,10 +9647,6 @@ Use the @code{@@bullet@{@}} command to generate a large 
round dot, or
 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.
@@ -10098,8 +10094,7 @@ glyph is also available independently via the command
 @findex clickstyle
 You can change the glyph produced by @code{@@click} with the command
 @code{@@clickstyle}, which takes a command name as its single argument
-on the rest of the line, much like @code{@@itemize} and friends
-(@pxref{@code{@@itemize}}).  The command should produce a glyph, and
+on the rest of the line.  The command should produce a glyph, and
 the usual empty braces @samp{@{@}} are omitted.  Here's an example:
 
 @example