[css-display] Prep for publication

Author: fantasai

css-display/Overview.bs

@@ -1,14 +1,15 @@
 <h1>CSS Display Module Level 3</h1>
 
 <pre class='metadata'>
-Status: ED
+Status: WD
+Date: 2015-07-21
 Work Status: Revising
 ED: http://dev.w3.org/csswg/css-display/
 Shortname: css-display
 Group: csswg
 Level: 3
 TR: http://www.w3.org/TR/css-display-3/
-Previous Version: http://www.w3.org/TR/2014/WD-css-display-3-20140220/
+Previous Version: http://www.w3.org/TR/2014/WD-css-display-3-20140911/
 Editor: Tab Atkins Jr., Google, http://xanthir.com/contact/
 Editor: fantasai, Invited Expert, http://fantasai.inkedblade.net/contact
 Abstract: This module describes how the CSS formatting box tree is generated from the document element tree and defines the 'display' and 'box-suppress' properties that control it.
@@ -21,7 +22,7 @@ Introduction</h2>
 	<p><em>This section is normative.</em>
 
 	CSS takes a source document, organized as a tree of <dfn lt="element|element tree">elements</dfn>,
-	and renders it onto a <a href="http://www.w3.org/TR/CSS21/intro.html#canvas">canvas</a> (such as your screen, a piece of paper, or an audio stream).
+	and renders it onto a <a href="http://www.w3.org/TR/CSS2/intro.html#canvas">canvas</a> (such as your screen, a piece of paper, or an audio stream).
 	To do this, it generates an intermediary structure,
 	the <dfn>box tree</dfn>,
 	which represents the formatting structure of the rendered document.
@@ -40,7 +41,7 @@ Introduction</h2>
 	However, some 'display' values
 	(e.g. ''display: list-item'')
 	generate more than one box
-	(e.g. a <a href="http://www.w3.org/TR/CSS21/visuren.html#principal-box">principal block box</a> and a <a href="http://www.w3.org/TR/CSS21/generate.html#lists">marker box</a>).
+	(e.g. a <a href="http://www.w3.org/TR/CSS2/visuren.html#principal-box">principal block box</a> and a <a href="http://www.w3.org/TR/CSS2/generate.html#lists">marker box</a>).
 	And some values
 	(such as ''display:none'', ''display: contents'', and ''box-suppress: discard'')
 	cause the <a>element</a> and/or its descendants to not generate any <a>boxes</a> at all.
@@ -52,11 +53,11 @@ Introduction</h2>
 	<a>Anonymous boxes</a> are generated in certain circumstances
 	to fix up the <a>box tree</a> when it requires a particular nested structure
 	that is not provided by the boxes generated from the <a>element tree</a>.
-	For example, a <a href="http://www.w3.org/TR/CSS21/tables.html#table-display">table cell box</a>
-	requires a particular type of parent box (the <a href="http://www.w3.org/TR/CSS21/tables.html#table-display">table row box</a>),
-	and will generate an <a>anonymous</a> <a href="http://www.w3.org/TR/CSS21/tables.html#table-display">table row box</a> around itself
-	if its parent is not a <a href="http://www.w3.org/TR/CSS21/tables.html#table-display">table row box</a>.
-	(See [[CSS21]] &sect; <a href="http://www.w3.org/TR/CSS21/tables.html#anonymous-boxes">17.2.1</a>.)
+	For example, a <a href="http://www.w3.org/TR/CSS2/tables.html#table-display">table cell box</a>
+	requires a particular type of parent box (the <a href="http://www.w3.org/TR/CSS2/tables.html#table-display">table row box</a>),
+	and will generate an <a>anonymous</a> <a href="http://www.w3.org/TR/CSS2/tables.html#table-display">table row box</a> around itself
+	if its parent is not a <a href="http://www.w3.org/TR/CSS2/tables.html#table-display">table row box</a>.
+	(See [[CSS2]] &sect; <a href="http://www.w3.org/TR/CSS2/tables.html#anonymous-boxes">17.2.1</a>.)
 	Unlike element-generated boxes, whose styles inherit strictly through the element tree,
 	anonymous boxes (which only exist in the <a>box tree</a>)
 	<a href="http://www.w3.org/TR/css-cascade/#inheriting">inherit</a> through their <a>box tree</a> parentage.
@@ -83,16 +84,16 @@ Introduction</h2>
 <h3 id="placement">
 Module interactions</h3>
 
-	This module replaces and extends the definition of the 'display' property defined in [[!CSS21]] section 9.2.4.
+	This module replaces and extends the definition of the 'display' property defined in [[!CSS2]] section 9.2.4.
 
 	None of the properties in this module apply to the <code>::first-line</code> or <code>::first-letter</code> pseudo-elements.
 
 <h3 id="values">
 Values</h3>
 
 	This specification follows the
