Merge pull request #859 from eksortso/i846_dot_def_tables

Author: pradyunsg

CHANGELOG.md

@@ -2,7 +2,7 @@
 
 ## unreleased
 
-Nothing.
+* Clarify where and how dotted keys define tables.
 
 ## 1.0.0 / 2021-01-11
 

toml.md

@@ -760,8 +760,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, or in one inline table.
 
 ```toml
 fruit.apple.color = "red"