[css-overflow-5] Prepare for publication

css-overflow-5/Overview.bs

@@ -1,8 +1,10 @@
 <pre class="metadata">
 Title: CSS Overflow Module Level 5
-Status: ED
+Status: FPWD
+Prepare for TR: yes
 Work Status: Revising
 ED: https://drafts.csswg.org/css-overflow-5/
+TR: https://www.w3.org/TR/css-overflow-5/
 Shortname: css-overflow
 Group: csswg
 Level: 5
@@ -11,7 +13,9 @@ Editor: Elika J. Etemad / fantasai, Apple, http://fantasai.inkedblade.net/contac
 Editor: Robert Flack, Google, [email protected], w3cid 98451
 Abstract: This module contains the features of CSS relating to scrollable overflow handling in visual media.
 	It builds on the <a href="https://www.w3.org/TR/css-overflow-4/">CSS Overflow Module Level 4</a>,
-	adding an appendix containing an experimental exploration
+	adding the ability to generate and associate various scrolling controls
+	(markers to indicate scroll progress, buttons to trigger scrolling),
+	and adding an appendix containing an experimental exploration
 	of <a href="#fragmentation">redirecting overflow by fragmentation</a>.
 </pre>
 <pre class="link-defaults">
@@ -21,6 +25,9 @@ spec:css-pseudo-4; type:selector; text:::first-line
 spec:css-writing-modes-4; type:dfn; text:start
 spec:css-writing-modes-4; type:dfn; text:end
 </pre>
+<pre class=ignored-specs>
+spec: css21
+</pre>
 <pre class="anchors">
 url: https://www.w3.org/TR/CSS21/visudet.html#strut; type: dfn; text: strut;
 </pre>
@@ -133,27 +140,30 @@ url: https://www.w3.org/TR/CSS21/visudet.html#strut; type: dfn; text: strut;
 Introduction</h2>
 
 	This specification extends [[!CSS-OVERFLOW-4]].
+	It is currently a diff specification,
+	defining only a few new features;
+	see [[CSS-OVERFLOW-4]] for the rest of the features related to overflow.
 
 	: [[#scroll-navigation|Scroll navigation controls]]
 	::
-		This section defines stylable scroll navigation controls
-		with defined user interactions and accessible labels,
-		and pseudo-classes which automatically construct them.
+		This section defines the ability to associate [=scroll markers=]
+		with elements in a scroller
+		(or generate them automatically as ''::scroll-marker'' pseudo-elements,
+		with automatic user behavior and accessible labels),
+		which can be activated to scroll to the associated elements
+		and reflect the scroller's relative scroll progress
+		via the '':target-current'' pseudo-class.
+
+		It also defines ''::scroll-button()'' pseudo-elements,
+		which can be activated to cause their associated scroller
+		to scroll by a "page" in a given direction.
 
 	: [[#fragmentation|Redirection of Overflow]]
 	::
 		This section defines a highly experimental, exploratory new model
 		for handling overflow by redirecting it into newly-generated [=fragmentation containers=].
 
 
-Note: At the time of writing, [[CSS-OVERFLOW-4]] is not completely finalized yet.
-To avoid accidental divergences and maintenance overhead,
-This specification is written as a delta specification over css-overflow Level 4.
-Once the level 4 specification is final,
-its content will be integrated into this specification,
-which will then replace it.
-Until then, this specification only contains additions and extensions to level 4.
-
 <h2 id="overflow-concepts">
 Overflow Concepts and Terminology</h2>
 
@@ -415,7 +425,7 @@ They exist after their [=originating element's=] ''::scroll-marker-group'' pseud
 (when used with ''scroll-marker-group: before'').
 
 Four distinct ''::scroll-button()'' pseudo-elements can exist on a [=scroll container=],
-each associated with a [=logical=] direction,
+each associated with a [=flow-relative=] direction,
 based on their [=originating element's=] [=writing mode=]:
 in order, [=block-start=], [=inline-start=], [=block-end=], and [=inline-end=].
 The ''::scroll-button()'' pseudo-elements are both focusable and activatable by default,
@@ -447,7 +457,7 @@ The possible <dfn><<scroll-button-direction>></dfn> values are:
 	: <dfn>down</dfn>
 	: <dfn>left</dfn>
 	: <dfn>right</dfn>
-	:: Selects the ''::scroll-button()' corresponding to the given physical direction.
+	:: Selects the ''::scroll-button()'' corresponding to the given physical direction.
 
 	: <dfn>block-start</dfn>
 	: <dfn>block-end</dfn>
@@ -459,7 +469,7 @@ The possible <dfn><<scroll-button-direction>></dfn> values are:
 	::
 		Selects either the [=block-start=] or [=inline-start=] ''::scroll-button()'',
 		whichever's axis has more "scrollable pages" in the [=originating element=]:
-		the [=originating element's=] [=scrollable overflow height=]
+		the [=originating element's=] [=scrollable overflow area|scrollable overflow height=]
 		divided by its [=scrollport=] height,
 		or the same but for widths.