-	<a href="http://www.w3.org/TR/CSS21/about.html#property-defs">CSS property
-	definition conventions</a> from [[!CSS21]].
+	<a href="http://www.w3.org/TR/CSS2/about.html#property-defs">CSS property
+	definition conventions</a> from [[!CSS2]].
 
 	In addition to the property-specific values listed in their definitions,
 	all properties defined in this specification also accept the
@@ -144,10 +145,11 @@ Box Layout Modes: the 'display' property</h2>
 
 	The following informative table summarizes the values of 'display':
 
-	<table class='data'>
-		<style scoped>
-			td, th { text-align: left; }
-		</style>
+	<style>
+		#display-value-summary td,
+		#display-value-summary th { text-align: left; }
+	</style>
+	<table class='data' id="display-value-summary">
 		<thead>
 			<tr>
 				<th>Short 'display'
@@ -189,12 +191,12 @@ Box Layout Modes: the 'display' property</h2>
 				<td>''list-item''
 				<td>''list-item block flow''
 				<td><a>block box</a>
-				    with additional <a href="http://www.w3.org/TR/CSS21/generate.html#lists">marker box</a>
+				    with additional <a href="http://www.w3.org/TR/CSS2/generate.html#lists">marker box</a>
 			<tr>
 				<td>''inline list-item''
 				<td>''list-item inline flow''
 				<td><a>inline box</a>
-				    with additional <a href="http://www.w3.org/TR/CSS21/generate.html#lists">marker box</a>
+				    with additional <a href="http://www.w3.org/TR/CSS2/generate.html#lists">marker box</a>
 		<tbody title="Formatting Context Root Display Types">
 			<tr>
 				<td>''flex''
@@ -265,11 +267,11 @@ Outer Display Roles for Flow Layout: the ''block'', ''inline'', and ''run-in'' k
 	<dl dfn-type="value" dfn-for="display, <display-outside>">
 		<dt><dfn>block</dfn>
 		<dd>
-			The element generates a <dfn dfn>block-level box</dfn>. [[!CSS21]]
+			The element generates a <dfn dfn>block-level box</dfn>. [[!CSS2]]
 
 		<dt><dfn>inline</dfn>
 		<dd>
-			The element generates an <dfn dfn>inline-level box</dfn>. [[!CSS21]]
+			The element generates an <dfn dfn>inline-level box</dfn>. [[!CSS2]]
 
 		<dt><dfn>run-in</dfn>
 		<dd>
@@ -293,7 +295,7 @@ Inner Display Layout Models: the ''flow'', ''flow-root'', ''table'', ''grid'', a
 		<dt><dfn>flow</dfn>
 		<dd>
 			The element lays out its contents using <dfn dfn>flow layout</dfn>
-			(<a href="http://www.w3.org/TR/CSS21/visuren.html">block-and-inline layout</a>).
+			(<a href="http://www.w3.org/TR/CSS2/visuren.html">block-and-inline layout</a>).
 
 			If its <a>outer display type</a> is ''inline'' or ''run-in'',
 			and it is participating in a
@@ -308,19 +310,19 @@ Inner Display Layout Models: the ''flow'', ''flow-root'', ''table'', ''grid'', a
 			and whether it is itself participating in a block or inline <a>formatting context</a>,
 			it either establishes a new <a>block formatting context</a> for its contents
 			or integrates its contents into its parent <a>formatting context</a>.
-			See <a href="http://www.w3.org/TR/CSS21/visuren.html">CSS2.1 Chapter 9</a>. [[!CSS21]]
+			See <a href="http://www.w3.org/TR/CSS2/visuren.html">CSS2.1 Chapter 9</a>. [[!CSS2]]
 
 		<dt><dfn>flow-root</dfn>
 		<dd>
 			The element generates a <a>block container</a> box,
 			and lays out its contents using <a>flow layout</a>.
-			It always establishes a new <a>block formatting context</a> for its contents. [[!CSS21]]
+			It always establishes a new <a>block formatting context</a> for its contents. [[!CSS2]]
 
 		<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>. [[!CSS21]]
+			and establishes a <i>table formatting context</i>. [[!CSS2]]
 
 		<dt><dfn>flex</dfn>
 		<dd>
@@ -348,7 +350,7 @@ Generating Marker Boxes: the ''list-item'' keyword</h3>
 	The <dfn value for="display, <display-list-item>">list-item</dfn> keyword
 	causes the element to generate a ''::marker'' pseudo-element box [[!CSS-PSEUDO-4]]
 	with the content specified by its 'list-style' properties
-	(<a href="http://www.w3.org/TR/CSS21/generate.html#lists">CSS 2.1§12.5 Lists</a>) [[!CSS21]]
+	(<a href="http://www.w3.org/TR/CSS2/generate.html#lists">CSS 2.1§12.5 Lists</a>) [[!CSS2]]
 	together with a principal box of the specified type for its own contents.
 
 	If no <<display-inside>> value is specified,
