gbranden pushed a commit to branch master
in repository groff.
commit 9ccb7b0e226bafc1591a6622766fef0f0cbad1ef
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Nov 8 11:44:18 2025 -0600
[doc,man]: Clarify page break procedure.
---
doc/groff.texi.in | 7 ++++---
man/roff.7.man | 7 ++++---
2 files changed, 8 insertions(+), 6 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index bd3986a48..da708b851 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6338,7 +6338,7 @@ Combining the foregoing facts results in an origin that
lies
at the page offset in the horizontal dimension
and at the text baseline (using the default vertical spacing)
in the vertical dimension.
-A document can change these prior to the first written or drawn output;
+A document can change these prior to its first written or drawn output;
see @ref{Line Layout} and
@ref{Manipulating Type Size and Vertical Spacing}.
@c This origin isn't necessarily--and generally is not--the one used by
@@ -6359,11 +6359,12 @@ to the next text baseline.
If the formatter were already writing
to the last line that fits on the page,
advancing by one vee would place the next text baseline off the page.
-Rather than let that happen,
+To avoid that,
@code{roff}
formatters instruct the output driver to eject the page,
start a new one,
-and again place the drawing position one vee below the page top;
+and again place the drawing position
+at the page offset one vee below the page top;
this is a
@dfn{page break}.
diff --git a/man/roff.7.man b/man/roff.7.man
index 9ab827f5d..cf80ed039 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -610,7 +610,7 @@ Combining the foregoing facts results in an origin that lies
at the page offset in the horizontal dimension
and at the text baseline (using the default vertical spacing)
in the vertical dimension.
-A document can change these prior to the first written or drawn output.
+A document can change these prior to its first written or drawn output.
.\" see @ref{Line Layout} and
.\" @ref{Manipulating Type Size and Vertical Spacing}.
.\" This origin isn't necessarily--and generally is not--the one used by
@@ -632,11 +632,12 @@ If the formatter were already writing
to the last line that fits on the page,
advancing by one vee would place the next text baseline off the page.
.
-Rather than let that happen,
+To avoid that,
.I roff
formatters instruct the output driver to eject the page,
start a new one,
-and again place the drawing position one vee below the page top;
+and again place the drawing position
+at the page offset one vee below the page top;
this is a
.I "page break."
.
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
