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 ### String
Strings in KDL represent textual UTF-8 [Values](#value). A String is either an Strings in KDL represent textual UTF-8 [Values](#value). A String is either an
[Identifier String](#identifier-string), a [Quoted String](#quoted-string) or [Identifier String](#identifier-string) (like `foo`), a [Quoted String](#quoted-string) (like `"foo"`) or
a [Raw String](#raw-string). Quoted Strings may include escaped characters, 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.
while Raw Strings always contain only the literal characters that are present.
Identifier Strings don't user delimiters.
Strings _MUST_ be represented as UTF-8 values. Strings _MUST_ be represented as UTF-8 values.