[css-grid] Minor tweaks to wording/spacing.

Author: fantasai

css-grid/Overview.bs

@@ -540,9 +540,16 @@ Grid Containers: the <a value>grid</a> and ''inline-grid'' 'display' values</h3>
 	<a href="http://www.w3.org/TR/CSS21/visudet.html#containing-block-details">exactly like block containers do</a>. [[!CSS21]]
 	The 'overflow' property applies to <a>grid containers</a>.
 
+	A <i>grid container</i> is sized
+	using the rules of the formatting context in which it participates.
+	In a <a>block formatting context</a>,
+	a <a>grid container’s</a> ''auto'' block size
+	is its max-content block size.
+	<span class="issue">The block layout spec should define this.</span>
 
 	Grid containers are not block containers,
-	and so some properties that were designed with the assumption of block layout don't apply in the context of grid layout.
+	and so some properties that were designed with the assumption of block layout
+	don't apply in the context of grid layout.
 	In particular:
 
 	<ul>
@@ -751,7 +758,9 @@ Track Sizing: the 'grid-template-rows' and 'grid-template-columns' properties</h
 			<<percentage>> values are relative to the measure (logical width) of the <a>grid container</a> in column <a>grid tracks</a>,
 			and the extent (logical height) of the <a>grid container</a> in row <a>grid tracks</a>.
 			If the measure or extent of the <a>grid container</a> is an <a href="http://www.w3.org/TR/css3-sizing/#indefinite-size">indefinite size</a>,
-			<<percentage>> values relative to that size are treated as <a value for=width>auto</a>.
+			<<percentage>> values relative to that size are treated as <a value for=width>auto</a>
+			(or, if in a ''minmax()'' function, as ''min-content'' when in the first position
+			and as ''max-content'' when in the second).
 
 		<dt><dfn><<flex>></dfn>
 		<dd>
@@ -878,7 +887,9 @@ Named Grid Lines: the ''(<<custom-ident>>*)'' syntax</h4>
 Repeating Rows and Columns: the ''repeat()'' notation</h4>
 
 	The ''repeat()'' notation represents a repeated fragment of the <a>track list</a>.
-	This is just a syntactic shorthand that allows writing a large number of columns or rows that exhibit a recurring pattern in a more compact form.
+	This is just a syntactic shorthand that allows
+	writing a large number of columns or rows that exhibit a recurring pattern
+	in a more compact form.
 	The syntax of the ''repeat()'' notation is:
 
 	<pre class='prod'><dfn>repeat()</dfn> = repeat( <<positive-integer>> , [ <<line-names>>? <<track-size>> ]+ <<line-names>>? )</pre>
@@ -915,12 +926,9 @@ Repeating Rows and Columns: the ''repeat()'' notation</h4>
 		</pre>
 	</div>
 
-	The ''repeat()'' function does not literally repeat its arguments, textually, into the value.
-	(If it did so, it would sometimes produce invalid values,
-		such as ''repeat(2, (a) 1fr (b))'' expanding into ''(a) 1fr (b) (a) 1fr (b)''.)
-	The <<line-names>> in its argument specify the position of some named lines relative to the tracks it defines;
-	these must be joined with any other named lines defined for that position.
-	(So the previous example is actually equivalent to the expanded value ''(a) 1fr (b a) 1fr (b)''.)
+	If the ''repeat()'' function ends up placing two <<line-names>> adjacent to each other,
+	the name lists are merged.
+	For example, ''repeat(2, (a) 1fr (b))'' is equivalent to ''(a) 1fr (b a) 1fr (b)''.
 
 	Note: It is expected that a future level of this specification will define a value to be inserted between the repetitions,
 	similar to the argument of the <code>Array#join</code> method in JavaScript.
@@ -2687,6 +2695,7 @@ Resolve Content-Based Track Sizing Functions</h3>
 					Mark any tracks whose <i>growth limit</i> changed
 					from infinite to finite in this step
 					as infinitely growable for the next step.
