gbranden pushed a commit to branch master
in repository groff.
commit be5d804b47ec2d571aade9a92f97b1a5cec2528c
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri Mar 27 20:14:47 2026 -0500
doc/groff.texi.in: Tweak GNU troff introduction.
* Mark up "body" with Texinfo `dfn` command when introducing the concept
of a macro definition.
* Add concept index entries for the term.
* Break Texinfo input lines in a roff-friendly way.
---
doc/groff.texi.in | 36 +++++++++++++++++++++++++++---------
1 file changed, 27 insertions(+), 9 deletions(-)
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 4cb60d819..d02b857e1 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -6385,16 +6385,34 @@ Insert tedious liability disclaimer paragraph here.
@result{} Approved: 2020-10-05 by D. Kruger, J. Peterman
@endExample
+@cindex body, of a macro
+@cindex macro body
@noindent
-The above document started with a series of control lines. Three macros
-were defined, with a @code{de} request declaring each macro's name, and
-the ``body'' of the macro starting on the next line and continuing until
-a line with two dots @samp{@code{..}} marked its end. The text proper
-began only after the macros were defined; this is a common pattern.
-Only the @code{NOTICE} macro was called ``directly'' by the document;
-@code{DATE} and @code{BOSS} were called only by @code{NOTICE} itself.
-Escape sequences were used in @code{BOSS}, two levels of macro
-interpolation deep.
+The above document started with a series of control lines.
+Three macros were defined,
+with a
+@code{de}
+request declaring each macro's name,
+and the
+@dfn{body}
+of the macro starting on the next line
+and continuing until a line with two dots
+@samp{@code{..}}
+marked its end.
+The text proper began only after the macros were defined;
+this is a common pattern.
+Only the
+@code{NOTICE}
+macro was called ``directly'' by the document;
+@code{DATE}
+and
+@code{BOSS}
+were called only by
+@code{NOTICE}
+itself.
+Escape sequences were used in
+@code{BOSS},
+two levels of macro interpolation deep.
The advantage in typing and maintenance economy may not be obvious from
such a short example, but imagine a much longer document with dozens of
_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit
