[css-display] Properly specify table-caption boxes. Fixes #1189.

Author: tabatkins

css-display/Overview.bs

@@ -14,7 +14,7 @@ Previous Version: https://www.w3.org/TR/2014/WD-css-display-3-20140911/
 Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
 Editor: Elika J. Etemad / fantasai, Invited Expert, http://fantasai.inkedblade.net/contact, w3cid 35400
 Abstract: This module describes how the CSS formatting box tree is generated from the document element tree and defines the 'display' property that controls it.
-Ignored Terms: display-model, display-role, table row group box, absolutely positioned
+Ignored Terms: display-model, display-role, table row group box, absolutely positioned, table formatting context
 At Risk: Application of ''::first-letter'' in the presence of run-ins
 At Risk: ''display: run-in''
 At Risk: All two-keyword values of 'display' and ''display: inline-list-item''
@@ -338,9 +338,11 @@ Inner Display Layout Models: the ''flow'', ''flow-root'', ''table'', ''grid'', a
 
 		<dt><dfn>table</dfn>
 		<dd>
-			The element generates a principal <i>table wrapper box</i>
-			containing an additionally-generated <i>table box</i>,
-			and establishes a <i>table formatting context</i>. [[!CSS2]]
+			The element generates a principal <a>table wrapper box</a>
+			that establishes a <a>block formatting context</a>,
+			and which contains
+			an additionally-generated <a>table box</a>
+			that establishes a <a>table formatting context</a>. [[!CSS2]]
 
 		<dt><dfn>flex</dfn>
 		<dd>
@@ -403,17 +405,29 @@ Layout-Internal Display Types: the ''table-*'' and ''ruby-*'' keywords</h3>
 	The <<display-internal>> keywords are defined as follows:
 
 	<dl dfn-type=value dfn-for="display, <display-internal>">
-		<dt><dfn>table-row-group</dfn>, <dfn>table-header-group</dfn>, <dfn>table-footer-group</dfn>, <dfn>table-row</dfn>, <dfn>table-cell</dfn>, <dfn>table-column-group</dfn>, <dfn>table-column</dfn>, <dfn>table-caption</dfn>
+		<dt><dfn>table-row-group</dfn>, <dfn>table-header-group</dfn>, <dfn>table-footer-group</dfn>, <dfn>table-row</dfn>, <dfn>table-cell</dfn>, <dfn>table-column-group</dfn>, <dfn>table-column</dfn>
 		<dd>
-			The element is an <dfn dfn for>internal table element</dfn>,
-			and participates in a table layout context. [[!CSS2]]
+			The element is an <dfn dfn for>internal table element</dfn>.
+			It generates the appropriate <dfn dfn for>internal table box</dfn>
+			which participates in a <a>table formatting context</a>.
+			See <a href="https://www.w3.org/TR/CSS2/tables.html#table-display">CSS2&sect;17.2</a> [[!CSS2]].
 
-			''table-cell'' and ''table-caption'' have a ''flow-root'' <a>inner display type</a>.
+			''table-cell'' boxes have a ''flow-root'' <a>inner display type</a>.
+
+		<dt><dfn>table-caption</dfn>
+		<dd>
+			The element generates a <dfn dfn for>table caption box</dfn>,
+			which is a <a>block box</a> with special behavior with respect to table and table wrapper boxes.
+			See <a href="https://www.w3.org/TR/CSS2/tables.html#table-display">CSS2&sect;17.2</a> [[!CSS2]].
+
+			''table-caption'' boxes have a ''flow-root'' <a>inner display type</a>.
+		<dt>
 
 		<dt><dfn>ruby-base</dfn>, <dfn>ruby-text</dfn>, <dfn>ruby-base-container</dfn>, <dfn>ruby-text-container</dfn>
 		<dd>
-			The element is an <dfn dfn for>internal ruby element</dfn>,
-			and participates in a ruby layout context. [[!CSS3RUBY]]
+			The element is an <dfn dfn for>internal ruby element</dfn>.
+			It generates the appropriate <dfn dfn for>internal ruby box</dfn>
+			which participates in a <a>ruby formatting context</a>. [[!CSS3RUBY]]
 
 			''ruby-base'' and ''ruby-text'' have a ''flow'' <a>inner display type</a>.
 	</dl>