[groff] 15/18: grodvi(1): Add "Device control commands" subsect.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit e29ecb01773025f71b4dda1c2647bed69e479fc1
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jul 25 01:12:07 2023 -0500

    grodvi(1): Add "Device control commands" subsect.
    
    Expand.  Note availability of `device` request.
---
 src/devices/grodvi/grodvi.1.man | 85 ++++++++++++++++++++++++++++++-----------
 1 file changed, 62 insertions(+), 23 deletions(-)

diff --git a/src/devices/grodvi/grodvi.1.man b/src/devices/grodvi/grodvi.1.man
index 05cbe0d40..b9f991a32 100644
--- a/src/devices/grodvi/grodvi.1.man
+++ b/src/devices/grodvi/grodvi.1.man
@@ -187,29 +187,7 @@ By design,
 the DVI format doesn't care about the physical dimensions of the output
 medium.
 .
-Instead,
-.I grodvi
-emits the equivalent to \*[tx]'s
-.BI \%\[rs]special{\:\%papersize= width , length }
-on the first page;
-.I dvips
-(or another DVI driver)
-then sets the page size accordingly.
-.
-If either the page width or length is not positive,
-no
-.B \%papersize
-special is output.
-.
-.
-.P
-A device control escape sequence
-.BI \[rs]X\[aq] anything \[aq]
-is translated to the same DVI file instructions as would be produced by
-.BI \%\[rs]special{ anything }
-in \*[tx];
-.I anything
-cannot contain a newline.
+See subsection \[lq]Device control commands\[rq] below.
 .
 .
 .\" ====================================================================
@@ -374,6 +352,67 @@ not set up the codes necessary for automatic hyphenation.
 .
 .
 .\" ====================================================================
+. SS "Device control commands"
+.\" ====================================================================
+.
+.I grodvi
+emits the equivalent to \*[tx]'s
+.BI \%\[rs]special{\:\%papersize= width , length }
+on the first page;
+.I dvips
+(or another DVI driver)
+then sets the page size accordingly.
+.
+If either the page width or length is not positive,
+no
+.B \%papersize
+special is output.
+.
+.
+.P
+.I grodvi
+supports one device control function,
+accessed with the
+.I groff
+request
+.B device
+or
+.I roff
+.B \[rs]X
+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.
+.
+See
+.MR groff_font @MAN5EXT@ .
+.
+You can thus alter the page size at will within the DVI file created by
+.IR grodvi .
+.
+Changes to the paper format should occur prior to the first page,
+or during page ejection before starting a subsequent one.
+.
+.
+.P
+The parameter(s) to
+.B device
+and
+.B \[rs]X
+are translated to the same DVI file instructions as would be produced by
+.BI \%\[rs]special{ anything }
+in \*[tx];
+.I anything
+cannot contain a newline.
+.
+.
+.\" ====================================================================
 .SS "Font description files"
 .\" ====================================================================
 .