diff --git a/CHANGELOG.md b/CHANGELOG.md index 83a2520f..48795684 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,7 +2,7 @@ ## unreleased -Nothing. +* Clarify where and how dotted keys define tables. ## 1.0.0 / 2021-01-11 diff --git a/toml.md b/toml.md index 92246e6a..b9c2e5ba 100644 --- a/toml.md +++ b/toml.md @@ -759,8 +759,9 @@ name = "Regina Dogman" member_since = 1999-08-04 ``` -Dotted keys create and define a table for each key part before the last one, -provided that such tables were not previously created. +Dotted keys create and define a table for each key part before the last one. Any +such table must have all its key/value pairs defined under the current `[table]` +header, or in the root table if defined before all headers. ```toml fruit.apple.color = "red"