[groff] 100/122: pdfroff(1): Lightly recast.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 15b5fb8aade8b1f90b324eec2d5c1132a49b899d
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Mon Nov 9 23:34:21 2020 +1100

    pdfroff(1): Lightly recast.
    
    * Say "identifier" intsead of ID.
    * (See also) Add our Texinfo manual.  I was a little puzzled by the
      reference to groff(1) as "the definitive reference to document
      formatting" with groff, since IMO that characterization covers a lot
      more than just driving the front end.  Recast in what I hope is a
      helpful direction.
---
 contrib/pdfmark/pdfroff.1.man | 22 +++++++++++++++-------
 1 file changed, 15 insertions(+), 7 deletions(-)

diff --git a/contrib/pdfmark/pdfroff.1.man b/contrib/pdfmark/pdfroff.1.man
index 5e9a8bb..68be499 100644
--- a/contrib/pdfmark/pdfroff.1.man
+++ b/contrib/pdfmark/pdfroff.1.man
@@ -678,7 +678,8 @@ are named according to the convention
 .IR pdf $$ . *,
 where
 .I $$
-is the standard shell variable representing the process ID of the
+is the standard shell variable representing the process identifier of
+the
 .I pdfroff
 process itself, and
 .I *
@@ -785,18 +786,25 @@ Keith Marshall
 .SH "See also"
 .\" ====================================================================
 .
-See
-.IR groff (@MAN1EXT@) \" XXX 7?
-for the definitive reference to document formatting with
-.IR groff .
+.IR "Groff: The GNU Implementation of troff" ,
+by Trent A.\& Fisher and Werner Lemberg,
+is the primary
+.I groff
+manual.
+.
+You can browse it interactively with \[lq]info groff\[rq].
 .
+.
+.P
 Since
 .I pdfroff
 provides a superset of all
 .I groff
 capabilities,
-.IR groff (@MAN1EXT@)
-may also be considered to be the definitive reference to all
+the above manual,
+or its terser reference page,
+.IR groff (@MAN7EXT@)
+may also be considered definitive references to all
 .I standard
 capabilities of
 .IR pdfroff ,