Allow newlines and trailing comma in inline tables

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## unreleased
 
+* Allow newline after key/values in inline tables.
+* Allow trailing comma in inline tables.
 * Clarify where and how dotted keys define tables.
 * Add new `\e` shorthand for the escape character.
 

toml.abnf

@@ -222,13 +222,14 @@ std-table-close = ws %x5D     ; ] Right square bracket
 
 ;; Inline Table
 
-inline-table = inline-table-open [ inline-table-keyvals ] inline-table-close
+inline-table = inline-table-open [ inline-table-keyvals ] ws-comment-newline inline-table-close
 
-inline-table-open  = %x7B ws     ; {
-inline-table-close = ws %x7D     ; }
-inline-table-sep   = ws %x2C ws  ; , Comma
+inline-table-open  = %x7B  ; {
+inline-table-close = %x7D  ; }
+inline-table-sep   = %x2C  ; , Comma
 
-inline-table-keyvals = keyval [ inline-table-sep inline-table-keyvals ]
+inline-table-keyvals =  ws-comment-newline keyval ws-comment-newline inline-table-sep inline-table-keyvals
+inline-table-keyvals =/ ws-comment-newline keyval ws-comment-newline [ inline-table-sep ]
 
 ;; Array Table
 

toml.md

@@ -797,23 +797,32 @@ Inline Table
 ------------
 
 Inline tables provide a more compact syntax for expressing tables. They are
-especially useful for grouped data that can otherwise quickly become verbose.
-Inline tables are fully defined within curly braces: `{` and `}`. Within the
-braces, zero or more comma-separated key/value pairs may appear. Key/value pairs
-take the same form as key/value pairs in standard tables. All value types are
+especially useful for grouped (deeply) nested data that can otherwise quickly
+become verbose.
+
+Inline tables are defined within curly braces: `{` and `}`. Within the braces,
+zero or more comma-separated key/value pairs may appear. Key/value pairs take
+the same form as key/value pairs in standard tables. All value types are
 allowed, including inline tables.
 
-Inline tables are intended to appear on a single line. A terminating comma (also
-called trailing comma) is not permitted after the last key/value pair in an
-inline table. No newlines are allowed between the curly braces unless they are
-valid within a value. Even so, it is strongly discouraged to break an inline
-table onto multiples lines. If you find yourself gripped with this desire, it
-means you should be using standard tables.
+Inline tables can have multiple key/value pairs on the same line, or they can be
+put on different lines. A terminating comma (also called trailing comma) is
+permitted after the last key/value pair.
 
 ```toml
 name = { first = "Tom", last = "Preston-Werner" }
-point = { x = 1, y = 2 }
+point = {x=1, y=2}
 animal = { type.name = "pug" }
+contact = {
+    personal = {
+        name = "Donald Duck",
+        email = "[email protected]",
+    },
+    work = {
+        name = "Coin cleaner",
+        email = "[email protected]",
+    },
+}
 ```
 
 The inline tables above are identical to the following standard table
@@ -830,6 +839,14 @@ y = 2
 
 [animal]
 type.name = "pug"
+
+[contact.personal]
+name = "Donald Duck"
+email = "[email protected]"
+
+[contact.work]
+name = "Coin cleaner"
+email = "[email protected]"
 ```
 
 Inline tables are fully self-contained and define all keys and sub-tables within