-Text Decoration Line Trimming and Extension: the 'text-decoration-trim' property

-	Name: text-decoration-trim
+	Name: text-decoration-inset
 	Value: <>{1,2} | auto
 	Initial: 0
 	Applies to: all elements
@@ -894,7 +894,7 @@ Text Decoration Line Trimming and Extension: the 'text-decoration-trim' property
 				
 					h1 {
 						text-decoration: underline 0.3em rgba(36,148,187,0.25);
-						text-decoration-trim: 1em -1em;
+						text-decoration-inset: 1em -1em;
 					}
 				
 			
@@ -2185,7 +2185,7 @@ Changes since the 4 May 2022 Working Draft
 	

 		
Redesigned 'text-decoration-skip-self'.
 			(Issue 2885)
-		
Replaced text-decoration-skip-edges with 'text-decoration-trim'.
+		
Replaced text-decoration-skip-edges with 'text-decoration-inset'.
 			(Issue 4557)
 		
Redefined [=spacers=] for 'text-decoration-skip-spaces' to reference [=Unicode General Category=] Zs
 			and to only additionally include word separators when skipping all spaces.

From e65558533c9f9e9dcbfa01fff74cbb1d21b5a21b Mon Sep 17 00:00:00 2001
From: Sebastian Zartner 
Date: Thu, 30 Oct 2025 00:01:44 +0100
Subject: [PATCH 2/4] [css-text-decor-4] Removed mentions of
 text-decoration-skip-inset

Any mentions of `text-decoration-skip-inset` were either removed or replaced by `text-decoration-inset`.
---
 css-text-decor-4/Overview.bs | 9 ++++-----
 1 file changed, 4 insertions(+), 5 deletions(-)

diff --git a/css-text-decor-4/Overview.bs b/css-text-decor-4/Overview.bs
index ce772db1561a..8a5bb222d692 100644
--- a/css-text-decor-4/Overview.bs
+++ b/css-text-decor-4/Overview.bs
@@ -859,7 +859,7 @@ Text Decoration Line Uniformity
 	
 
 
-

+

 Text Decoration Line Trimming and Extension: the 'text-decoration-inset' property
 
 	
@@ -882,7 +882,7 @@ Text Decoration Line Trimming and Extension: the 'text-decoration-inset' propert
 	the first applies to the [=start=] and the second to the [=end=].
 	Values have the following meanings:
 
-	

+	

 		
<>
 		

 			Inset (positive) or outset (negative)
@@ -907,12 +907,12 @@ Text Decoration Line Trimming and Extension: the 'text-decoration-inset' propert
 			(This is important in Chinese, where underlining is a form of punctuation.)
 
 			

-				

-				
''text-decoration-skip-inset: auto'' for <u>石井</u><u>艾俐俐</u>
+				
''text-decoration-inset: auto'' for <u>石井</u><u>艾俐俐</u>
 
 			
 	
@@ -952,7 +952,6 @@ Text Decoration Line Continuity: the 'text-decoration-skip' shorthand and its su
 	The 'text-decoration-skip' property and its sub-properties
 	('text-decoration-skip-self',
 	'text-decoration-skip-box',
-	'text-decoration-skip-inset',
 	'text-decoration-skip-spaces',
 	'text-decoration-skip-ink')
 	control interruptions in line decorations

From 3a9f6fca45e6f7865ab431abe326e685a122ac88 Mon Sep 17 00:00:00 2001
From: Sebastian Zartner 
Date: Thu, 30 Oct 2025 00:11:56 +0100
Subject: [PATCH 3/4] [css-text-decor-4][editorial] Changed wording regarding
 "trimming" of text decorations

---
 css-text-decor-4/Overview.bs | 12 ++++++------
 1 file changed, 6 insertions(+), 6 deletions(-)

diff --git a/css-text-decor-4/Overview.bs b/css-text-decor-4/Overview.bs
index 8a5bb222d692..19a77f915c05 100644
--- a/css-text-decor-4/Overview.bs
+++ b/css-text-decor-4/Overview.bs
@@ -860,7 +860,7 @@ Text Decoration Line Uniformity
 
 
 

