groff-commit
[Top][All Lists]
Advanced

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

[groff] 34/44: [doc,man]: Clarify and sync `.nop` meaning.


From: G. Branden Robinson
Subject: [groff] 34/44: [doc,man]: Clarify and sync `.nop` meaning.
Date: Tue, 3 Sep 2024 08:05:48 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 360207795bd0ada3581a1352a05e0eb6b6586915
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Sep 3 04:16:54 2024 -0500

    [doc,man]: Clarify and sync `.nop` meaning.
---
 doc/groff.texi.in    | 11 ++++++-----
 man/groff_diff.7.man |  5 +++--
 2 files changed, 9 insertions(+), 7 deletions(-)

diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index defa912f5..887c97506 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -13105,11 +13105,12 @@ tanker
 @endExample
 @endDefreq
 
-@Defreq {nop, anything}
-Interpret @var{anything} as if it were an input line.  This is similar
-to @samp{.if@tie{}1}.  @code{nop} is not really ``no operation''; its
-argument @emph{is} processed---unconditionally.  It can be used to cause
-text lines to share indentation with surrounding control lines.
+@Defreq {nop, [@Var{anything}]}
+Interpret @var{anything} as if it were an input line.  @code{nop}
+resembles @samp{.if 1}; it puts a break on the output if @code{anything}
+is empty.  Unlike @code{if}, it cannot govern conditional blocks.  Its
+application is to maintain consistent indentation within macro
+definitions even when formatting output.
 
 @Example
 .als real-MAC MAC
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 9f6406d91..dcd5ae914 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -3149,7 +3149,8 @@ does not exist.
 .
 .
 .TP
-.BI .nop \~anything
+.BR .nop \~[\c
+.IR anything ]
 Interpret
 .I anything
 as if it were an input line.
@@ -3166,7 +3167,7 @@ Unlike
 it cannot govern conditional blocks.
 .
 Its application is to maintain consistent indentation within macro
-definitions even when producing text lines.
+definitions even when formatting output.
 .
 .
 .TP



reply via email to

[Prev in Thread] Current Thread [Next in Thread]