[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[groff] 04/33: groff(7): Fix style and markup nits.
From: |
G. Branden Robinson |
Subject: |
[groff] 04/33: groff(7): Fix style and markup nits. |
Date: |
Sun, 29 Jan 2023 19:35:24 -0500 (EST) |
gbranden pushed a commit to branch master
in repository groff.
commit 0d08e27bb2d7584c97806349e282ce71258fad28
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jan 20 20:32:42 2023 -0600
groff(7): Fix style and markup nits.
* Tighten discussion of macro definition macros.
* Annotate material that parallels our Texinfo manual.
* Apply poor man's keeps.
Also add corresponding annotation to our Texinfo manual.
---
doc/groff.texi | 2 ++
man/groff.7.man | 15 ++++++++++++---
2 files changed, 14 insertions(+), 3 deletions(-)
diff --git a/doc/groff.texi b/doc/groff.texi
index 86da4deac..32708f65d 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -14211,6 +14211,7 @@ Environments save us considerable effort.
@c =====================================================================
+@c BEGIN Keep (roughly) parallel with subsection "Traps" of groff(7).
@node Traps, Diversions, Deferring Output, gtroff Reference
@section Traps
@cindex traps
@@ -14228,6 +14229,7 @@ Setting a trap is also called @dfn{planting} one.
@cindex trap, springing
@cindex springing a trap
It is said that a trap is @dfn{sprung} if its condition is fulfilled.
+@c END Keep (roughly) parallel with subsection "Traps" of groff(7).
@menu
* Vertical Position Traps::
diff --git a/man/groff.7.man b/man/groff.7.man
index d6475d231..b0ebcb142 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -6360,14 +6360,15 @@ and end inside another.
.P
Variants of
.B .de
-that disable compatibility mode and/or indirect the names of the macros
-being defined or ending the definition through strings are available as
+disable compatibility mode and/or indirect the names of the macros
+specified for definition or termination:
+these are
.BR .de1 ,
.BR .dei ,
and
.BR .dei1 .
.
-Existing macro definitions can be appended to with
+Append to macro definitions with
.BR .am ,
.BR .am1 ,
.BR .ami ,
@@ -6584,6 +6585,7 @@ use end macros.
.SH Traps
.\" ====================================================================
.
+.\" BEGIN Keep (roughly) parallel with groff.texi node "Traps".
.I Traps
are locations in the output,
or conditions on the input that,
@@ -6616,6 +6618,7 @@ one.
It is said that a trap is
.I sprung
if its condition is fulfilled.
+.\" END Keep (roughly) parallel with groff.texi node "Traps".
.
.
.P
@@ -6847,6 +6850,7 @@ use the following.
.EE
.RE
.
+.ne 2v
When using
.IR doclifter ,
it might be necessary to change syntax forms such as
@@ -7062,6 +7066,7 @@ G.\& Branden Robinson
.SH "See also"
.\" ====================================================================
.
+.ne 2v
.IR "Groff: The GNU Implementation of troff" ,
by Trent A.\& Fisher and Werner Lemberg,
is the primary
@@ -7071,6 +7076,8 @@ manual.
You can browse it interactively with \[lq]info groff\[rq].
.
.
+.br
+.ne 2v
.P
\[lq]Troff User's Manual\[rq]
by Joseph F.\& Ossanna,
@@ -7088,6 +7095,8 @@ documentation as
.RI \[lq]AT&T\~ troff \[rq].
.
.
+.br
+.ne 3v
.P
\[lq]A Typesetter-independent TROFF\[rq]
by Brian W.\& Kernighan,
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [groff] 04/33: groff(7): Fix style and markup nits.,
G. Branden Robinson <=