@group: Prevent Page Breaks
@group command (on a line by itself) is used inside an
@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
These two lines produce no output of their own, and in the Info file
output they have no effect at all.
@group would make sense conceptually in a wide
variety of contexts, its current implementation works reliably only
@example and variants, and within
See section Quotations and Examples. (What all these commands have in
common is that each line of input produces a line of output.) In
@group can cause anomalous vertical
This formatting requirement means that you should write:
@example @group ... @end group @end example
@end group commands inside the
@end example commands.
@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
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
@end group if you get incomprehensible error messages in
Go to the first, previous, next, last section, table of contents.