gbranden pushed a commit to branch master
in repository groff.

commit 316c9da4a67b5ba404d9551902a7c7cbc88d9dc7
Author: G. Branden Robinson <[email protected]>
AuthorDate: Fri May 8 21:58:13 2026 -0500

    [ms]: Clarify intro to macro call syntax in docs.
    
    This new language is worded in the same order you type things, and
    importantly doesn't ignore the cases where macros take arguments.
---
 doc/groff.texi.in | 5 +++--
 doc/ms.ms.in      | 5 +++--
 2 files changed, 6 insertions(+), 4 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 25be568a8..cf0310761 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -3023,8 +3023,9 @@ macro early in the document to initialize the package.
 A
 @dfn{macro}
 is a formatting instruction to
-@file{ms}.
-Put a macro call on a line by itself with a dot before its name.
+@file{ms};
+to call it,
+start a line with a dot followed by its name.
 Use
 @samp{.PP}
 if you want your paragraph's first line indented,
diff --git a/doc/ms.ms.in b/doc/ms.ms.in
index c2cb1ec65..d0601f6a0 100644
--- a/doc/ms.ms.in
+++ b/doc/ms.ms.in
@@ -189,9 +189,10 @@ macro early in the document to initialize the package.
 A
 .I macro
 is a formatting instruction to
-.I ms.
+.I ms;
+to call it,
+start a line with a dot followed by its name.
 .
-Put a macro call on a line by itself with a dot before its name.
 .
 Use
 .CW PP

_______________________________________________
groff-commit mailing list
[email protected]
https://lists.gnu.org/mailman/listinfo/groff-commit

Reply via email to