aboutsummaryrefslogtreecommitdiff
path: root/doc/testscript.cli
diff options
context:
space:
mode:
Diffstat (limited to 'doc/testscript.cli')
-rw-r--r--doc/testscript.cli24
1 files changed, 19 insertions, 5 deletions
diff --git a/doc/testscript.cli b/doc/testscript.cli
index ac4cda9..5929eea 100644
--- a/doc/testscript.cli
+++ b/doc/testscript.cli
@@ -1932,8 +1932,7 @@ in effect (in a sense, the \c{~} modifier is its introducer). Note that the
here-string regex naturally must always start with an introducer.
A char-regex line that starts with an introducer must also end with one
-optionally followed by \i{match flags}. Currently the only supported flag is
-\c{i} for case-insensitive match. For example:
+optionally followed by \i{match flags}, for example:
\
$* >>~/EOO/
@@ -1942,14 +1941,29 @@ $* >>~/EOO/
EOO
\
+The following match flag are recognized:
+
+\dl|
+
+\li|\n\c{i}
+
+ Perform case-insensitive match.|
+
+\li|\n\c{d}
+
+ Invert the dot character (\c{.}) escaping. With this flag unescaped dots
+ are treated as literal characters while the escaped ones (\c{\\.}) \-
+ as matching any character. Note that dots specified within character
+ classes (\c{[.]}) are not affected.||
+
Any character can act as a regex introducer. For here-strings it is the first
character in the string. For here-documents the introducer is specified as
part of the end marker. In this case the first character is the introducer,
everything after that and until the second occurrence of the introducer is the
actual end marker, and everything after that are global match flags. Global
-match flags apply to every char-regex (but not literal line) in this
-here-document. Note that there is no way to escape the introducer character
-inside the regex.
+match flags apply to every char-regex (but not literal lines or the line-regex
+itself) in this here-document. Note that there is no way to escape the
+introducer character inside the regex.
As an example, here is a shorter version of the previous example that also
uses a different introducer character.