gbranden pushed a commit to branch master
in repository groff.
commit 3e7ec95b2b2136ed412a96435327aad6066de5ed
Author: G. Branden Robinson <[email protected]>
AuthorDate: Thu Nov 3 10:23:09 2022 -0500
groff_mdoc(7): Fix markup nits.
* Add empty requests between sentences.
* Break input lines after commas.
* Set multi-word parentheticals on their own input lines.
* Drop empty request after (sub)sectioning macro calls.
---
tmac/groff_mdoc.7.man | 18 ++++++++++++++----
1 file changed, 14 insertions(+), 4 deletions(-)
diff --git a/tmac/groff_mdoc.7.man b/tmac/groff_mdoc.7.man
index c1f1e0808..c611c62ad 100644
--- a/tmac/groff_mdoc.7.man
+++ b/tmac/groff_mdoc.7.man
@@ -640,10 +640,12 @@ of which
and
.Em Description
are mandatory.
+.
The headers are discussed in
.Sx "Page structure domain" ,
after presentation of
.Sx "Manual domain" .
+.
Several content macros are used to demonstrate page layout macros; reading
about content macros before page layout macros is recommended.
.
@@ -1610,7 +1612,10 @@ For interactive command flags that are not prepended
with a dash,
the
.Ql .Cm
(command modifier)
-macro is identical, but without the dash.
+macro is identical,
+but without the dash.
+.
+.
.Pp
.Dl Usage: .Fl Ao argument Ac ...
.Pp
@@ -1736,8 +1741,12 @@ conventions.
Note that any call to another macro signals the end of the
.Ql .Fn
call (it will insert a closing parenthesis at that point).
+.
+.
.Pp
-For functions with many parameters (which is rare), the macros
+For functions with many parameters
+(which is rare),
+the macros
.Ql .Fo
(function open)
and
@@ -2171,11 +2180,12 @@ The default width is 10n.
.
.
.Ss Options
-.
The
.Ql .Op
macro places option brackets around any remaining arguments on the
-command line, and places any trailing punctuation outside the brackets.
+command line,
+and places any trailing punctuation outside the brackets.
+.
The macros
.Ql .Oo
and
_______________________________________________
Groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
