aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2020-03-09 12:02:24 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2020-03-09 12:02:24 +0200
commit386c0bcda597914671dfeb4e1391f41e71465e91 (patch)
treed76b6668721c5aaae0d9a49916e5355af499bbc3 /doc
parent3f8ef886b1e2b17d8ba12a74355ab7e09aec5ed6 (diff)
Document UTF-8 encoding for buildfiles and testscripts
Diffstat (limited to 'doc')
-rw-r--r--doc/manual.cli5
-rw-r--r--doc/testscript.cli4
2 files changed, 8 insertions, 1 deletions
diff --git a/doc/manual.cli b/doc/manual.cli
index 83abe86..5aea9c1 100644
--- a/doc/manual.cli
+++ b/doc/manual.cli
@@ -3157,7 +3157,10 @@ detail and with more precision.
Buildfile is primarily a declarative language with support for variables, pure
functions, repetition (\c{for}-loop), conditional inclusion/exclusion
-(\c{if-else}), and pattern matching (\c{switch}).
+(\c{if-else}), and pattern matching (\c{switch}). At the lexical level,
+\c{buildfiles} are UTF-8 encoded text restricted to the Unicode graphic
+characters, tabs (\c{\\t}), carriage returns (\c{\\r}), and line feeds
+(\c{\\n}).
Buildfile is a line-oriented language. That is, every construct ends at the
end of the line unless escaped with line continuation (trailing \c{\\}). For
diff --git a/doc/testscript.cli b/doc/testscript.cli
index 5d50472..d39893a 100644
--- a/doc/testscript.cli
+++ b/doc/testscript.cli
@@ -1082,6 +1082,10 @@ failures (due to unexpected output) to go undetected.
\h1#lexical|Lexical Structure|
+At the lexical level, testscripts are UTF-8 encoded text restricted to the
+Unicode graphic characters, tabs (\c{\\t}), carriage returns (\c{\\r}), and
+line feeds (\c{\\n}).
+
Testscript is a line-oriented language with a context-dependent lexical
structure. It \"borrows\" several building blocks (variable expansion,
function calls, and evaluation contexts; collectively called \i{expansions}