[groff] 17/17: grodvi(1), gropdf(1): Correct error.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 3d0b4e60a6ba31dd5bad6d99950f7fe7e4b14dde
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Aug 9 15:34:33 2023 -0500

    grodvi(1), gropdf(1): Correct error.
    
    Fix erroneous description of `papersize` device control command.
    
    Also document the units it uses.
    
    Thanks to Alexis for the report in
    <https://lists.gnu.org/archive/html/groff/2023-08/msg00020.html>.
---
 src/devices/grodvi/grodvi.1.man | 32 ++++++++++++++++++++------------
 src/devices/gropdf/gropdf.1.man | 32 ++++++++++++++++++++------------
 2 files changed, 40 insertions(+), 24 deletions(-)

diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index b9f991a32..1aa31bb48 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -383,23 +383,31 @@ escape sequence.
 .
 .
 .TP
-.BI \[rs]X\[aq]papersize= paper-format \[aq]
-where the
-.I paper-format
-parameter is the same as that to the
-.B papersize
-directive.
+.BI \[rs]X\[aq]papersize= width , length \[aq]
+Set the page dimensions in centimeters to
+.I width
+by
+.I length.
 .
-See
-.MR groff_font @MAN5EXT@ .
-.
-You can thus alter the page size at will within the DVI file created by
-.IR grodvi .
+If the
+.B \-l
+option was specified,
+these dimensions are swapped.
 .
-Changes to the paper format should occur prior to the first page,
+Changes to the paper dimensions should occur prior to the first page,
 or during page ejection before starting a subsequent one.
 .
 .
+.IP
+.I Caution:
+the ordering of dimensions differs from that used by
+.I paper.tmac
+and
+.MR @g@troff @MAN1EXT@ 's
+.RB \[lq] "\-d paper" \[rq]
+option.
+.
+.
 .P
 The parameter(s) to
 .B device
diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index 503518719..6b1c3a030 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -865,23 +865,31 @@ also recognizes a device control command used by the DVI 
driver.
 .
 .
 .TP
-.BI \[rs]X\[aq]papersize= paper-format \[aq]
-where the
-.I paper-format
-parameter is the same as that to the
-.B papersize
-directive.
-.
-See
-.MR groff_font @MAN5EXT@ .
+.BI \[rs]X\[aq]papersize= width , length \[aq]
+Set the page dimensions in centimeters to
+.I width
+by
+.I length.
 .
-You can thus alter the page size at will within the PDF file created by
-.IR gropdf .
+If the
+.B \-l
+option was specified,
+these dimensions are swapped.
 .
-Changes to the paper format should occur prior to the first page,
+Changes to the paper dimensions should occur prior to the first page,
 or during page ejection before starting a subsequent one.
 .
 .
+.IP
+.I Caution:
+the ordering of dimensions differs from that used by
+.I paper.tmac
+and
+.MR @g@troff @MAN1EXT@ 's
+.RB \[lq] "\-d paper" \[rq]
+option.
+.
+.
 .LP
 .I gropdf
 supports several more device control features using the