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

Add more info about the hyphen character in identifiers (#271)

This commit is contained in:
Jelle Besseling 2022-04-25 19:04:28 +02:00 committed by GitHub
parent 81a58e64ee
commit fcd489afa6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 9 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

10
SPEC.md
View File

@ -93,7 +93,10 @@ A bare Identifier is composed of any Unicode codepoint other than [non-initial
characters](#non-initial-characters), followed by any number of Unicode characters](#non-initial-characters), followed by any number of Unicode
codepoints other than [non-identifier characters](#non-identifier-characters), codepoints other than [non-identifier characters](#non-identifier-characters),
so long as this doesn't produce something confusable for a [Number](#number), so long as this doesn't produce something confusable for a [Number](#number),
[Boolean](#boolean), or [Null](#null). [Boolean](#boolean), or [Null](#null). For example, both a [Number](#number)
and an Identifier can start with `-`, but when an Identifier starts with `-`
the second character cannot be a digit. This is precicely specified in the
[Full Grammar](#full-grammar) below.
Identifiers are terminated by [Whitespace](#whitespace) or Identifiers are terminated by [Whitespace](#whitespace) or
[Newlines](#newline). [Newlines](#newline).
@ -106,6 +109,11 @@ The following characters cannot be the first character in a bare
* Any decimal digit (0-9) * Any decimal digit (0-9)
* Any [non-identifier characters](#non-identifier-characters) * Any [non-identifier characters](#non-identifier-characters)
Be aware that the `-` character can only be used as an initial
character if the second character is not a digit. This allows
identifiers to look like `--this`, and removes the ambiguity
of having an identifier look like a negative number.
### Non-identifier characters ### Non-identifier characters
The following characters cannot be used anywhere in a bare The following characters cannot be used anywhere in a bare