Clarify where and how dotted keys define tables

toml-lang · Sep 6, 2021 · 7f19cf4 · 7f19cf4
1 parent 3b11f69
commit 7f19cf4
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 3 deletions.
diff --git 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
@@ -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"