@@ -383,7 +385,7 @@ Layout-Internal Display Types: the ''table-*'' and ''ruby-*'' keywords</h3>
 		<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>
 		<dd>
 			The element is an <dfn dfn>internal table element</dfn>,
-			and participates in a table layout context. [[!CSS21]]
+			and participates in a table layout context. [[!CSS2]]
 
 			''table-cell'' and ''table-caption'' have a ''flow'' <a>inner display type</a>.
 
@@ -516,7 +518,7 @@ Automatic Box Type Transformations</h3>
 		Some examples of this include:
 
 		<ul>
-			<li>Absolute positioning or floating an element <a>blockifies</a> the box’s display type. [[CSS21]]
+			<li>Absolute positioning or floating an element <a>blockifies</a> the box’s display type. [[CSS2]]
 			<li>Containment in a <a spec=css-ruby>ruby container</a> <a>inlinifies</a> the box’s display type, as described in [[CSS3RUBY]].
 			<li>A parent with a ''grid'' or ''flex'' 'display' value <a>blockifies</a> the box’s display type. [[CSS3-GRID-LAYOUT]] [[CSS3-FLEXBOX]]
 		</ul>
@@ -672,7 +674,7 @@ Run-In Layout</h2>
 	Issue: Should out-of-flow elements get reparented, left behind, or break apart the sequence?
 	<a href="http://lists.w3.org/Archives/Public/www-style/2012Aug/0257.html">See thread.</a>
 
-	Note: This run-in model is slightly different from the one proposed in earlier revisions of [[!CSS21]].
+	Note: This run-in model is slightly different from the one proposed in earlier revisions of [[!CSS2]].
 
 	Issue: <a href="http://www.w3.org/mid/B81F7808-D972-458D-970F-3900E82A0F27@rivoal.net">Interaction of run-in and ::first-letter</a>
 
@@ -729,13 +731,13 @@ Appendix A: Glossary</h2>
 			If properties of a containing block are referenced,
 			they reference the values on the box that generated the containing block.
 			(For the <a>initial containing block</a>, the values are taken from the root element.)
-			See [[CSS21]] <a href="http://www.w3.org/TR/CSS21/visuren.html#containing-block">Section 9.1.2</a>
-			and <a href="http://www.w3.org/TR/CSS21/visudet.html#containing-block-details">Section 10.1</a> for details.
+			See [[CSS2]] <a href="http://www.w3.org/TR/CSS2/visuren.html#containing-block">Section 9.1.2</a>
+			and <a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">Section 10.1</a> for details.
 
 		<dt><dfn>initial containing block</dfn>
 		<dd>
 			The <a>containing block</a> of the root element.
-			See <a href="http://www.w3.org/TR/CSS21/visudet.html#containing-block-details">CSS2.1&sect;10.1</a> for continuous media;
+			See <a href="http://www.w3.org/TR/CSS2/visudet.html#containing-block-details">CSS2.1&sect;10.1</a> for continuous media;
 			and [[!CSS3PAGE]] for paged media.
 
 		<dt><dfn>formatting context</dfn>
@@ -747,7 +749,7 @@ Appendix A: Glossary</h2>
 			For example, a <a>flex formatting context</a>
 			lays out boxes according to the <a>flex layout</a> rules [[CSS3-FLEXBOX]],
 			whereas a <a>block formatting context</a>
-			lays out boxes according to the block-and-inline layout rules [[CSS21]].
+			lays out boxes according to the block-and-inline layout rules [[CSS2]].
 
 			When a box establishes a <em>new</em> formatting context
 			(whether that formatting context is of the same type as its parent or not),
@@ -778,7 +780,7 @@ Appendix A: Glossary</h2>
 		<dt><dfn>inline formatting context</dfn>
 		<dd>
 			Block and inline formatting contexts are defined in
-			<a href="http://www.w3.org/TR/CSS21/visuren.html#normal-flow">CSS 2.1 Section 9.4</a>.
+			<a href="http://www.w3.org/TR/CSS2/visuren.html#normal-flow">CSS 2.1 Section 9.4</a>.
 
 		<dt><dfn>BFC</dfn>
 		<dd>
@@ -788,7 +790,7 @@ Appendix A: Glossary</h2>
 			for its contents.
 	</dl>
 
-	See [[!CSS21]] <a href="http://www.w3.org/TR/CSS21/visuren.html">Chapter 9</a> for a fuller definition of these terms.
+	See [[!CSS2]] <a href="http://www.w3.org/TR/CSS2/visuren.html">Chapter 9</a> for a fuller definition of these terms.
 
 <h2 class=no-num id="acknowledgments">
 Acknowledgments</h2>