Add some comments for clarification

toml-lang · Nov 18, 2021 · 8baf830 · 8baf830
1 parent 576db85
commit 8baf830
Show file tree

Hide file tree

Showing 2 changed files with 11 additions and 0 deletions.
diff --git a/tests/valid/string/multiline.toml b/tests/valid/string/multiline.toml
@@ -1,8 +1,13 @@
 # NOTE: this file includes some literal tab characters.
 
 multiline_empty_one = """"""
+
+# A newline immediately following the opening delimiter will be trimmed.
 multiline_empty_two = """
 """
+
+# \ at the end of line trims newlines as well; note that last \ is followed by
+# two spaces, which are ignored.
 multiline_empty_three = """\
     """
 multiline_empty_four = """\
@@ -33,6 +38,7 @@ whitespace-after-bs = """\
 no-space = """a\
     b"""
 
+# Has tab character.
 keep-ws-before = """a   	\
    b"""
 

diff --git a/tests/valid/string/raw-multiline.toml b/tests/valid/string/raw-multiline.toml
@@ -1,6 +1,11 @@
+# Single ' should be allowed.
 oneline = '''This string has a ' quote character.'''
+
+# A newline immediately following the opening delimiter will be trimmed.
 firstnl = '''
 This string has a ' quote character.'''
+
+# All other whitespace and newline characters remain intact.
 multiline = '''
 This string
 has ' a quote character