From 386c0bcda597914671dfeb4e1391f41e71465e91 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Mon, 9 Mar 2020 12:02:24 +0200 Subject: Document UTF-8 encoding for buildfiles and testscripts --- doc/manual.cli | 5 ++++- doc/testscript.cli | 4 ++++ 2 files changed, 8 insertions(+), 1 deletion(-) (limited to 'doc') 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} -- cgit v1.1