Add comments to all regex test files

Author: kotfu

tests/test_transcript.py

@@ -274,7 +274,6 @@ def test_invalid_syntax(_cmdline_app, capsys):
     ('multiline_regex.txt', False),
     ('regex_set.txt', False),
     ('singleslash.txt', False),
-    ('slashdot.txt', False),
     ('slashes_escaped.txt', False),
     ('slashslash.txt', False),
     ('spaces.txt', False),

tests/transcripts/bol_eol.txt

@@ -1,3 +1,5 @@
+# match the text with regular expressions and the newlines as literal text
+
 (Cmd) say -r 3 -s yabba dabba do
 /^Y.*?$/
 /^Y.*?$/

tests/transcripts/characterclass.txt

@@ -1,2 +1,6 @@
+# match using character classes and special sequence for digits (\d)
+
 (Cmd) say 555-1212
 /[0-9]{3}-[0-9]{4}/
+(Cmd) say 555-1212
+/\d{3}-\d{4}/

tests/transcripts/dotstar.txt

@@ -1,2 +1,4 @@
+# ensure the old standby .* works. We use the non-greedy flavor
+
 (Cmd) say Adopt the pace of nature: her secret is patience.
-Adopt the pace of /.*/ is patience.
+Adopt the pace of /.*?/ is patience.

tests/transcripts/extension_notation.txt

@@ -1,2 +1,4 @@
+# inception: a regular expression that matches itself
+
 (Cmd) say (?:fred)
 /(?:\(\?:fred\))/

tests/transcripts/from_cmdloop.txt

@@ -1,10 +1,13 @@
+# responses with trailing spaces have been matched with a regex
+# so you can see where they are.
+
 (Cmd) help
 
 Documented commands (type help <topic>):
 ========================================
 _relative_load  help     mumble  pyscript  save  shell      speak
 cmdenvironment  history  orate   quit      say   shortcuts
-edit            load     py      run       set   show     
+edit            load     py      run       set   show/ */
 
 (Cmd) help say
 Repeats what you tell me to.

tests/transcripts/multiline_no_regex.txt

@@ -1,6 +1,4 @@
-# cmd2 will skip any lines
-# which occur before a valid
-# command prompt
+# test a multi-line command
 
 (Cmd) orate This is a test
 > of the

tests/transcripts/multiline_regex.txt

@@ -1,3 +1,5 @@
+# these regular expressions match multiple lines of text
+
 (Cmd) say -r 3 -s yabba dabba do
 /\A(YA.*?DO\n?){3}/
 (Cmd) say -r 5 -s yabba dabba do

tests/transcripts/regex_set.txt

@@ -1,7 +1,8 @@
 # Run this transcript with "python example.py -t transcript_regex.txt"
 # The regex for colors is because no color on Windows.
 # The regex for editor will match whatever program you use.
-# regexes on prompts just make the trailing space obvious
+# Regexes on prompts just make the trailing space obvious
+
 (Cmd) set
 abbrev: True
 autorun_on_edit: False

tests/transcripts/singleslash.txt

@@ -1,2 +1,5 @@
+# even if you only have a single slash, you have
+# to escape it
+
 (Cmd) say use 2/3 cup of sugar
 use 2\/3 cup of sugar