[groff] 10/12: grohtml(1), grops(1), grotty(1): Tweak typography.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 118f80e41566ef0c79e599c58f7c254d0228a70c
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Dec 5 06:37:03 2024 -0600

    grohtml(1), grops(1), grotty(1): Tweak typography.
    
    Tighten wording, unstrand lines, and so on.
---
 src/devices/grohtml/grohtml.1.man |  4 +++-
 src/devices/grops/grops.1.man     | 40 ++++++++++++++++++---------------------
 src/devices/grotty/grotty.1.man   |  2 ++
 3 files changed, 23 insertions(+), 23 deletions(-)

diff --git a/src/devices/grohtml/grohtml.1.man 
b/src/devices/grohtml/grohtml.1.man
index e741c1aa9..6123762db 100644
--- a/src/devices/grohtml/grohtml.1.man
+++ b/src/devices/grohtml/grohtml.1.man
@@ -98,7 +98,7 @@ output driver for HTML
 .IR font-directory ]
 .RB [ \-j
 .IR output-stem ]
-.RB [ \-k
+.RB [ \-k\~\c
 .IR encoding ]
 .RB [ \-s
 .IR base-point-size ]
@@ -543,6 +543,8 @@ named
 .IR output-stem\- n .html .
 .
 .
+.br
+.ne 4v
 .TP
 .BI \-k \~encoding
 Select the character encoding used in the generated document,
diff --git a/src/devices/grops/grops.1.man b/src/devices/grops/grops.1.man
index 5b3a2cbf2..8fbde82c1 100644
--- a/src/devices/grops/grops.1.man
+++ b/src/devices/grops/grops.1.man
@@ -1050,6 +1050,8 @@ basic units which are in turn converted to PostScript 
units with the
 procedure.
 .
 .
+.br
+.ne 3v
 .P
 .I grops
 wraps user-specified PostScript code into a dictionary,
@@ -1238,8 +1240,7 @@ For example,
 is not able to display a proper
 .B \[rs][em]
 character because the standard X11 fonts do not provide it;
-this problem can be overcome by executing the following
-request
+this problem can be overcome with the following request.
 .
 .
 .IP
@@ -1272,6 +1273,8 @@ is previewed with
 .RE
 .
 .
+.br
+.ne 3v
 .P
 If a PostScript procedure
 .B BPhook
@@ -1287,11 +1290,9 @@ it is executed at the beginning of every page
 For example,
 to underlay the page contents with the word \[lq]DRAFT\[rq] in light
 gray,
-you might use
-.
+you might use the following.
 .
 .RS
-.P
 .EX
 \&.de XX
 ps: def
@@ -1313,7 +1314,7 @@ Or,
 to cause lines and polygons to be drawn with square linecaps and mitered
 linejoins instead of the round linecaps and linejoins normally used by
 .IR grops ,
-use
+use the following.
 .
 .RS
 .EX
@@ -1325,11 +1326,11 @@ ps: def
 .EE
 .RE
 .
-(square linecaps,
+(Square linecaps,
 as opposed to butt linecaps
 .RB (\[lq] "0 setlinecap" \[rq]),
 give true corners in boxed tables even though the lines are drawn
-unconnected).
+unconnected.)
 .
 .
 .\" ====================================================================
@@ -1370,9 +1371,9 @@ to
 .SS "TrueType and other font formats"
 .\" ====================================================================
 .
-TrueType fonts can be used with
-.I grops
-if converted first to Type\~42 format,
+To use TrueType fonts with
+.IR grops ,
+convert them first to Type\~42 format,
 a PostScript wrapper equivalent to the PFA format described in
 .MR pfbtops @MAN1EXT@ .
 .
@@ -1383,18 +1384,14 @@ Ghostscript\[em]see
 .
 .
 .P
-One approach is to use
 .UR https://fontforge.org/
 FontForge
-.UE ,
-a font editor that can convert most outline font formats.
+.UE
+converts most outline font formats.
 .
-Here's an example of using the Roboto Slab Serif font with
+Here's how we'd set up Roboto Slab Serif for use with
 .IR groff .
 .
-Several variables are used so that you can more easily adapt it into
-your own script.
-.
 .
 .RS 4
 .P
@@ -1421,9 +1418,9 @@ printf \[dq]$BASE\[rs]t$PFA\[rs]n\[dq] >> 
\[dq]$DIR/devps/download\[dq]
 .I fontforge
 and
 .I afmtodit
-may generate warnings depending on the attributes of the font.
+may produce warnings depending on font file attributes.
 .
-The test procedure is simple.
+Test the font as follows.
 .
 .
 .RS 4
@@ -1870,8 +1867,7 @@ PostScript printers do not natively support.
 creates temporary files using the template
 .RI \[lq] grops XXXXXX\[rq];
 see
-.MR groff @MAN1EXT@
-for details on their storage location.
+.MR groff @MAN1EXT@ .
 .
 .
 .\" ====================================================================
diff --git a/src/devices/grotty/grotty.1.man b/src/devices/grotty/grotty.1.man
index 5654a8070..eb043d193 100644
--- a/src/devices/grotty/grotty.1.man
+++ b/src/devices/grotty/grotty.1.man
@@ -795,6 +795,8 @@ rendered with
 produces the following output.
 .
 .
+.br
+.ne 5v
 .P
 .RS
 .EX