gbranden pushed a commit to branch master
in repository groff.
commit a7c956ec1bbeaccd9a9663605950dad80bc3940a
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Aug 22 13:16:23 2026 -0500
doc/groff.texi.in: Revise `po` request desc.
* When presenting multiple requests or requests stacked with other
syntax items, more scrupulously name the item we're discussing first.
Here, the `po` _request_ configures the page offset. The `.o`
register does not. It's worthwhile to distinguish query from update.
* Break CSTR #54 erratum into its own paragraph; it's of interest mainly
to researchers and people who enjoy having arguments about the
correctness of Ossana/Kernighan troff's behavior or its documentation.
---
doc/groff.texi.in | 7 +++++--
1 file changed, 5 insertions(+), 2 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index fa0e8143c..fa1568e16 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -12381,12 +12381,14 @@ page margins.@footnote{@xref{Output Line Annotation}.}
@DefreqItem {po, @t{-}@Var{offset}}
@DefregListEndx {.o}
@pindex tty.tmac
-Set page offset to
+The
+@code{po}
+request sets the page offset to
@var{offset};
if
@var{offset}
is signed,
-adjust the page offset by its value.
+it adjusts the page offset by its value.
The default scaling unit is
@samp{m}.
The default offset is
@@ -12402,6 +12404,7 @@ and zero if there is none.
Read-only register
@samp{.o}
interpolates the page offset.
+
@cindex CSTR@tie{}#54 errata
@cindex CSTR@tie{}#54 erratum, @code{po} request
This request is incorrectly documented in the @acronym{AT&T}
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
