groff-commit
[Top][All Lists]
Advanced

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

[groff] 18/23: [doc,man]: Clarify description of `\c`.


From: G. Branden Robinson
Subject: [groff] 18/23: [doc,man]: Clarify description of `\c`.
Date: Thu, 3 Oct 2024 07:22:33 -0400 (EDT)

gbranden pushed a commit to branch master
in repository groff.

commit 77125e9118dd850dd8ee9c6a5b986d490ae24ba8
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Oct 3 01:33:04 2024 -0500

    [doc,man]: Clarify description of `\c`.
    
    Thanks to Tadziu Hoffman for prompting me to review it.
    
    https://lists.gnu.org/archive/html/groff/2024-10/msg00001.html
---
 ANNOUNCE          |  1 +
 doc/groff.texi.in | 17 +++++++++--------
 man/groff.7.man   |  3 ++-
 3 files changed, 12 insertions(+), 9 deletions(-)

diff --git a/ANNOUNCE b/ANNOUNCE
index 74a5e44aa..b5a35fd1d 100644
--- a/ANNOUNCE
+++ b/ANNOUNCE
@@ -193,6 +193,7 @@ Phil Chadwick
 Pim
 Ralph Corderoy
 Sven Schober
+Tadziu Hoffman
 Thorsten Glaser
 Thérèse Godefroy
 Walter Alejandro Iglesias
diff --git a/doc/groff.texi.in b/doc/groff.texi.in
index 9c859da6f..6288d47be 100644
--- a/doc/groff.texi.in
+++ b/doc/groff.texi.in
@@ -10062,14 +10062,15 @@ flushing out the pending output line in the usual way.
 
 @cindex interrupted line register (@code{.int})
 @cindex continued output line register (@code{.int})
-The @code{.int} register contains a positive value if the most recently
-formatted text was continued with @code{\c}; this datum is associated
-with the environment (@pxref{Environments}).@footnote{Historically, the
-@code{\c} escape sequence has proven challenging to characterize.  Some
-sources say it ``connects the next input text'' (to the input line on
-which it appears); others describe it as ``interrupting'' text, on the
-grounds that a text line is interrupted without breaking, perhaps to
-inject a request invocation or macro call.}
+The @code{.int} register interpolates a positive value only if the
+pending output line has been continued with @code{\c}; this datum is
+associated with the environment
+(@pxref{Environments}).@footnote{Historically, the @code{\c} escape
+sequence has proven challenging to characterize.  Some sources say it
+``connects the next input text'' (to the input line on which it
+appears); others describe it as ``interrupting'' text, on the grounds
+that a text line is interrupted without breaking, perhaps to inject a
+request invocation or macro call.}
 @endDefesc
 
 
diff --git a/man/groff.7.man b/man/groff.7.man
index c425d216b..47dfbe2df 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -665,7 +665,8 @@ flushing out the pending output line in the usual way.
 .
 The
 .register .int
-contains a positive value if the last output line was continued with
+interpolates a positive value only if the pending output line has been
+continued with
 .esc c ;
 this datum is associated with the
 environment.



reply via email to

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