-Text Decoration Line Trimming and Extension: the 'text-decoration-inset' property
+Adjusting Text Decoration Line Lengths: the 'text-decoration-inset' property
 
 	
 	Name: text-decoration-inset
@@ -901,7 +901,7 @@ Text Decoration Line Trimming and Extension: the 'text-decoration-inset' propert
 
 		
auto
 		

-			The UA chooses a trim amount that ensures that
+			The UA chooses an inset amount that ensures that
 			if two identical underlined elements appear side-by-side
 			they do not appear to have a single underline.
 			(This is important in Chinese, where underlining is a form of punctuation.)
@@ -917,15 +917,15 @@ Text Decoration Line Trimming and Extension: the 'text-decoration-inset' propert
 			
 	
 
-	Text decoration trimming is subject to 'box-decoration-break':
+	The adjustment of the text decoration's length is subject to 'box-decoration-break':
 	* for ''box-decoration-break/slice'' (the default)
-		trimming is only applied to the [=start=] edge of the first fragment
+		length adjustment is only applied to the [=start=] edge of the first fragment
 		and the [=end=] edge of the last fragment,
-		and may accumulate to other fragments if the amount of the trim
+		and may accumulate to other fragments if the amount of the inset
 		is more than the length of the fragment.
 		
 	* for ''box-decoration-break/clone''
-		trimming is applied to each fragment independently.
+		length adjustment is applied to each fragment independently.
 		
 
 


From e1fdf9053f06cb0c7519ffd6c698ee164ae5e2ac Mon Sep 17 00:00:00 2001
From: Sebastian Zartner 
Date: Thu, 6 Nov 2025 01:43:32 +0100
Subject: [PATCH 4/4] [css-text-decor-4][editorial] Rephrased adjustments to
 text decoration start and end endpoints

---
 css-text-decor-4/Overview.bs | 20 +++++++++++---------
 1 file changed, 11 insertions(+), 9 deletions(-)

diff --git a/css-text-decor-4/Overview.bs b/css-text-decor-4/Overview.bs
index 19a77f915c05..e24aded38875 100644
--- a/css-text-decor-4/Overview.bs
+++ b/css-text-decor-4/Overview.bs
@@ -860,7 +860,7 @@ Text Decoration Line Uniformity
 
 
 

-Adjusting Text Decoration Line Lengths: the 'text-decoration-inset' property
+Trimming, Expanding, and Shifting Text Decoration Lines: the 'text-decoration-inset' property
 
 	
 	Name: text-decoration-inset
@@ -873,9 +873,10 @@ Adjusting Text Decoration Line Lengths: the 'text-decoration-inset' property
 
-	This property adjusts the start and end points of line decorations,
-	allowing the author to shorten, lengthen, or shift the decoration
-	with respect to the text.
+	This property adjusts the start and end endpoints of line decorations.
+	Positive values move an endpoint inward, trimming the decoration;
+	negative values move it outward, extending the decoration.
+
 	It controls all text decoration lines drawn by this [=decorating box=],
 	but not any text decoration lines drawn by its ancestors.
 	If two component values are given,
@@ -885,8 +886,9 @@ Adjusting Text Decoration Line Lengths: the 'text-decoration-inset' property

 		
<>
 		

-			Inset (positive) or outset (negative)
-			the start/end of the affected line decorations.
+			Adjusts the start or end endpoint of the affected line decorations.
+			Positive values move the endpoint inward (trimming),
+			negative values move it outward (extending).
 
 			

 				
The following example offsets an extra thick underline
@@ -917,15 +919,15 @@ Adjusting Text Decoration Line Lengths: the 'text-decoration-inset' property
 	
 
-	The adjustment of the text decoration's length is subject to 'box-decoration-break':
+	The adjustment of the text decoration's endpoints is subject to 'box-decoration-break':
 	* for ''box-decoration-break/slice'' (the default)
-		length adjustment is only applied to the [=start=] edge of the first fragment
+		endpoint adjustment is only applied to the [=start=] edge of the first fragment
 		and the [=end=] edge of the last fragment,
 		and may accumulate to other fragments if the amount of the inset
 		is more than the length of the fragment.
 		
 	* for ''box-decoration-break/clone''
-		length adjustment is applied to each fragment independently.
+		endpoint adjustment is applied to each fragment independently.