aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/testscript.cli6
1 files changed, 5 insertions, 1 deletions
diff --git a/doc/testscript.cli b/doc/testscript.cli
index 5cb4521..49e9d45 100644
--- a/doc/testscript.cli
+++ b/doc/testscript.cli
@@ -1170,7 +1170,7 @@ token is an unquoted word, then the second token of the line is examined in
the \c{second_token} mode (see below). If it is a variable assignment (either
\c{+=}, \c{=+}, or \c{=}), then the line type is a variable line. Otherwise,
it is a test command line. Note that variables with computed names can only
-be set using the \l{#builtins-set \c{set} builtin}.
+be set using the \l{#builtins-set \c{set} pseudo-builtin}.
The Testscript language defines the following distinct lexing modes (or
contexts):
@@ -2436,6 +2436,10 @@ set [-e|--exact] [(-n|--newline)|(-w|--whitespace)] [<attr>] <var>
Set variable from the \c{stdin} input.
+Note that \c{set} is a \i{pseudo-builtin}. In particular, it must be the last
+command in the pipe expression, it either succeeds or terminates abnormally,
+and its \c{stderr} cannot be redirected.
+
Unless the \c{-e|--exact} option is specified, a single final newline is
ignored in the input.