gbranden pushed a commit to branch master
in repository groff.
commit 714b49b9c489f179c6f92ebe9927b3ea746c5664
Author: G. Branden Robinson <[email protected]>
AuthorDate: Mon Aug 11 07:07:39 2025 -0500
doc/*,man/*: Clarify determination of page origin.
* doc/groff.texi.in (Page Geometry):
* man/roff.7.man (Page geometry): Clarify how the origin of the page's
coordinate system is determined in the *roff language.
Fixes <https://savannah.gnu.org/bugs/?67235>. Thanks to Dave Kemper for
the discussion.
---
ChangeLog | 9 +++++++++
doc/groff.texi.in | 16 ++++++++++++++++
man/roff.7.man | 15 +++++++++++++++
3 files changed, 40 insertions(+)
diff --git a/ChangeLog b/ChangeLog
index 0d7397c7d..d7b44b8bd 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,12 @@
+2025-08-11 G. Branden Robinson <[email protected]>
+
+ * doc/groff.texi.in (Page Geometry):
+ * man/roff.7.man (Page geometry): Clarify how the origin of the
+ page's coordinate system is determined in the *roff language.
+
+ Fixes <https://savannah.gnu.org/bugs/?67235>. Thanks to Dave
+ Kemper for the discussion.
+
2025-08-10 G. Branden Robinson <[email protected]>
* tmac/tests/an_paragraph-reset-restores-hyphenation-mode.sh:
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 224cdfe1d..3318cca81 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6308,6 +6308,22 @@ from which the formatter reckons the line indentation
and length.@footnote{@code{groff}'s
terminal output devices have page offsets of zero.}
+@cindex origin
+@cindex initial drawing position
+@cindex drawing position, initial
+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;
+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
+@c the device-independent output, but that coordinate system is not
+@c exposed in the *roff language, though it can be expressed in
+@c formatter instructions that construct device-independent output
+@c commands (`\!`, `\X`, `.output`, `.device`).
+
@cindex page break
@cindex break, page
@cindex page ejection
diff --git a/man/roff.7.man b/man/roff.7.man
index 608166cbb..710040364 100644
--- a/man/roff.7.man
+++ b/man/roff.7.man
@@ -610,6 +610,21 @@ terminal output devices have page offsets of zero.)
.
.
.P
+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.
+.\" 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
+.\" the device-independent output, but that coordinate system is not
+.\" exposed in the *roff language, though it can be expressed in
+.\" formatter instructions that construct device-independent output
+.\" commands (`\!`, `\X`, `.output`, `.device`).
+.
+.
+.P
Vertical spacing has an impact on page-breaking decisions.
.
Generally,
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
