mirror of https://github.com/texmacs/doc.git
90 lines
3.4 KiB
Tcl
90 lines
3.4 KiB
Tcl
<TeXmacs|1.0.3.10>
|
|
|
|
<style|tmdoc>
|
|
|
|
<\body>
|
|
<tmdoc-title|Page breaking primitives>
|
|
|
|
The physical lines in a document are broken into pages in a way similar to
|
|
how paragraphs are hyphenated into lines. The page breaker performs
|
|
<def-index|page filling>, it tries to distribute page items evenly so text
|
|
runs to the bottom of every page. It also tries to avoid <def-index|orphans
|
|
and widows>, which are single or pairs of soft lines separated from the
|
|
rest of their paragraph by a page break, but these can be produced when
|
|
there is no better solution.
|
|
|
|
<\explain>
|
|
<explain-macro|no-page-break><explain-synopsis|prevent automatic page
|
|
breaking after this line>
|
|
<|explain>
|
|
Prevent the occurrence of an automatic page break after the current line.
|
|
Set an infinite page breaking penalty for the current line, similarly to
|
|
<markup|no-break>.
|
|
|
|
Forbidden page breaking points are overridden by ``new page'' and ``page
|
|
break'' primitives.
|
|
</explain>
|
|
|
|
<\explain>
|
|
<explain-macro|no-page-break*><explain-synopsis|prevent automatic page
|
|
breaking before this line>
|
|
<|explain>
|
|
Similar to <markup|no-page-break>, but set the page breaking penalty of
|
|
the previous line.
|
|
</explain>
|
|
|
|
<\explain>
|
|
<explain-macro|new-page><explain-synopsis|start a new page after this
|
|
line>
|
|
<|explain>
|
|
Cause the next line to appear on a new page, without filling the current
|
|
page. The page breaker will not try to position the current line at the
|
|
bottom of the page.
|
|
</explain>
|
|
|
|
<\explain>
|
|
<explain-macro|new-page*><explain-synopsis|start a new page before this
|
|
line>
|
|
<|explain>
|
|
Similar to <markup|new-page>, but start the new page before the current
|
|
line. This directive is appropriate to use in chapter headings.
|
|
</explain>
|
|
|
|
<\explain>
|
|
<explain-macro|page-break><explain-synopsis|force a page break after this
|
|
line>
|
|
<|explain>
|
|
Force a page break after the current line. A forced page break is
|
|
different from a new page, the page breaker will try to position the
|
|
current line at the bottom of the page.
|
|
|
|
Use only to fine-tune the automatic page breaking. Ideally, this should
|
|
be a hint similar to <markup|line-break>, but this is implemented as a
|
|
directive, use only with extreme caution.
|
|
</explain>
|
|
|
|
<\explain>
|
|
<explain-macro|page-break*><explain-synopsis|force a page break before
|
|
this line>
|
|
<|explain>
|
|
Similar to <markup|page-break>, but force a page break before the current
|
|
line.
|
|
</explain>
|
|
|
|
When several ``new page'' and ``page break'' directives apply to the same
|
|
point in the document, only the first one is effective. Any
|
|
<markup|new-page> or <markup|page-break> after the first one in a line is
|
|
ignored. Any <markup|new-page> or <markup|page-break> in a line overrides
|
|
any <markup|new-page*> or <markup|page-break*> in the following line. Any
|
|
<markup|new-page*> or <markup|page-break*> after the first one in a line is
|
|
ignored.
|
|
|
|
<tmdoc-copyright|2004|David Allouche|Joris van der Hoeven>
|
|
|
|
<tmdoc-license|Permission is granted to copy, distribute and/or modify this
|
|
document under the terms of the GNU Free Documentation License, Version 1.1
|
|
or any later version published by the Free Software Foundation; with no
|
|
Invariant Sections, with no Front-Cover Texts, and with no Back-Cover
|
|
Texts. A copy of the license is included in the section entitled "GNU Free
|
|
Documentation License".>
|
|
</body> |