[css-grid] Editorial - expand the min-size section to copy m.m. the Flexbox text, rather than just referencing it.

Author: tabatkins

css-grid-1/Overview.bs

@@ -22,7 +22,7 @@ Former editor: Alex Mogilevsky, Microsoft Corporation, alexmog@microsoft.com
 Former editor: Phil Cupp, Microsoft Corporation, pcupp@microsoft.com
 Issue Tracking: Disposition of Comments https://drafts.csswg.org/css-grid-1/issues
 Abstract: This CSS module defines a two-dimensional grid-based layout system, optimized for user interface design. In the grid layout model, the children of a grid container can be positioned into arbitrary slots in a predefined flexible or fixed-size layout grid.
-Ignored Terms: containing block, <positive-integer>, <ident>, auto, grid-*-start, grid-*-end, flex factor, flex factors, block formatting context, grid-auto-position, min size property, max size property
+Ignored Terms: containing block, <positive-integer>, <ident>, auto, grid-*-start, grid-*-end, flex factor, flex factors, block formatting context, grid-auto-position
 Ignored Vars: A, B, C, size-contribution, track-sizes, extra-space
 Link Defaults: css21 (property) margin/min-height/max-height/min-width/max-width, css-align-3 (value) stretch/baseline, css-position-3 (property) left, css-position-3 (property) position, css-writing-modes-3 (dfn) start/end
 At Risk: application of grid placement to absolutely-positioned boxes
@@ -886,7 +886,7 @@ Establishing Grid Containers: the ''display/grid'' and ''inline-grid'' 'display'
 <h3 id='intrinsic-sizes'>
 Sizing Grid Containers</h3>
 
-	Note see [[!CSS3-SIZING]] for a definition of the terms in this section.
+	Note see [[!CSS-SIZING-3]] for a definition of the terms in this section.
 
 	A <a>grid container</a> is sized
 	using the rules of the formatting context in which it participates:
@@ -1237,28 +1237,72 @@ Z-axis Ordering: the 'z-index' property</h3>
 Automatic Minimum Size of Grid Items</h3>
 
 	To provide a more reasonable default <a>minimum size</a> for <a>grid items</a>,
-	this specification defines
-	that the ''min-width/auto'' value of 'min-width'/'min-height'
-	also applies an <a>automatic minimum size</a>
-	in the specified axis
-	to <a>grid items</a> whose 'overflow' is ''overflow/visible''
-	and which span at least one <a>track</a> in that axis
-	whose <a>min track sizing function</a> is ''grid-template-rows/auto''.
-
-	The <a>automatic minimum size</a> for a <a>grid item</a> in a given dimension is
-	its <a spec="css-flexbox">specified size</a> if it exists,
-	otherwise its <a spec="css-flexbox">transferred size</a> if that exists,
-	else its <a spec="css-flexbox">content size</a>,
-	each as defined in [[!CSS-FLEXBOX-1]].
+	the used value of an <a>automatic minimum size</a> in a given axis
+	on a <a>grid item</a> whose 'overflow' is ''overflow/visible'' in that same axis
+	and that spans at least one <a>track</a> in that axis
+	whose <a>min track sizing function</a> is ''grid-template-rows/auto''
+	is a <dfn>content-based minimum size</dfn>;
+	the <a>automatic minimum size</a> is otherwise zero, as usual.
+
+	The <a>content-based minimum size</a> for a <a>grid item</a> in a given dimension is
+	its <a>specified size suggestion</a> if it exists,
+	otherwise its <a>transferred size suggestion</a> if that exists,
+	else its <a>content size suggestion</a>.
 	However, if the <a>grid item</a> spans only <a>grid tracks</a>
 	that have a <a lt="fixed sizing function">fixed</a> <a>max track sizing function</a>,
-	its <a>specified size</a> and <a>content size</a> in that dimension
-	(and the input to the <a>transferred size</a> in the other dimension)
+	its <a>specified size suggestion</a> and <a>content size suggestion</a> in that dimension
+	(and the input to the <a>transferred size suggestion</a> in the other dimension)
 	are further clamped to less than or equal to the <a>stretch fit</a>
 	the <a>grid area</a>’s size
-	(so as to prevent the <a>automatic minimum size</a>
+	(so as to prevent the <a>content-based minimum size</a>
 	from forcing overflow of its fixed-size grid area).
 
+	The <a>content size suggestion</a>, <a>specified size suggestion</a>, and <a>transferred size suggestion</a>
+	used in this calculation account for the relevant min/max/preferred size properties
+	so that the <a>content-based minimum size</a> does not interfere with any author-provided constraints,
+	and are defined below:
+
+	<dl>
+		<dt><dfn>specified size suggestion</dfn>
+		<dd>
+			If the item’s computed <a>preferred size property</a> in the relevant axis is <a>definite</a>,
+			then the <a>specified size suggestion</a> is that size
+			(clamped by the relevant <a>max size property</a> if it's <a>definite</a>).
+			It is otherwise undefined.
+
+		<dt><dfn>transferred size suggestion</dfn>
+		<dd>
+			If the item has an intrinsic aspect ratio
+			and its computed <a>preferred size property</a> in the opposite axis is <a>definite</a>,
+			then the <a>transferred size suggestion</a> is that size
+			(clamped by the opposite-axis <a lt="min size property">min and max size properties</a> if they are <a>definite</a>),
+			converted through the aspect ratio
+			and finally clamped by the same-axis <a>max size property</a> if it's definite.
+			It is otherwise undefined.
+
+		<dt><dfn>content size suggestion</dfn>
+		<dd>
+			The <a>content size suggestion</a> is
+			the <a>min-content size</a> in the relevant axis,
+			clamped, if it has an aspect ratio,
+			by any <a>definite</a> opposite-axis <a lt="min size property">min and max size properties</a>
+			converted through the aspect ratio,
+			and then further clamped by the same-axis <a>max size property</a>
+			if that is <a>definite</a>.
+	</dl>
+
+	For the purpose of calculating an intrinsic size of the box
+	(e.g. the box’s <a>min-content size</a>),
+	this value causes the box’s size in that axis to become indefinite
+	(even if e.g. its 'width' property specifies a <a>definite</a> size).
+	Note this means that percentages calculated against this size
+	will [=behave as auto=].
+
+	Nonetheless, although this may require an additional layout pass to re-resolve percentages in some cases,
+	this value
+	(like the ''min-content'', ''max-content'', and ''fit-content'' values defined in [[CSS-SIZING-3]])
+	does not prevent the resolution of percentage sizes within the item.
+
 	<div class="note" id="min-size-opt">
 		Note that while a content-based minimum size is often appropriate,
 		and helps prevent content from overlapping or spilling outside its container,