[css-align] To match flexbox, *-self:stretch now allows shrinking.

Author: tabatkins

css-align/Overview.bs

@@ -435,7 +435,7 @@ Content Distribution: the 'justify-content' and 'align-content' properties</h2>
 	</pre>
 
 	Aligns the contents of the box as a whole along the box's inline/row/main axis.
-	Values other than <dfn value for="justify-content, align-content">auto</dfn> are <a href="#alignment-values">defined above</a>.
+	Values other than <dfn value for="justify-content, align-content">auto</dfn> are defined in [[#alignment-values]], above.
 	If both a <<content-distribution>> and <<content-position>> are given,
 	the <<content-position>> provides an explicit <a>fallback alignment</a>.
 
@@ -526,14 +526,14 @@ Baseline Content-Alignment</h3>
 			A <a>flex item</a> participates in first (last) <a>baseline content-alignment</a>
 			in its flex line if
 			its computed 'align-content' is ''baseline'' (''last-baseline'')
-			and its computed 'align-self' is ''<content-distribution>/stretch'' or ''start'' (''end'').
+			and its computed 'align-self' is ''align-self/stretch'' or ''start'' (''end'').
 
 		<dt>Grid Items:
 		<dd>
 			A <a>grid item</a> participates in first (last) <a>baseline content-alignment</a>
 			in either its row or column (whichever matches its <a>inline axis</a>)
 			if its computed 'align-content' is ''baseline'' (''last-baseline''),
-			and its computed 'align-self' or 'justify-self' (whichever affects its <a>block axis</a>) is ''<content-distribution>/stretch'' or ''start'' (''end'').
+			and its computed 'align-self' or 'justify-self' (whichever affects its <a>block axis</a>) is ''justify-self/stretch'' or ''start'' (''end'').
 	</dl>
 
 	If a box spans multiple <a>shared alignment contexts</a>,
@@ -596,11 +596,22 @@ Inline/Main-Axis Alignment: the 'justify-self' property</h3>
 	the box's outer edges are aligned within its <a>alignment container</a>
 	<a href="#alignment-values">as described by its alignment value</a>.
 
-	The <dfn value for="justify-self">auto</dfn> keyword computes to
+	The <dfn value for="justify-self, align-self">auto</dfn> keyword computes to
 	itself on absolutely-positioned elements,
 	and to the computed value of 'justify-items' on the parent
 	(minus any ''legacy'' keywords) on all other boxes,
 	or ''start'' if the box has no parent.
+	Its behavior depends on the layout model, as described below.
+
+	When the box’s computed 'width'/'height' (as appropriate to the axis) is ''width/auto''
+	and neither of its margins (in the appropriate axis) are ''margin/auto'',
+	the <dfn for="justify-self, align-self">stretch</dfn> keyword
+	sets the box’s used size to the length necessary to make its outer size
+	as close to filling the <a>alignment container</a> as possible
+	while still respecting the constraints imposed by 'min-height'/'min-width'/'max-height'/'max-width'.
+	Unless otherwise specified, this value falls back to ''flex-start''.
+
+	All other values are as defined in [[#alignment-values]], above.
 
 	<hr>
 
@@ -631,7 +642,7 @@ Inline/Main-Axis Alignment: the 'justify-self' property</h3>
 
 			When neither margin in this dimension is ''margin/auto''
 			and neither offset property in this dimension is ''top/auto'',
-			values other than ''<content-distribution>/stretch'' cause <a href="http://www.w3.org/TR/CSS21/visudet.html#abs-non-replaced-width">non-replaced absolutely-positioned boxes</a>
+			values other than ''justify-self/stretch'' cause <a href="http://www.w3.org/TR/CSS21/visudet.html#abs-non-replaced-width">non-replaced absolutely-positioned boxes</a>
 			to use shrink-to-fit sizing for calculating ''width/auto'' measures,
 			and 'justify-self' dictates alignment as follows:
 
@@ -646,7 +657,7 @@ Inline/Main-Axis Alignment: the 'justify-self' property</h3>
 			and the used value of the offset properties are not adjusted to correct for the over-constraint.
 
 			The ''justify-self/auto'' keyword is equivalent to ''start'' on replaced absolutely-positioned boxes,
-			and equivalent to ''<content-distribution>/stretch'' on all other absolutely-positioned boxes.
+			and equivalent to ''justify-self/stretch'' on all other absolutely-positioned boxes.
 			(This is because CSS 2.1 does not stretch replaced elements to fit into fixed offsets.)
 
 		<dt>Table Cells:
@@ -697,11 +708,9 @@ Block/Cross-Axis Alignment: the 'align-self' property</h3>
 	the box's outer edges are aligned within its <a>alignment container</a>
 	<a href="#alignment-values">as described by its alignment value</a>.
 
-	The <dfn value for="align-self">auto</dfn> keyword computes to
-	itself on absolutely-positioned elements,
-	and to the computed value of 'align-items' on the parent
-	(minus any ''legacy'' keywords) on all other boxes,
-	or ''start'' if the box has no parent.
+	The ''align-self/auto'' and ''align-self/stretch'' keywords are as defined in [[#justify-self-property]].
+
+	All other values are as defined in [[#alignment-values]], above.
 
 	<hr>
 
@@ -718,7 +727,7 @@ Block/Cross-Axis Alignment: the 'align-self' property</h3>
 
 			When neither margin in this dimension is ''margin/auto''
 			and neither offset property in this dimension is ''top/auto'',
-			values other than ''<content-distribution>/stretch'' cause <a href="http://www.w3.org/TR/CSS21/visudet.html#abs-non-replaced-height">non-replaced absolutely-positioned boxes</a>
+			values other than ''align-self/stretch'' cause <a href="http://www.w3.org/TR/CSS21/visudet.html#abs-non-replaced-height">non-replaced absolutely-positioned boxes</a>
 			to use shrink-to-fit sizing for calculating ''width/auto'' measures,
 			and 'align-self' dictates alignment as follows:
 
@@ -733,7 +742,7 @@ Block/Cross-Axis Alignment: the 'align-self' property</h3>
 			and the used value of the offset properties are not adjusted to correct for the over-constraint.
 
 			The ''align-self/auto'' keyword is equivalent to ''start'' on replaced absolutely-positioned boxes,
-			and equivalent to ''<content-distribution>/stretch'' on all other absolutely-positioned boxes.
+			and equivalent to ''align-self/stretch'' on all other absolutely-positioned boxes.
 			(This is because CSS 2.1 does not stretch replaced elements to fit into fixed offsets.)
 
 		<dt>Table Cells:
@@ -835,7 +844,7 @@ Inline/Main-Axis Alignment: the 'justify-items' property</h3>
 			Otherwise, ''justify-items/auto'' computes to:
 
 			<ul>
-				<li>''<content-distribution>/stretch'' for flex containers and grid containers
+				<li>''justify-self/stretch'' for flex containers and grid containers
 				<li>''start'' for everything else
 			</ul>
 
@@ -876,7 +885,7 @@ Block/Cross-Axis Alignment: the 'align-items' property</h3>
 			Computes to:
 
 			<ul>
-				<li>''<content-distribution>/stretch'' for flex containers and grid containers
+				<li>''align-self/stretch'' for flex containers and grid containers
 				<li>''start'' for everything else
 			</ul>
 	</dl>
@@ -1034,13 +1043,9 @@ Aligning Boxes by Baseline</h3>
 <h2 id="changes">
 Changes</h2>
 
-	Changes since the <a href="http://www.w3.org/TR/2013/WD-css3-align-20130514/">previous Working Draft</a> include:
+	Changes since the <a href="http://www.w3.org/TR/2014/WD-css-align-3-20141218/">previous Working Draft</a> include:
 
-	* Added ''last-baseline'' keyword.
-	* Improved details of baseline alignment.
-	* Changed handling of ''justify-self/auto''/''<content-distribution>/stretch'' for block-level and abspos elements in 'justify-self'/'align-self' to be more powerful and less confusing.
-	* Tightened up grammar combinations with <<overflow-position>> to be restricted to values that actually make sense.
-	* Various clarifications.
+	* Fixed handling of ''justify-self: stretch'' (and 'align-self') to allow shrinking, as defined in Flexbox.
 
 <h2 class=no-num id="acknowledgments">
 Acknowledgments</h2>