[css-inline-3] Align 'line-sizing' property to latest WG discussions. w3c#3199

Author: fantasai

css-inline-3/Overview.bs

@@ -329,95 +329,62 @@ Line Sizing Containment: the 'line-sizing' property</h3>
 
 	<pre class="propdef">
 	Name: line-sizing
-	Value: quirks-behavior | current-behavior | better-behavior | box-model-behavior | absolute-behavior
-	Initial: current-behavior
-	Applies to: block containers? inline boxes?
+	Value: legacy | normal
+	Initial: legacy
+	Applies to: inline boxes
 	Inherited: yes
 	Percentages: N/A
 	Computed value: the specified keyword
 	</pre>
 
 	ISSUE: This is a rought draft of a proposal, and has not yet been approved by the CSSWG.
-	Many variants have been included to promote discussion of possible behaviors;
-	not all of them are expected to be kept.
 	See discussion in <a href="https://github.com/w3c/csswg-drafts/issues/3199">Issue 3199</a>, <a href="https://lists.w3.org/Archives/Public/www-style/2011Mar/0364.html">Hyatt's message</a>, and <a href="https://dev.w3.org/cvsweb/~checkout~/csswg/css3-linebox/Attic/Overview.html?rev=1.5;content-type=text%2Fhtml#LineStacking">dbaron's proposal</a>.
-	Also all the keywords are expected to be renamed.
 
 	This property controls the method by which line boxes are sized,
 	and thus the spacing between lines of text.
 
 	Values have the following meanings:
 
 	<dl dfn-for=line-sizing dfn-type=value>
-		<dt><dfn>quirks-behavior</dfn>
+		<dt><dfn>legacy</dfn>
 		<dd>
-			Line boxes are sized, and content positioned within them,
-			as defined in [[!CSS2]] except that
+			The inline box contributes to the sizing of its line box
+			based on its 'line-height',
+			rather than based on its box edges,
+			as defined in [[!CSS2]].
+			In Quirks Mode [[!QUIRKS]],
 			any <a>inline box</a> <a lt="box fragment">fragment</a>
 			that has zero borders and padding and
 			that does not directly contain text or <a>preserved white space</a> [[!CSS-TEXT-3]]
-			is ignored for this purpose.
-
-		<dt><dfn>current-behavior</dfn>
-		<dd>
-			Line boxes are sized, and content positioned within them,
-			as defined in [[!CSS2]].
+			is ignored when sizing the line box.
 
 			Note: In this model, vertical rhythm is broken
 			any time there is a change in font metrics within a paragraph.
 
-		<dt><dfn>better-behavior</dfn>
+		<dt><dfn>normal</dfn>
 		<dd>
-			Line boxes are sized, and content positioned within them,
-			as defined in [[!CSS2]],
-			except that positive half-leading is not applied
-			to any box other than the <a>root inline box</a>.
+			The inline box contributes to the sizing of its line box
+			based on its <a>margin box</a>,
+			rather than its 'line-height'.
+			Half-leading is inserted inside the <a>content box</a> edges,
+			rather than overlapping the padding/border/margin areas.
+			However, positive half-leading is only applied to the <a>root inline box</a>.
+			Negative half-leading is applied to all inline boxes,-
+			reducing the size of the <a>content box</a> as needed.
 
 			Note: This will give consistent line spacing
 			as long as there is some amount of leading added,
 			such that the half-leading on the root inline
-			is large enough to accommodate the unleaded ascent of its descendants.
-			The line box will grow to accommodate
+			is large enough to accommodate the unleaded ascent/descent of its descendants.
+			The line box will grow, however, to accommodate
 			content that would otherwise overflow,
-			avoiding overlap between lines.
-
-		<dt><dfn>box-model-behavior</dfn>
-		<dd>
-			Line boxes are sized to fit the <a>root inline box</a>
-			and its <a>half-leading</a>,
-			as well as the <a>outer edges</a> of any <a>inline-level descendants</a>
-			in the same <a>inline formatting context</a>.
-			Positive half-leading is not applied to any other <a>inline box</a>;
-			negative half-leading is applied as negative margins
-			to <a>inline boxes</a> whose block-axis margins, borders, and padding
-			are zero.
-
-			Note: This mode is similar to ''better-behavior'',
-			but re-uses the familiar margin/border/padding box model
-			of controlling spacing.
-			However to ensure that 'line-height' < 1 behaves as expected,
-			the default case (no margin/border/padding)
-			needs to apply negative leading to such inlines.
-
-		<dt><dfn>absolute-behavior</dfn>
-		<dd>
-			Line boxes are sized to fit the <a>root inline box</a>
-			and its <a>half-leading</a>;
-			no other boxes are considered.
-			Inline-level content may overflow the line box
-			and overlap adjacent lines
-			if it extends higher or lower
-			than the edges of the root inline box’s leading.
+			to avoid overlap between lines.
 	</dl>
 
 	ISSUE: Should this property apply to block containers or to inline boxes?
 	In the latter case, an individual inline could say "pay attention to me"
 	or "don't pay attention to me".
 
-	ISSUE: Need better names. Maybe `loose | normal | strict | absolute`?
-	Maybe `quirks | legacy | normal | absolute`?
-	Something else?
-
 <h2 id="inline-box-dimensions">
 Drawing Inline Boxes</h2>
 
@@ -451,10 +418,11 @@ Inline Box Heights: the 'inline-sizing' property</h3>
 
 		<dt><dfn>stretch</dfn>
 		<dd>
-			The <a>logical height</a> of the <a>content area</a>
+			Once the line box has been sized,
+			the final <a>logical height</a> of the <a>inline box</a>’s <a>content area</a>
 			is calculated as the <a>stretch fit</a>
-			into the line box.
-			The box is then positioned such that its <a>margin edges</a>
+			into the line box,
+			and it is positioned such that its <a>margin edges</a>
 			coincide with the line box’s edges.
 	</dl>
 
@@ -1841,13 +1809,23 @@ A.2: Synthesizing Baselines for Replaced Content</h3>
 <h2 class="no-num" id="changes">
 Changes</h2>
 
+	Changes since the
+	<a href="https://www.w3.org/TR/2018/WD-css-inline-3-20180808/">8 August 2018 Working Draft</a>
+	include:
+
+	<ul>
+		<li>
+			Added 'line-sizing' property to control how inter-line spacing is calculated.
+			(<a href="https://github.com/w3c/csswg-drafts/issues/3199">Issue 3199</a>)
+	</ul>
+
 	Changes since the
 	<a href="https://www.w3.org/TR/2016/WD-css-inline-3-20160524/">24 May 2016 Working Draft</a>
 	include:
 
 	<ul>
 		<li>
-			Added outline of property to control the logical height of inline boxes.
+			Sketched out property to control the logical height of inline boxes.
 			(<a href="https://github.com/w3c/csswg-drafts/issues/1974">Issue 1974</a>)
 		<li>
 			Better defined handling of initial letters