[css-inline-3] Additional text-box-edge/line-fit-edge clean-up. #10675

Author: fantasai

css-inline-3/Overview.bs

@@ -179,7 +179,7 @@ Layout of Line Boxes</h3>
 
 	The [=logical height=] of a [=line box=] is fitted to its contents
 	once they have been [[#alignment|block-axis aligned]].
-	This fit is controlled by 'line-height' and 'text-box-edge'.
+	This fit is controlled by 'line-height' and 'line-fit-edge'.
 	The first/last line boxes in a [=block container=] may additionally
 	be trimmed by 'text-box-trim'.
 
@@ -217,14 +217,14 @@ Layout Within Line Boxes</h3>
 				this is their [=margin box=].
 			<li>
 				For the [=root inline box=],
-				and for [=inline boxes=] with ''text-box-edge: leading'':
+				and for [=inline boxes=] with ''line-fit-edge: leading'':
 				this derived from their used 'line-height',
 				ignoring any [=margin=]/[=border=]/[=padding=];
 				see [[#inline-height]].
 
 			<li>
 				For other [=inline boxes=]:
-				this is derived from their 'text-box-edge' metrics,
+				this is derived from their 'line-fit-edge' metrics,
 				and includes any [=margin=]/[=border=]/[=padding=];
 				see [[#inline-height]].
 		</ul>
@@ -366,7 +366,8 @@ Baselines and Metrics</h3>
 	such as alignment, box sizing, and initial letter layout.
 
 	Issue: The CSSWG would like to know which baseline values are necessary
-	for each property that uses them ('dominant-baseline', 'alignment-baseline', 'text-box-edge', 'initial-letter-align'):
+	for each property that uses them
+	('dominant-baseline', 'alignment-baseline', 'text-box-edge', 'line-fit-edge', 'initial-letter-align'):
 	if any can be dropped, or any need to be added.
 	See <a href="https://github.com/w3c/csswg-drafts/issues/859">Issue 859</a>.
 
@@ -1149,7 +1150,7 @@ Text Edge Metrics: the 'line-fit-edge' property</h3>
 
 	<figure>
 		<img src="images/text-edge.png" width="480"
-		     alt="Three different values of the text-box-edge property."  >
+		     alt="Three different values of the line-fit-edge property."  >
 		<figcaption>
 			The 'line-fit-edge' property, showing values for ''line-fit-edge/leading'',
 			''line-fit-edge/cap'', and ''line-fit-edge/ex''.
@@ -1243,7 +1244,7 @@ Calculating the Logical Height Contributions (“Layout Bounds”) of Inline Box
 	giving an effective ascent above the baseline of
 	<var>A′</var> = <var>A</var> + <var>L</var>/2,
 	and an effective descent of <var>D′</var> = <var>D</var> + <var>L</var>/2.
-	However, if 'line-fit-edge' is not ''text-box-edge/leading''
+	However, if 'line-fit-edge' is not ''line-fit-edge/leading''
 	and this is not the [=root inline box=],
 	if the [=half-leading=] is positive, treat it as zero.
 	The [=layout bounds=] exactly encloses
@@ -1400,15 +1401,12 @@ Trimming Over/Under Text: the 'text-box-trim' property</h3>
 
 	On [=inline boxes=],
 	specifies whether to trim the [=content box=]
-	to match its corresponding 'text-box-edge' metric.
-
-	ISSUE: Should inline boxes automatically do this?
-	And/or is it better for line sizing and content-box sizing to be separably controlled?
+	to match the specified 'text-box-edge' metric.
 
 	On [=block containers=],
 	specifies whether to trim [=half-leading=]
 	at the start/end of its content
-	to the corresponding 'text-box-edge' metric
+	to the specified 'text-box-edge' metric
 	to better match the box’s [=content edge=] to its text content.
 
 	Values have the following meanings:
@@ -1422,36 +1420,33 @@ Trimming Over/Under Text: the 'text-box-trim' property</h3>
 			When applied to an [=inline box=],
 			specifies that the over/under [=content edges=] coincide
 			with the [=text-over=]/[=text-under=] baselines
-			regardless of 'text-box-edge'
-			(which nonetheless still affects [=line box=] sizing).
+			regardless of 'text-box-edge'.
 
 		<dt><dfn>trim-start</dfn>
 		<dd>
 			For [=block containers=]:
 			trim the [=block-start=] side of the <a>first formatted line</a>
-			to the corresponding 'text-box-edge' metric of its [=root inline box=].
+			to the specified metric of its [=root inline box=].
 			If there is no such line,
 			or if there is intervening non-zero padding or borders,
 			there is no effect.
 
 			For [=inline boxes=]:
 			trims the [=block-start=] side of the box
-			to match its [=content edge=] to the metric specified by 'text-box-edge'
-			(treating ''text-box-edge/leading'' as ''text-box-edge/text'').
+			to match its [=content edge=] to the metric specified by 'text-box-edge'.
 
 		<dt><dfn>trim-end</dfn>
 		<dd>
 			For [=block containers=]:
 			trim the [=block-end=] side of the last formatted line
-			to the corresponding 'text-box-edge' metric of its [=root inline box=].
+			to the specified metric of its [=root inline box=].
 			If there is no such line,
 			or if there is intervening non-zero padding or borders,
 			there is no effect.
 
 			For [=inline boxes=]:
 			trims the [=block-end=] side of the box
-			to match its [=content edge=] to the metric specified by 'text-box-edge'
-			(treating ''text-box-edge/leading'' as ''text-box-edge/text'').
+			to match its [=content edge=] to the metric specified by 'text-box-edge'.
 
 		<dt><dfn>trim-both</dfn>
 		<dd>
@@ -1487,7 +1482,7 @@ Text Trimming Metrics: the 'text-box-edge' property</h3>
 	This property specifies the metrics to use for 'text-box-trim' effects.
 	Values have the same meanings as for 'line-fit-edge';
 	the <dfn for=text-box-edge value>auto</dfn> keyword
-	computes to the value of 'line-fit-edge',
+	uses the value of 'line-fit-edge' on the [=root inline=] of the the affected [=line box=],
 	interpreting ''line-fit-edge/leading'' (the [=initial value=]) as ''line-fit-edge/text''.
 
 	Note: This property can be set together with 'text-box-trim'
@@ -2086,7 +2081,7 @@ Properties Applying to Initial Letters</h4>
 	All properties that apply to an <a>inline box</a>
 	also apply to an <a>inline initial letter</a>
 	except for 'vertical-align' and its <a>sub-properties</a>,
-	'font-size', 'line-height', 'text-box-edge', and 'inline-sizing'.
+	'font-size', 'line-height', 'line-fit-edge', and 'inline-sizing'.
 	<!-- Basically, any properties defined in css-inline
 	except those specific to initial letters,
 	so keep this list updated as we add things to this spec. -->
@@ -3054,6 +3049,14 @@ A.3: Synthesizing Baselines for Atomic Inlines</h3>
 <h2 class="no-num" id="changes">
 Changes</h2>
 
+	Changes since the
+	<a href="https://www.w3.org/TR/2024/WD-css-inline-3-20240808/">8 August 2024 Working Draft</a>:
+	<ul>
+		<li>Some minor clean-up of references to 'text-box-edge' left over from when it also represented 'line-fit-edge'.
+		<li>Adjusted ''text-box-edge: auto'' to reference 'line-fit-edge' on the affected [=line box=]
+			rather than computing to the 'line-fit-edge' of the specifying element.
+	</ul>
+
 	Changes since the
 	<a href="https://www.w3.org/TR/2023/WD-css-inline-3-20230401/">1 April 2023 Working Draft</a>:
 	<ul>