[groff] 03/17: [docs]: Clarify pathological case.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 008b5bfe2fc6ce0613e43822b838c4b26d05db06
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Tue Jan 16 10:11:53 2024 -0600

    [docs]: Clarify pathological case.
    
    Verify with the following input to groff and Heirloom Doctools troff.
    
    .\" Create, but do not emit, a couple of diversions without ever having
    .\" a partially collected line in the top-level diversion.
    .di a
    ONE
    .br
    .di
    .di b
    TWO
    .br
    .di
---
 doc/groff.texi       | 5 +++--
 man/groff_diff.7.man | 6 +++++-
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index bf46f9db8..6b449b571 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -17725,8 +17725,9 @@ Internals}.
 
 In the somewhat pathological case where a diversion exists containing a
 partially collected line and a partially collected line at the top-level
-diversion has never existed, @acronym{AT&T} @code{troff} will output the
-partially collected line at the end of input; GNU @code{troff} will not.
+diversion has never existed, @acronym{AT&T} @code{troff} will output a
+partially collected but otherwise empty line (as if @samp{\c} were in
+the top-level diversion) at the end of input; GNU @code{troff} will not.
 
 @codequotebacktick off
 @codequoteundirected off
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 5312175b0..4c91466c8 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -5796,7 +5796,11 @@ partially collected line and a partially collected line 
at the top-level
 diversion has never existed,
 AT&T
 .I troff
-will output the partially collected line at the end of input;
+will output a partially collected but otherwise empty line
+(as if
+.RB \[lq] \[rs]c \[rq]
+were in the top-level diversion)
+at the end of input;
 GNU
 .I troff \" GNU
 will not.