gbranden pushed a commit to branch master
in repository groff.
commit b4647d0ed4b6b73065839f0c8bcb1c67535f67fb
Author: G. Branden Robinson <[email protected]>
AuthorDate: Sat Jan 24 14:46:20 2026 -0600
[doc,man]: Update, resync "Paper format" stuff.
* Speak of "the formatter" generically instead of (g)troff, since all
device-independent troffs read "DESC" files.
* Report build configuration's `PAGE` parameter.
* Parallelize wording between our Texinfo manual and groff(1).
* Break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 27 ++++++++++++++++++++-------
src/roff/groff/groff.1.man | 9 +++++----
2 files changed, 25 insertions(+), 11 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index c97e456e9..6ba1e633e 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -1746,13 +1746,26 @@ be customized as part of the build-time configuration
process.
@cindex page orientation, landscape
@c BEGIN Keep parallel with groff(1), subsection "Paper format".
-A device's page dimensions in the aforementioned @file{DESC} are used if
-declared there. @code{groff}'s build process configures a default page
-format and writes it to typesetters' @file{DESC} files. This
-installation's default is documented in @cite{@g@troff@r{(1)}}. If the
-@file{DESC} file lacks this information, the formatter and output driver
-use a page length of @samp{11i} (eleven inches) for compatibility with
-@acronym{AT&T} @code{troff}.
+The formatter reads the device description file
+@file{DESC}
+for the selected output device when it starts;
+page dimensions declared there are used if present.
+
+@code{groff}'s @c system
+build process configures a default page format
+and writes it to typesetters'
+@file{DESC}
+files.
+This installation defaults to
+@samp{@PAGE@}. @c unscrew text editor syntax highlighting: }
+If the
+@file{DESC}
+file lacks this information,
+the formatter and output driver use a page length of
+@samp{11i}
+(eleven inches)
+for compatibility with @acronym{AT&T}
+@code{troff}.
In the formatter, the @code{pl} request changes the page length, but
macro packages often do not support alteration of the paper format
diff --git a/src/roff/groff/groff.1.man b/src/roff/groff/groff.1.man
index 7cad00b22..4d493f021 100644
--- a/src/roff/groff/groff.1.man
+++ b/src/roff/groff/groff.1.man
@@ -882,8 +882,7 @@ It is even.
.\" ====================================================================
.
.\" BEGIN Keep parallel with groff.texi node "Paper Format".
-.I @g@troff
-reads the device description file
+The formatter reads the device description file
.I DESC
for the selected output device when it starts;
page dimensions declared there are used if present.
@@ -900,8 +899,10 @@ This installation defaults to
If the
.I DESC
file lacks this information,
-the formatter and output driver use a page length of 11i (inches) for
-compatibility with AT&T
+the formatter and output driver use a page length of
+.BR \[lq] 11i \[rq]
+(eleven inches)
+for compatibility with AT&T
.IR troff . \" AT&T
.
See
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
