[groff] 05/45: [sboxes]: Slightly recast introductory article.

[G. Branden Robinson]

gbranden pushed a commit to branch master
in repository groff.

commit b8e9362bcd426942a20925ffae4ce21d852eb842
Author: G. Branden Robinson <g.branden.robinson@gmail.com>
AuthorDate: Fri Jan 14 10:01:21 2022 +1100

    [sboxes]: Slightly recast introductory article.
    
    * Vary the wording a bit.
    * Explicitly identify `cmd` argument as the "command".
    * Parallelize grammar of `weight` command with the others.
    * Distinguish the layers of convenience on offer.
    * More clearly explains what the garrulous footnote is for.
---
 contrib/sboxes/msboxes.ms.in | 11 +++++------
 contrib/sboxes/notquine.sed  |  6 +++---
 2 files changed, 8 insertions(+), 9 deletions(-)

diff --git a/contrib/sboxes/msboxes.ms.in b/contrib/sboxes/msboxes.ms.in
index 77e4eeec..e827fbdb 100644
--- a/contrib/sboxes/msboxes.ms.in
+++ b/contrib/sboxes/msboxes.ms.in
@@ -43,7 +43,7 @@ An extension in version 1.23.0 of
 the PDF output driver for the
 .I groff
 document formatting system,
-allows coloured rectangles to be created beneath any output created by
+allows coloured rectangles to be placed beneath any output created by
 .I groff .
 The extension can be accessed via a device control escape sequence
 .Lt "\[rs]X\[aq]pdf: background" \~.\|.\|.\|\c
@@ -67,7 +67,7 @@ cmd left top right bottom weight
 .LP
 each produce a background rectangle on the page, where
 .IP \f[I]cmd 8n \" indent enough to fit "bottom" tag
-can be any of
+is the command, which can be any of
 .Qq page|fill|box
 in combination.
 So
@@ -137,13 +137,12 @@ The top and bottom coordinates are only used if the box 
drawing extends
 onto the next page, so, ordinarily they would be set to the header and
 footer margins.
 .IP \f[I]weight
-If
+provides the line width for the border if
 .Qq box
-is included in the command, then this parameter provides the line width
-for the box border.
+is included in the command.
 .BOXSTOP
 .QE
-For a more convenient interface, include
+For an even more convenient interface, include
 .Lt \-msboxes
 on the
 .I groff
diff --git a/contrib/sboxes/notquine.sed b/contrib/sboxes/notquine.sed
index 6c591d02..be7dfd7a 100644
--- a/contrib/sboxes/notquine.sed
+++ b/contrib/sboxes/notquine.sed
@@ -9,9 +9,9 @@ s/'/\\[aq]/g
 s/^\./\\\&&/
 /@FOOTNOTE@/a\
 .FS\
-This is just a long footnote.\
-Its purpose is only to check that the bottom of the box on this page\
-has been adjusted because of the size of the footnote.\
+This is a long footnote occupying multiple output lines.\
+Its only purpose is to verify that the bottom of the box on this page\
+has been adjusted upwards to accommodate it.\
 .FE
 s/@FOOTNOTE@/\\m[red]\\**\\m[]/
 s/REPLACEME/(replaced by source of this document)/