[groff] 11/18: [docs]: Continue conceptual clean up around boxes.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit 48b5546ced1736a115c42860dca1ed432abed208
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Thu Jun 3 23:41:20 2021 +1000

    [docs]: Continue conceptual clean up around boxes.
    
    * doc/groff.texi:
    * man/groff.7.man:
    * man/groff_diff.7.man: Say "partially collected" instead of "partially
      filled", since partially collected lines can exist even when filling
      is disabled (see commit 3caa4dd0, 24 May).
---
 doc/groff.texi       |  2 +-
 man/groff.7.man      |  4 ++--
 man/groff_diff.7.man | 17 +++++++++++------
 3 files changed, 14 insertions(+), 9 deletions(-)

diff --git a/doc/groff.texi b/doc/groff.texi
index 3934ea7..da8e681 100644
--- a/doc/groff.texi
+++ b/doc/groff.texi
@@ -14028,7 +14028,7 @@ The following environment data are not copied:
 
 @itemize @bullet
 @item
-Partially filled lines.
+A partially collected line, if present.
 
 @item
 The status whether the previous line was interrupted.
diff --git a/man/groff.7.man b/man/groff.7.man
index e833f05..86ea3b7 100644
--- a/man/groff.7.man
+++ b/man/groff.7.man
@@ -1485,7 +1485,7 @@ Stop directing output to current box diversion.
 .REQ .box "name"
 Divert output to
 .IR name ,
-omitting a partially filled line.
+omitting a partially collected line.
 .
 .
 .TPx
@@ -1498,7 +1498,7 @@ Stop appending output to current box diversion.
 Divert output,
 appending it to
 .IR name ,
-omitting a partially filled line.
+omitting a partially collected line.
 .
 .
 .TPx
diff --git a/man/groff_diff.7.man b/man/groff_diff.7.man
index 54c81bc..2ef55c9 100644
--- a/man/groff_diff.7.man
+++ b/man/groff_diff.7.man
@@ -1166,17 +1166,22 @@ the default blank line behavior is (re-)established.
 .
 .
 .TP
-.BI .box\~ xx
+.BI .box\~ name
 .TQ
-.BI .boxa\~ xx
+.BI .boxa\~ name
 These requests are similar to the
 .B di
 and
 .B da
-requests with the exception that a partially filled line does not
-become part of the diversion (i.e., the diversion always starts with a
-new line) but is restored after ending the diversion, discarding the
-partially filled line which possibly comes from the diversion.
+requests,
+respectively,
+with the exception that any pending output line does not become part of
+the diversion
+(i.e.,
+the diversion always starts with a new line)
+but is restored after ending the diversion,
+discarding any partially collected line pending in the diversion.
+.
 .
 .TP
 .B .break