[groff] 02/27: eqn(1): Revise.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 58d68d27912801ffe4617155289e0442488ca531
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Sat Aug 26 10:59:42 2023 -0500

    eqn(1): Revise.
    
    * Drop paragraph separation from within-paragraph example.
    * Tune tagged paragraph indentations.
    * Set list of customizable parameters at a normal inset rather than
      tucking it all under the "set" primitive's description.
    * Recast.
---
 src/preproc/eqn/eqn.1.man | 54 ++++++++++++++++++++++++-----------------------
 1 file changed, 28 insertions(+), 26 deletions(-)

diff --git a/src/preproc/eqn/eqn.1.man b/src/preproc/eqn/eqn.1.man
index 29d3208b0..7bfca674c 100644
--- a/src/preproc/eqn/eqn.1.man
+++ b/src/preproc/eqn/eqn.1.man
@@ -1104,7 +1104,7 @@ Configure these parameters with the
 primitive.
 .
 .
-.TP
+.TP 9n \" "set p n" + 2n
 .BI set\~ "p n"
 assigns
 .RI parameter\~ p
@@ -1112,33 +1112,31 @@ the integer
 .RI value\~ n ;
 .IR n \~is
 interpreted in units of hundredths of an em unless otherwise stated.
-.
 For example,
 .
-.
 .RS
-.IP
+.RS
 .EX
 set x_height 45
 .EE
 .RE
 .
-.
-.IP
 says that
 .I @g@eqn
 should assume that the font's x-height is 0.45\~ems.
+.RE
 .
 .
-.RS
 .P
-Available parameters are as follows;
+Available parameters
+.I p
+are as follows;
 defaults are shown in parentheses.
 .
 We intend these descriptions to be expository rather than rigorous.
 .
 .
-.TP 17n
+.TP 24n \" "default_rule_thickness" + 2n
 .B minimum_size
 sets a floor for the type size
 (in scaled points)
@@ -1532,7 +1530,6 @@ and
 .B cp1047
 devices,
 .RB otherwise\~ 0 .
-.RE
 .
 .
 .\" ====================================================================
@@ -1749,7 +1746,7 @@ as the roman font.
 .
 .
 .br
-.ne 4v
+.ne 6v
 .\" ====================================================================
 .SH Options
 .\" ====================================================================
@@ -1865,24 +1862,28 @@ This option is deprecated.
 Prepare output for the device
 .IR dev .
 .
-In most cases,
-the effect of this is to define a macro
+This option
+defines a macro
 .I dev
-with a value
-.RB of\~ 1 ;
+with the
+.RB value\~ 1 ;
 .I eqnrc
-uses this to provide definitions appropriate for the device.
+thereby provides definitions appropriate to the device.
 .
 However,
-if the specified driver is \[lq]MathML\[rq],
-the output is MathML markup rather than
-.I @g@troff
-input,
+if
+.I dev
+is
+.RB \[lq] MathML \[rq],
+.I @g@eqn
+produces output in that language rather than
+.IR roff ,
 and
 .I eqnrc
-is not loaded at all.
+is not loaded.
+.\" XXX: why NOT load eqnrc?
 .
-The default output device is
+The default device is
 .BR @DEVICE@ .
 .
 .
@@ -2225,13 +2226,14 @@ above in greater detail.
 .
 .
 .P
-.MR groff_char @MAN7EXT@ ,
-particularly subsections \[lq]Logical symbols\[rq],
-\[lq]Mathematical symbols\[rq],
-and \[lq]Greek glyphs\[rq],
+.MR groff_char @MAN7EXT@
 documents a variety of special character escape sequences useful in
 mathematical typesetting.
 .
+See subsections \[lq]Logical symbols\[rq],
+\[lq]Mathematical symbols\[rq],
+and \[lq]Greek glyphs\[rq] in particular.
+.
 .
 .P
 .MR groff @MAN1EXT@ ,