[groff] 10/24: groff_mdoc(7): Fix style nits.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 218567749d5bc02b9cd6978c29a61101d1a35e3f
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Aug 22 23:04:25 2023 -0500

    groff_mdoc(7): Fix style nits.
    
    * Use active voice more.
    * Annotate source of truth for default widths used by macros.
    * Apply poor man's keep.
---
 tmac/groff_mdoc.7.man | 20 ++++++++++----------
 1 file changed, 10 insertions(+), 10 deletions(-)

diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man
index b9c6e3002..48c928480 100644
--- a/tmac/groff_mdoc.7.man
+++ b/tmac/groff_mdoc.7.man
@@ -354,10 +354,9 @@ precede it with the dummy character.
 .
 .Pp
 In this document,
-macros whose argument lists are parsed for callable arguments are
-referred to as
-.Em parsed ,
-and those that may be called from an argument list are referred to as
+a macro that parses its argument list for other macro names is termed
+.Em parsed ;
+macros that permit other macros to call them thus are described as
 .Em callable .
 .
 This usage is a technical
@@ -568,12 +567,10 @@ to format it.
 .\" That's NOT a groffism, but showed up in the "post" and "Latin1"
 .\" devices of Documenter's Workbench (DWB) 3.3 troff.
 .
-Further,
-this glyph should not be used for conventional quotation;
-.Xr mdoc
-offers several quotation macros.
-.
-See subsection
+Avoid using
+.Ql \[rs](dq
+for conventional quotation;
+see subsection
 .Sx "Enclosure and quoting macros"
 below.
 .
@@ -823,6 +820,7 @@ literal.
 .
 .Pp
 Many macros possess an implicit width,
+.\" See tmac/mdoc/doc-common for values.
 used when they are contained in lists and displays.
 .
 If you avoid relying on these default measurements,
@@ -2566,6 +2564,8 @@ X/Open
 .El
 .Pp
 .
+.br
+.ne 4v
 Miscellaneous
 .Pp
 .Bl -tag -width ".Li \-p1003.1g\-2000" -compact -offset indent