Suggestions for cleaning up the grammar

[epage]

Each TOML parser I've written, I've tried to keep as close connection to the abnf grammar as possible to make it easier to audit for correctness and update as the grammar changes. In doing so I found some things that I feel that could be improved

[epage]

The definition of a basic string and literal diverge unnecessarily, making them look more different than they are.

toml/toml.abnf

Line 86 in 48c3bed

basic-unescaped = wschar / %x21 / %x23-5B / %x5D-7E / non-ascii

toml/toml.abnf

Lines 30 to 31 in 48c3bed

	wschar = %x20 ; Space
	wschar =/ %x09 ; Horizontal tab

vs

toml/toml.abnf

Line 119 in 48c3bed

literal-char = %x09 / %x20-26 / %x28-7E / non-ascii

I'd either make both or neither use wschar

[epage]

The spec refers to [key] as a header (source):

Tables (also known as hash tables or dictionaries) are collections of key/value pairs. They are defined by headers, with square brackets on a line by themselves. You can tell headers apart from arrays because arrays are only ever values.

but the grammar calls the header a "table"

toml/toml.abnf

Lines 230 to 235 in 48c3bed

	;; Standard Table
	std-table = std-table-open key std-table-close
	std-table-open = %x5B ws ; [ Left square bracket
	std-table-close = ws %x5D ; ] Right square bracket

toml/toml.abnf

Lines 248 to 253 in 48c3bed

	;; Array Table
	array-table = array-table-open key array-table-close
	array-table-open = %x5B.5B ws ; [[ Double left square bracket
	array-table-close = ws %x5D.5D ; ]] Double right square bracket

[epage]

"T" and other literals get clarifications that they are both upper and lower case

toml/toml.abnf

Line 184 in 48c3bed

time-delim = "T" / %x20 ; T, t, or space

while "Z", HEXDIGIT, and exp do not

toml/toml.abnf

Line 190 in 48c3bed

time-offset = "Z" / time-numoffset

toml/toml.abnf

Line 259 in 48c3bed

HEXDIG = DIGIT / "A" / "B" / "C" / "D" / "E" / "F"

toml/toml.abnf

Line 163 in 48c3bed

exp = "e" float-exp-part

This is something that is easy to lose the context of and leave off.

[epage]

toml-lang/toml-test#169 might also be relevant here in terms of what minute offsets are allowed in offset date times.

[ChristianSi]

Thanks for the suggestions! They sound good in general. However, as we're now in the process of finalizing 1.1 for release, I'd suggest not to take on any new tasks for that version. I've tagged your proposal accordingly.