branch master updated: * doc/texinfo.texi (@group): Revise. Remove or comment out extraneous text. Be clear that it cannot be used in filled contexts as this actually produces an error with texinfo.tex. * NEWS: EPUB3 -> EPUB 3.

[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 b496f3d32c * doc/texinfo.texi (@group): Revise.  Remove or comment out 
extraneous text.  Be clear that it cannot be used in filled contexts as this 
actually produces an error with texinfo.tex. * NEWS: EPUB3 -> EPUB 3.
b496f3d32c is described below

commit b496f3d32c7c4dcd9f74384cfafaf7238872189d
Author: Gavin Smith <gavinsmith0123@gmail.com>
AuthorDate: Sun Aug 28 11:22:53 2022 +0100

    * doc/texinfo.texi (@group): Revise.  Remove or comment out
    extraneous text.  Be clear that it cannot be used in filled
    contexts as this actually produces an error with texinfo.tex.
    * NEWS: EPUB3 -> EPUB 3.
---
 ChangeLog        |  7 +++++++
 NEWS             |  2 +-
 doc/texinfo.texi | 59 +++++++++++++++++++++++++-------------------------------
 3 files changed, 34 insertions(+), 34 deletions(-)

diff --git a/ChangeLog b/ChangeLog
index 2021f1893d..6031f61140 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,10 @@
+2022-08-28  Gavin Smith  <gavinsmith0123@gmail.com>
+
+       * doc/texinfo.texi (@group): Revise.  Remove or comment out
+       extraneous text.  Be clear that it cannot be used in filled
+       contexts as this actually produces an error with texinfo.tex.
+       * NEWS: EPUB3 -> EPUB 3.
+
 2022-08-28  Gavin Smith  <gavinsmith0123@gmail.com>
 
        LaTeX list environment for indentation
diff --git a/NEWS b/NEWS
index 3a02816316..0efbb8027f 100644
--- a/NEWS
+++ b/NEWS
@@ -12,7 +12,7 @@ See the manual for detailed information.
 6.X
 * texi2any
  . LaTeX added as an output format, selected with --latex
- . EPUB3 added as an output format, selected with --epub3
+ . EPUB 3 added as an output format, selected with --epub3
  . reform throughout the code in general
  . thorough review of character encoding issues
  . new customization variables involved with character encoding:
diff --git a/doc/texinfo.texi b/doc/texinfo.texi
index 0ae87274da..f74d0324ad 100644
--- a/doc/texinfo.texi
+++ b/doc/texinfo.texi
@@ -11091,27 +11091,16 @@ page.
 @cindex Holding text together vertically
 @cindex Vertically holding text together
 
-The @code{@@group} command (on a line by itself) is used inside an
+The @code{@@group} command is used to hold an example
+together on one page.  Use it inside an
 @code{@@example} or similar construct to begin an unsplittable vertical
 group, which will appear entirely on one page in the printed output.
-The group is terminated by a line containing only @code{@@end group}.
-These two lines produce no output of their own, and have an effect in
-@TeX{} output only.
-
-@c Once said that these environments
-@c turn off vertical spacing between ``paragraphs''.
-@c Also, quotation used to work, but doesn't in texinfo-2.72
-Although @code{@@group} would make sense conceptually in a wide
-variety of contexts, its current implementation works reliably only
-within @code{@@example} and variants, and within @code{@@display},
-@code{@@format}, @code{@@flushleft} and @code{@@flushright}.
-@xref{Quotations and Examples}.  (What all these commands have in
-common is that each line of input produces a line of output.)  In
-other contexts, @code{@@group} can cause anomalous vertical
-spacing.
+Terminate the group by a line containing only @code{@@end group}.
+This command has an effect in @TeX{} output only.
 
 @need 750
-This formatting requirement means that you should write:
+The @code{@@group} and @code{@@end group} commands need to be inside the
+@code{@@example} and @code{@@end example} commands, thus:
 
 @example
 @group
@@ -11123,22 +11112,26 @@ This formatting requirement means that you should 
write:
 @end group
 @end example
 
-@noindent
-with the @code{@@group} and @code{@@end group} commands inside the
-@code{@@example} and @code{@@end example} commands.
-
-The @code{@@group} command is most often used to hold an example
-together on one page.  In this Texinfo manual, more than 100 examples
-contain text that is enclosed between @code{@@group} and @code{@@end
-group}.
-
-If you forget to end a group, you may get strange and unfathomable
-error messages when you run @TeX{}.  This is because @TeX{} keeps
-trying to put the rest of the Texinfo file onto the one page and does
-not start to generate error messages until it has processed
-considerable text.  It is a good rule of thumb to look for a missing
-@code{@@end group} if you get incomprehensible error messages in
-@TeX{}.
+Although @code{@@group} would make sense conceptually in a wide
+variety of contexts, its current implementation works only
+within @code{@@example} and variants, and within @code{@@display},
+@code{@@format}, @code{@@flushleft} and @code{@@flushright}.
+@xref{Quotations and Examples}.  (What all these commands have in
+common is that each line of input produces a line of output.)
+
+@c  In other contexts, @code{@@group} can cause anomalous vertical
+@c  spacing.
+
+@c commented out below because all TeX errors are strange and unfathomable,
+@c not just for @group
+
+@c If you forget to end a group, you may get strange and unfathomable
+@c error messages when you run @TeX{}.  This is because @TeX{} keeps
+@c trying to put the rest of the Texinfo file onto the one page and does
+@c not start to generate error messages until it has processed
+@c considerable text.  It is a good rule of thumb to look for a missing
+@c @code{@@end group} if you get incomprehensible error messages in
+@c @TeX{}.
 
 
 @node @code{@@need}