[groff] 10/24: gropdf(1), grops(1): Update and sync § Typefaces.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 10af46bb8abd056eea9f952e1c128bec1591cf37
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Wed Aug 16 22:26:39 2023 -0500

    gropdf(1), grops(1): Update and sync § Typefaces.
    
    * Tighten and align discussions of typefaces.
    * Recast discussion of differences in special font handling.
    * Annotate a fact that the deri-gropdf-ng branch will make stale.
    * Favor `P` over `LP`.
    * Recast sentence fragments to eliminate dangling colons (and the ':-'
      bigram).
    * Update poor man's keeps.
---
 src/devices/gropdf/gropdf.1.man | 86 +++++++++++++++++++++++++++--------------
 src/devices/grops/grops.1.man   |  5 +--
 2 files changed, 60 insertions(+), 31 deletions(-)

diff --git a/src/devices/gropdf/gropdf.1.man b/src/devices/gropdf/gropdf.1.man
index bfebdd5ad..b54c6c2bc 100644
--- a/src/devices/gropdf/gropdf.1.man
+++ b/src/devices/gropdf/gropdf.1.man
@@ -430,7 +430,7 @@ The default stroke color and fill color is black.
 . SS Typefaces
 .\" ====================================================================
 .
-In the default setup there are styles called
+Styles called
 .BR R ,
 .BR I ,
 .BR B ,
@@ -438,7 +438,7 @@ and
 .B BI
 mounted at font positions 1 to\~4.
 .
-The fonts are grouped into families
+Text fonts are grouped into families
 .BR A ,
 .BR BM ,
 .BR C ,
@@ -446,9 +446,9 @@ The fonts are grouped into families
 .BR HN ,
 .BR N ,
 .BR P ,
-and\~\c
-.B T
-having members in each of these styles:
+.RB and\~ T ,
+each having members in each of these styles.
+.
 .
 .RS
 .TP
@@ -645,8 +645,10 @@ Times-BoldItalic
 .RE
 .
 .
-.LP
-There is also the following font which is not a member of a family:
+.br
+.ne 3v
+.P
+Another text font is not a member of a family.
 .
 .RS
 .TP
@@ -657,22 +659,47 @@ ZapfChancery-MediumItalic
 .RE
 .
 .
-.LP
-There are also some special fonts called
-.B S
-for the PS Symbol font.
+.P
+Special fonts include
+.BR S ,
+the PostScript Symbol font,
+and
+.BR EURO ,
+which offers a Euro glyph for use with old devices lacking it.
 .
-The lower case greek characters are automatically slanted (to match
-the SymbolSlanted font (SS) available to PostScript).
+.\" XXX: This is expected to change in groff 1.24.
+Lowercase Greek letters are automatically slanted to match the
+SymbolSlanted font
+.RB ( SS )
+available to
+.MR grops @MAN1EXT@ .
 .
 Zapf Dingbats is available as
-.BR ZD ;
+.BR ZD .
+.
+In contrast to
+.I grops ,
+.I gropdf
+does not require a reversed variant of it
+.RB ( ZDR );
 the \[lq]hand pointing left\[rq] glyph
 .RB ( \[rs][lh] )
-is available since it has been defined using the
+is available nevertheless,
+since it is defined using the
 .B \[rs]X\[aq]pdf: xrev\[aq]
-device control command,
-which reverses the direction of letters within words.
+device control command
+(see below).
+.
+Most glyphs in these fonts are unnamed and must be accessed using
+.BR \[rs]N .
+.
+.B EURO
+is not a standard PDF font,
+but supplied by
+.I groff
+and therefore included in the default
+.I download
+file.
 .
 .
 .\" ====================================================================
@@ -775,24 +802,27 @@ so you should not need to use
 to access most PDF functionality.
 .
 .
-.LP
+.br
+.ne 3v
+.P
 .I gropdf
 also supports a subset of the commands introduced in
+.IR gpresent 's
 .IR present.tmac .
 .
-Specifically it supports:-
 .
-.
-.IP
-PAUSE
-.br
-BLOCKS
-.br
-BLOCKE
+.RS
+.TP
+.B PAUSE
+.TQ
+.B BLOCKS
+.TQ
+.B BLOCKE
+.RE
 .
 .
-.LP
-Which allows you to create presentation type PDFs.
+.P
+These allow you to create presentation PDFs.
 .
 Many of the other
 commands are already available in other macro packages.
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 4ed8c97ea..1ca9a3d8f 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -626,7 +626,6 @@ some older printers.
 .SS Typefaces
 .\" ====================================================================
 .
-.P
 Styles called
 .BR R ,
 .BR I ,
@@ -843,7 +842,7 @@ Times-BoldItalic
 .
 .
 .br
-.ne 2v
+.ne 3v
 .P
 Another text font is not a member of a family.
 .
@@ -871,7 +870,7 @@ Symbol;
 which offers a Euro glyph for use with old devices lacking it;
 and
 .BR ZDR ,
-a reversed version of ZapfDingbats
+a reversed version of Zapf Dingbats
 (with symbols flipped about the vertical axis).
 .
 Most glyphs in these fonts are unnamed and must be accessed using