[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 33/49: groff_mdoc(7): Fix markup nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 33/49: groff_mdoc(7): Fix markup nits. |
Date: |
Sun, 6 Nov 2022 00:37:22 -0400 (EDT) |
gbranden pushed a commit to branch master
in repository groff.
commit 3e7ec95b2b2136ed412a96435327aad6066de5ed
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 33/49: groff_mdoc(7): Fix markup nits.,
G. Branden Robinson <=