+					<!-- http://lists.w3.org/Archives/Public/www-style/2014Mar/0500.html -->
 				<li>
 					<strong>For max-content maximums:</strong>
 					Lastly continue to increase the <i>growth limit</i> of tracks with
@@ -2858,10 +2867,6 @@ Intrinsic Sizes</h3>
 
 	See [[!CSS3-SIZING]] for a definition of the terms in this section.
 
-	In a <a>block formatting context</a>,
-	a <a>grid container’s</a> ''auto'' block size
-	is its max-content block size.
-
 
 <h2 id='pagination'>
 Fragmenting Grid Layout</h2>

css-grid/Overview.html

@@ -89,7 +89,7 @@
 </p>
   <h1 class="p-name no-ref" id=title>CSS Grid Layout Module Level 1</h1>
   <h2 class="no-num no-toc no-ref heading settled heading" id=subtitle><span class=content>Editor’s Draft,
-    <span class=dt-updated><span class=value-title title=20140417>17 April 2014</span></span></span></h2>
+    <span class=dt-updated><span class=value-title title=20140418>18 April 2014</span></span></span></h2>
   <div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/css-grid/>http://dev.w3.org/csswg/css-grid/</a><dt>Latest version:<dd><a href=http://www.w3.org/TR/css-grid-1/>http://www.w3.org/TR/css-grid-1/</a><dt>Editor’s Draft:<dd><a href=http://dev.w3.org/csswg/css-grid/>http://dev.w3.org/csswg/css-grid/</a><dt>Previous Versions:<dd><a href=http://www.w3.org/TR/2013/WD-css3-grid-layout-20130402/ rel=previous>http://www.w3.org/TR/2013/WD-css3-grid-layout-20130402/</a><dd><a href=http://www.w3.org/TR/2012/WD-css3-grid-layout-20121106/ rel=previous>http://www.w3.org/TR/2012/WD-css3-grid-layout-20121106/</a>
     <dt>Feedback:</dt>
         <dd><a href="mailto:www-style@w3.org?subject=%5Bcss-grid%5D%20feedback">www-style@w3.org</a>
@@ -699,9 +699,16 @@ <h3 class="heading settled heading" data-level=3.1 id=grid-containers><span clas
 	<a href=http://www.w3.org/TR/CSS21/visudet.html#containing-block-details>exactly like block containers do</a>. <a data-biblio-type=normative data-link-type=biblio href=#css21 title=css21>[CSS21]</a>
 	The <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-overflow-3/#overflow0 title=overflow>overflow</a> property applies to <a data-link-type=dfn href=#grid-container title="grid containers">grid containers</a>.
 
+<p>	A <a data-link-type=dfn href=#grid-container title="grid container">grid container</a> is sized
+	using the rules of the formatting context in which it participates.
+	In a <a data-link-type=dfn title="block formatting context">block formatting context</a>,
+	a <a data-link-type=dfn href=#grid-container title="grid container’s">grid container’s</a> <a class=css data-link-type=maybe href=#valuedef-auto title=auto>auto</a> block size
+	is its max-content block size.
+	<span class=issue id=issue-8669c070><a class=self-link href=#issue-8669c070></a>The block layout spec should define this.</span>
 
 <p>	Grid containers are not block containers,
-	and so some properties that were designed with the assumption of block layout don’t apply in the context of grid layout.
+	and so some properties that were designed with the assumption of block layout
+	don’t apply in the context of grid layout.
 	In particular:
 
 <p>	<ul>
