texinfo-doc-nonfree 4.13a-1 / usr / share / doc / texinfo / html / group.html

This file is indexed.

/usr/share/doc/texinfo/html/group.html is in texinfo-doc-nonfree 4.13a-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
<html lang="en">
<head>
<title>group - GNU Texinfo 4.13</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="GNU Texinfo 4.13">
<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="start" href="index.html#Top">
<link rel="up" href="Breaks.html#Breaks" title="Breaks">
<link rel="prev" href="page.html#page" title="page">
<link rel="next" href="need.html#need" title="need">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<!--
This manual is for GNU Texinfo (version 4.13, 18 September 2008),
a documentation system that can produce both online information and a
printed manual from a single source.

Copyright (C) 1988, 1990, 1991, 1992, 1993, 1995, 1996, 1997,
1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008
Free Software Foundation, Inc.

     Permission is granted to copy, distribute and/or modify this
     document under the terms of the GNU Free Documentation License,
     Version 1.2 or any later version published by the Free Software
     Foundation; with no Invariant Sections, with the Front-Cover Texts
     being ``A GNU Manual'', and with the Back-Cover Texts as in (a)
     below.  A copy of the license is included in the section entitled
     ``GNU Free Documentation License.''

     (a) The FSF's Back-Cover Text is: ``You are free to copy and modify
     this GNU Manual.  Buying copies from GNU Press supports the FSF in
     developing GNU and promoting software freedom.''
  -->
<meta http-equiv="Content-Style-Type" content="text/css">
<style type="text/css"><!--
  pre.display { font-family:inherit }
  pre.format  { font-family:inherit }
  pre.smalldisplay { font-family:inherit; font-size:smaller }
  pre.smallformat  { font-family:inherit; font-size:smaller }
  pre.smallexample { font-size:smaller }
  pre.smalllisp    { font-size:smaller }
  span.sc    { font-variant:small-caps }
  span.roman { font-family:serif; font-weight:normal; } 
  span.sansserif { font-family:sans-serif; font-weight:normal; } 
--></style>
</head>
<body>
<div class="node">
<a name="group"></a>
<p>
Next:&nbsp;<a rel="next" accesskey="n" href="need.html#need">need</a>,
Previous:&nbsp;<a rel="previous" accesskey="p" href="page.html#page">page</a>,
Up:&nbsp;<a rel="up" accesskey="u" href="Breaks.html#Breaks">Breaks</a>
<hr>
</div>

<!-- node-name,  next,  previous,  up -->
<h3 class="section">15.9 <code>@group</code>: Prevent Page Breaks</h3>

<p><a name="index-Group-_0028hold-text-together-vertically_0029-930"></a><a name="index-Holding-text-together-vertically-931"></a><a name="index-Vertically-holding-text-together-932"></a><a name="index-group-933"></a>
The <code>@group</code> command (on a line by itself) is used inside an
<code>@example</code> 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</code>. 
These two lines produce no output of their own, and in the Info file
output they have no effect at all.

<!-- Once said that these environments -->
<!-- turn off vertical spacing between ``paragraphs''. -->
<!-- Also, quotation used to work, but doesn't in texinfo-2.72 -->
  <p>Although <code>@group</code> would make sense conceptually in a wide
variety of contexts, its current implementation works reliably only
within <code>@example</code> and variants, and within <code>@display</code>,
<code>@format</code>, <code>@flushleft</code> and <code>@flushright</code>. 
See <a href="Quotations-and-Examples.html#Quotations-and-Examples">Quotations and Examples</a>.  (What all these commands have in
common is that each line of input produces a line of output.)  In
other contexts, <code>@group</code> can cause anomalous vertical
spacing.

  <p>This formatting requirement means that you should write:

<pre class="example">     @example
     @group
     ...
     @end group
     @end example
</pre>
  <p class="noindent">with the <code>@group</code> and <code>@end group</code> commands inside the
<code>@example</code> and <code>@end example</code> commands.

  <p>The <code>@group</code> 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</code> and <code>@end
group</code>.

  <p>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</code> if you get incomprehensible error messages in
TeX.

  </body></html>

APT Browse - Built by Thomas Orozco.