gbranden pushed a commit to branch master
in repository groff.
commit 5ce2bcf0e7c38d3d3dcd6ef06eb182b4ad9a9786
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Apr 14 09:44:03 2025 -0500
[doc],roff(7): Clarify "page offset" meaning.
---
doc/groff.texi.in | 14 ++++++++++----
man/roff.7.man | 9 ++++++---
2 files changed, 16 insertions(+), 7 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index df5b6934c..98fac4d90 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -5998,10 +5998,16 @@ glyph from lying partially or wholly off the page.
@cindex page offset
@cindex offset, page
-Further, it is conventional not to write or draw at the extreme edges of
-the page. Typesetters configure a @dfn{page offset}, a rightward shift
-from the left edge.@footnote{@code{groff}'s terminal output devices have
-page offsets of zero.}
+Further,
+it is conventional not to write or draw
+at the extreme edges of the page.
+Typesetters configure a
+@dfn{page offset},
+a rightward shift from the left edge
+that defines the zero point
+from which the formatter reckons the line indentation
+and length.@footnote{@code{groff}'s
+terminal output devices have page offsets of zero.}
@cindex page break
@cindex break, page
diff --git a/man/roff.7.man b/man/roff.7.man
index bd6204e06..afc58cce2 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -588,12 +588,15 @@ preventing a glyph from lying partially or wholly off the
page.
.
.P
Further,
-it is conventional not to write or draw at the extreme edges of the
-page.
+it is conventional not to write or draw
+at the extreme edges of the page.
.
Typesetters configure a
.I "page offset,"
-a rightward shift from the left edge.
+a rightward shift from the left edge
+that defines the zero point
+from which the formatter reckons the line indentation
+and length.
.
.RI ( groff 's
terminal output devices have page offsets of zero.)
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
