berkus
/
kdl
mirror of https://github.com/kdl-org/kdl.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Rewrite intro paragraph for strings to make their usage clearer.

This commit is contained in:
Tab Atkins-Bittner 2023-12-26 13:04:35 -08:00
parent d53d99ff2e
commit 057e8c894d
1 changed files with 2 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
SPEC.md
View File

@ -281,10 +281,8 @@ node prop=(regex).*
### String
Strings in KDL represent textual UTF-8 [Values](#value). A String is either an
[Identifier String](#identifier-string), a [Quoted String](#quoted-string) or
a [Raw String](#raw-string). Quoted Strings may include escaped characters,
while Raw Strings always contain only the literal characters that are present.
Identifier Strings don't user delimiters.
[Identifier String](#identifier-string) (like `foo`), a [Quoted String](#quoted-string) (like `"foo"`) or
a [Raw String](#raw-string) (like `#"foo"#`). Identifier Strings let you write short, "single-word" strings with a minimum of syntax; Quoted Strings let you write strings with whitespace (including newlines!) or escapes; Raw Strings let you write strings with whitespace *but without escapes*, allowing you to not worry about the string's content containing anything that might look like an escape.
Strings _MUST_ be represented as UTF-8 values.