[groff] 16/18: gropdf(1): Fix structural and style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 849f969cf6980ec430d1e55934626b3f7902fb62
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jul 25 01:28:11 2023 -0500

    gropdf(1): Fix structural and style nits.
    
    * Add "Typefaces" and "Device control commands" subsections for parity
      with our other output driver man pages.  Reorganize material within
      them appropriately.
    * Recast to reinforce distinction between stroke color and fill color as
      configurable parameters even if their defaults are the same.
    * Note availability of `device` request.
    * Use active voice more.
    * Clarify when paper format changes can be done (a document author might
      not be sure when "before you start creating the page" is).
---
 src/devices/gropdf/gropdf.1.man | 46 ++++++++++++++++++++++++++---------------
 1 file changed, 29 insertions(+), 17 deletions(-)

diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index eef9f0b31..503518719 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -422,7 +422,14 @@ This default uses the same fonts as
 uses when it embeds fonts in a PDF file.
 .
 .
-.LP
+.P
+The default stroke color and fill color is black.
+.
+.
+.\" ====================================================================
+. SS Typefaces
+.\" ====================================================================
+.
 In the default setup there are styles called
 .BR R ,
 .BR I ,
@@ -668,17 +675,24 @@ device control command,
 which reverses the direction of letters within words.
 .
 .
-.LP
-The default color for
-.B \[rs]m
-and
-.B \[rs]M
-is black.
-.
+.\" ====================================================================
+. SS "Device control commands"
+.\" ====================================================================
 .
-.LP
 .I gropdf
-understands some of the device control commands supported by
+supports many device control functions,
+accessed with the
+.I groff
+request
+.B device
+or
+.I roff
+.B \[rs]X
+escape sequence.
+.
+First,
+it
+understands many of the device control commands supported by
 .MR grops 1 .
 .
 .
@@ -846,9 +860,8 @@ tags are silently ignored.
 .
 .
 .LP
-One
-.B \[rs]X
-device control command used by the DVI driver is also recognised.
+.I gropdf
+also recognizes a device control command used by the DVI driver.
 .
 .
 .TP
@@ -862,12 +875,11 @@ directive.
 See
 .MR groff_font @MAN5EXT@ .
 .
-This means that you can alter the page size at will within the PDF file
-being created by
+You can thus alter the page size at will within the PDF file created by
 .IR gropdf .
 .
-If you do want to change the paper format,
-it must be done before you start creating the page.
+Changes to the paper format should occur prior to the first page,
+or during page ejection before starting a subsequent one.
 .
 .
 .LP