* Identify what script performed the generation. * Produce idiomatic English in list of interpolated "Caps" files, avoiding leading space surplusage and using commas between each item. * Explain the first-line comment in the generated *roff file straightforwardly. It is not helpful to use the term "magic cookie" here when it is (1) not idiomatic;[1] and (2) already has a different (and obscure) usage in terminal interfacing discourse. * Stop implying that no one will ever format the generated document with a typesetter.
[1] man-db's man(1) page does not use the term "cookie" (magic or
otherwise), and it occurs in the groff source tree only in the
"Changelog.old" file in casual reference to formatter internals
(specifically, special token types used by the input parser to cope
with `cf` and `trf` requests and scheduling ejection of the last
page of a formatted document).
---
man/MKterminfo.sh | 11 ++++++++---
1 file changed, 8 insertions(+), 3 deletions(-)
diff --git a/man/MKterminfo.sh b/man/MKterminfo.sh
index f66a4baa1..dd253c38e 100755
--- a/man/MKterminfo.sh
+++ b/man/MKterminfo.sh
@@ -53,19 +53,24 @@ if test "${LC_COLLATE+set}" = set; then LC_COLLATE=C;
export LC_COLLATE; fi
head="$1"
shift
caps=
+capstext=
while test $# -gt 1
do
caps="$caps $1"
+ capstext="$capstext, $1"
shift
done
tail="$1"
cat <<EOF
'\\" t
.\\" DO NOT EDIT THIS FILE BY HAND!
-.\\" It is generated from terminfo.head, $caps, and terminfo.tail.
+.\\" man/MKterminfo.sh generated it from:
+.\\" terminfo.head$capstext,
+.\\" and terminfo.tail.
.\\"
-.\\" Note: this must be run through tbl before nroff.
-.\\" The magic cookie on the first line triggers this under some man programs.
+.\\" Note: this document must be run through tbl before nroff or troff.
+.\\" Some man(1) programs recognize the token in the first-line comment
+.\\" as directing them to arrange such a pipeline.
EOF
cat "$head"
--
2.30.2
signature.asc
Description: PGP signature