@@ -877,7 +884,9 @@ <h3 class="heading settled heading" data-level=5.1 id=track-sizing><span class=s
 			<a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#percentage-value title="<percentage>">&lt;percentage&gt;</a> values are relative to the measure (logical width) of the <a data-link-type=dfn href=#grid-container title="grid container">grid container</a> in column <a data-link-type=dfn href=#grid-track title="grid tracks">grid tracks</a>,
 			and the extent (logical height) of the <a data-link-type=dfn href=#grid-container title="grid container">grid container</a> in row <a data-link-type=dfn href=#grid-track title="grid tracks">grid tracks</a>.
 			If the measure or extent of the <a data-link-type=dfn href=#grid-container title="grid container">grid container</a> is an <a href=http://www.w3.org/TR/css3-sizing/#indefinite-size>indefinite size</a>,
-			<a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#percentage-value title="<percentage>">&lt;percentage&gt;</a> values relative to that size are treated as <a class=css-code data-link-for=width data-link-type=value title=auto>auto</a>.
+			<a class="production css-code" data-link-type=type href=http://dev.w3.org/csswg/css-values-3/#percentage-value title="<percentage>">&lt;percentage&gt;</a> values relative to that size are treated as <a class=css-code data-link-for=width data-link-type=value title=auto>auto</a>
+			(or, if in a <a class=css data-link-type=maybe href=#valuedef-minmax title=minmax()>minmax()</a> function, as <a class=css data-link-type=maybe href=#valuedef-min-content title=min-content>min-content</a> when in the first position
+			and as <a class=css data-link-type=maybe href=#valuedef-max-content title=max-content>max-content</a> when in the second).
 
 		<dt><dfn class=css-code data-dfn-for="grid-template-columns grid-template-rows" data-dfn-type=value data-export="" id=valuedef-flex><a class="production css-code" data-link-type=type href=#typedef-flex title="<flex>">&lt;flex&gt;</a><a class=self-link href=#valuedef-flex></a></dfn>
 		<dd>
@@ -999,7 +1008,9 @@ <h4 class="heading settled heading" data-level=5.1.2 id=repeat-notation><span cl
 Repeating Rows and Columns: the <a class=css data-link-type=maybe href=#funcdef-repeat title=repeat()>repeat()</a> notation</span><a class=self-link href=#repeat-notation></a></h4>
 
 <p>	The <a class=css data-link-type=maybe href=#funcdef-repeat title=repeat()>repeat()</a> notation represents a repeated fragment of the <a data-link-type=dfn href=#track-list title="track list">track list</a>.
-	This is just a syntactic shorthand that allows writing a large number of columns or rows that exhibit a recurring pattern in a more compact form.
+	This is just a syntactic shorthand that allows
+	writing a large number of columns or rows that exhibit a recurring pattern
+	in a more compact form.
 	The syntax of the <a class=css data-link-type=maybe href=#funcdef-repeat title=repeat()>repeat()</a> notation is:
 
 <pre class=prod><dfn class=css-code data-dfn-type=function data-export="" id=funcdef-repeat>repeat()<a class=self-link href=#funcdef-repeat></a></dfn> = repeat( <a class="production css-code" data-link-type=type title="<positive-integer>">&lt;positive-integer&gt;</a> , [ <a class="production css-code" data-link-type=type href=#typedef-line-names title="<line-names>">&lt;line-names&gt;</a>? <a class="production css-code" data-link-type=type href=#typedef-track-size title="<track-size>">&lt;track-size&gt;</a> ]+ <a class="production css-code" data-link-type=type href=#typedef-line-names title="<line-names>">&lt;line-names&gt;</a>? )</pre>
@@ -1033,12 +1044,9 @@ <h4 class="heading settled heading" data-level=5.1.2 id=repeat-notation><span cl
   &lt;/style&gt;
 </pre>	</div>
 
-<p>	The <a class=css data-link-type=maybe href=#funcdef-repeat title=repeat()>repeat()</a> function does not literally repeat its arguments, textually, into the value.
-	(If it did so, it would sometimes produce invalid values,
-		such as <span class=css data-link-type=maybe title="repeat(2, (a) 1fr (b))">repeat(2, (a) 1fr (b))</span> expanding into <span class=css data-link-type=maybe title="(a) 1fr (b) (a) 1fr (b)">(a) 1fr (b) (a) 1fr (b)</span>.)
-	The <a class="production css-code" data-link-type=type href=#typedef-line-names title="<line-names>">&lt;line-names&gt;</a> in its argument specify the position of some named lines relative to the tracks it defines;
-	these must be joined with any other named lines defined for that position.
-	(So the previous example is actually equivalent to the expanded value <span class=css data-link-type=maybe title="(a) 1fr (b a) 1fr (b)">(a) 1fr (b a) 1fr (b)</span>.)
+<p>	If the <a class=css data-link-type=maybe href=#funcdef-repeat title=repeat()>repeat()</a> function ends up placing two <a class="production css-code" data-link-type=type href=#typedef-line-names title="<line-names>">&lt;line-names&gt;</a> adjacent to each other,
+	the name lists are merged.
+	For example, <span class=css data-link-type=maybe title="repeat(2, (a) 1fr (b))">repeat(2, (a) 1fr (b))</span> is equivalent to <span class=css data-link-type=maybe title="(a) 1fr (b a) 1fr (b)">(a) 1fr (b a) 1fr (b)</span>.
 
 <p class=note>	Note: It is expected that a future level of this specification will define a value to be inserted between the repetitions,
 	similar to the argument of the <code>Array#join</code> method in JavaScript.
@@ -2663,6 +2671,7 @@ <h3 class="heading settled heading" data-level=10.4 id=algo-content><span class=
 					Mark any tracks whose <a data-link-type=dfn href=#growth-limit title="growth limit">growth limit</a> changed
 					from infinite to finite in this step
 					as infinitely growable for the next step.
+					
 				<li>
 					<strong>For max-content maximums:</strong>
 					Lastly continue to increase the <a data-link-type=dfn href=#growth-limit title="growth limit">growth limit</a> of tracks with
@@ -2833,10 +2842,6 @@ <h3 class="heading settled heading" data-level=10.7 id=intrinsic-sizes><span cla
 
 <p>	See <a data-biblio-type=normative data-link-type=biblio href=#css3-sizing title=css3-sizing>[CSS3-SIZING]</a> for a definition of the terms in this section.
 
-<p>	In a <a data-link-type=dfn title="block formatting context">block formatting context</a>,
-	a <a data-link-type=dfn href=#grid-container title="grid container’s">grid container’s</a> <a class=css data-link-type=maybe href=#valuedef-auto title=auto>auto</a> block size
-	is its max-content block size.
-
 
 <h2 class="heading settled heading" data-level=11 id=pagination><span class=secno>11 </span><span class=content>
 Fragmenting Grid Layout</span><a class=self-link href=#pagination></a></h2>
@@ -3335,7 +3340,9 @@ <h2 class="no-num no-ref heading settled heading" id=property-index><span class=
 <tr><th scope=row><a class=css-code data-link-type=property href=#propdef-grid-area title=grid-area>grid-area</a><td>&lt;grid-line&gt; [ / &lt;grid-line&gt; ]{0,3}<td>see individual properties<td>grid items<td>see individual properties<td>see individual properties<td>visual<td>see individual properties</table></div>
 
 
-<h2 class="no-num heading settled" id=issues-index><span class=content>Issues Index</span><a class=self-link href=#issues-index></a></h2><div style="counter-reset: issue"><div class=issue>
+<h2 class="no-num heading settled" id=issues-index><span class=content>Issues Index</span><a class=self-link href=#issues-index></a></h2><div style="counter-reset: issue"><div class=issue>The block layout spec should define this.<a href=#issue-8669c070> ↵ </a></div>
+
+<div class=issue>
 		We want the ability to collapse grid tracks
 		(similar to <a href=http://www.w3.org/TR/css3-flexbox/#visibility-collapse>collapsing flex items</a>
 		 or <a href=http://www.w3.org/TR/CSS21/tables.html#dynamic-effects>table rows/columns</a>),