[css-overflow-4] Restructure document

Author: fantasai

css-overflow-4/Overview.bs

@@ -131,6 +131,22 @@ url: https://drafts.csswg.org/selectors-3/#subject; type: dfn; text: subject;
 <h2 id="intro">
 Introduction</h2>
 
+	This specification extends [[!CSS-OVERFLOW-3]].
+	It contains several primary sections:
+
+	: [[#overflow-properties|Overflow Scrolling and Clipping Controls]]
+	::
+		This section defines relatively simple extensions to the 'overflow-*' properties [[css-overflow-3#overflow-properties|in Level 3]].
+
+	: [[#auto-ellipsis|Automatic Ellipses]].
+	::
+		This section defines some experimental extensions to the '*-ellipsis' properties [[css-overflow-3#auto-ellipsis|in Level 3]].
+
+	: [[#fragmentation|Redirection of Overflow]]
+	::
+		This section definse 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-3]] is not completely finalized yet.
 To avoid accidental divergences and maintenance overhead,
 This specification is written as a delta specification over css-overflow Level 3.
@@ -139,63 +155,6 @@ its content will be integrated into this specification,
 which will then replace it.
 Until then, this specification only contains additions and extensions to level 3.
 
-	<p>
-		In CSS Level 1 [[CSS1]], placing more content than would fit
-		inside an element with a specified size
-		was generally an authoring error.
-		Doing so caused the content to extend
-		outside the bounds of the element,
-		which would likely cause
-		that content to overlap with other elements.
-	</p>
-
-	<p>
-		CSS Level 2 [[CSS2]] introduced the 'overflow' property,
-		which allows authors to have overflow be handled by scrolling,
-		which means it is no longer an authoring error.
-		It also allows authors to specify
-		that overflow is handled by clipping,
-		which makes sense when the author's intent
-		is that the content not be shown.
-		This was further refined in the CSS Overflow Module Level 3 [[CSS-OVERFLOW-3]].
-	</p>
-
-	<p>
-		However, scrolling is not the only way
-		to present large amounts of content,
-		and may even not be the optimal way.
-		After all, the codex replaced the scroll
-		as the common format for large written works
-		because of its advantages.
-	</p>
-
-	<p>
-		This specification introduces
-		a mechanism for Web pages to specify
-		that an element of a page should handle overflow
-		through pagination rather than through scrolling.
-	</p>
-
-	<p>
-		This specification also extends the concept of overflow
-		in another direction.
-		Instead of requiring that authors specify a single area
-		into which the content of an element must flow,
-		this specification allows authors to specify multiple fragments,
-		each with their own dimensions and styles,
-		so that the content of the element can flow from one to the next,
-		using as many as needed to place the content without overflowing.
-	</p>
-
-	<p>
-		In both of these cases, implementations must
-		break the content in the block-progression dimension.
-		Implementations must do this is described
-		in the CSS Fragmentation Module [[!CSS3-BREAK]].
-	</p>
-
-	<p>The definition of the 'text-overflow' property in this module supersedes the one in [[CSS-UI-3]] and [[CSS-OVERFLOW-3]].</p>
-
 <h3 id="values">
 Value Definitions</h3>
 
@@ -214,17 +173,22 @@ Module Interactions</h3>
 
 	This module extends features defined in [[!CSS-OVERFLOW-3]].
 
-<h2 id="overflow-concepts">Types of overflow</h2>
+<h2 id="overflow-concepts">
+Overflow Concepts and Terminology</h2>
 
-	Issue: copy level 3 content when final
+	Issue: Copy [[css-overflow-3#overflow-concepts|Level 3 content]] when final.
 
 
-<h2 id="overflow-properties">Overflow properties</h2>
+<h2 id="overflow-properties">
+Scrolling and Clipping Overflow</h2>
 
-	Issue: copy level 3 content when final
+	Issue: Copy [[css-overflow-3#overflow-properties|Level 3 content]] when final.
 
+<h2 id="auto-ellipsis">
+Automatic Ellipses</h2>
 
-<h2 id="text-overflow" caniuse="text-overflow">Overflow Ellipsis: the 'text-overflow' property</h2>
+<h3 id="text-overflow" caniuse="text-overflow">
+Inline Overflow Ellipsis: the 'text-overflow' property</h3>
 
 <pre class="propdef">
 Name: text-overflow
@@ -237,6 +201,8 @@ Computed value: as specified, with lengths made absolute
 Animation type: by computed value type
 </pre>
 
+ISSUE: This section might need to be re-synced against [[CSS-OVERFLOW-3]].
+
 This property specifies rendering when inline content overflows
 its line box edge
 in the inline progression direction of its block container element ("the block")
@@ -630,7 +596,68 @@ If there is insufficient space for both start
 and end ellipses/strings,
 then only the end ellipsis/string should be rendered.
 
-<h2 id="fragmentation">Fragmentation of overflow</h2>
+<h2 id="fragmentation">
+Redirection of Overflow</h2>
+
+	ISSUE: This section is highly experimental.
+
+	<p>
+		In CSS Level 1 [[CSS1]], placing more content than would fit
+		inside an element with a specified size
+		was generally an authoring error.
+		Doing so caused the content to extend
+		outside the bounds of the element,
+		which would likely cause
+		that content to overlap with other elements.
+	</p>
+
+	<p>
+		CSS Level 2 [[CSS2]] introduced the 'overflow' property,
+		which allows authors to have overflow be handled by scrolling,
+		which means it is no longer an authoring error.
+		It also allows authors to specify
+		that overflow is handled by clipping,
+		which makes sense when the author's intent
+		is that the content not be shown.
+		This was further refined in the CSS Overflow Module Level 3 [[CSS-OVERFLOW-3]].
+	</p>
+
+	<p>
+		However, scrolling is not the only way
+		to present large amounts of content,
+		and may even not be the optimal way.
+		After all, the codex replaced the scroll
+		as the common format for large written works
+		because of its advantages.
+	</p>
+
+	<p>
+		This specification introduces
+		a mechanism for Web pages to specify
+		that an element of a page should handle overflow
+		through pagination rather than through scrolling.
+	</p>
+
+	<p>
+		This specification also extends the concept of overflow
+		in another direction.
+		Instead of requiring that authors specify a single area
+		into which the content of an element must flow,
+		this specification allows authors to specify multiple fragments,
+		each with their own dimensions and styles,
+		so that the content of the element can flow from one to the next,
+		using as many as needed to place the content without overflowing.
+	</p>
+
+	<p>
+		In both of these cases, implementations must
+		break the content in the block-progression dimension.
+		Implementations must do this is described
+		in the CSS Fragmentation Module [[!CSS3-BREAK]].
+	</p>
+
+<h3 id="continue">
+Channeling Overflow: the 'continue' property</h3>
 
 The 'continue' property gives authors the ability
 to request that content that does not fit inside an element
@@ -734,7 +761,8 @@ Note: For background discussions leading to this property, see these threads:
 <a href="http://lists.w3.org/Archives/Public/www-style/2012May/1197.html">discussion of overflow, overflow-x, overflow-y and overflow-style</a> and
 <a href="https://lists.w3.org/Archives/Public/www-style/2015Jan/0357.html">proposal for a fragmentation property</a>
 
-<h2 id="paginated-overflow">Paginated overflow</h2>
+<h3 id="paginated-overflow">
+Paginated overflow</h3>
 
 This section introduces and defines the meaning of the ''continue/paginate'' value of the 'continue' property.
 
@@ -788,7 +816,8 @@ fragment overflow, which also deals with displaying multiple pages.
 		or the 'continue' property as described here.
 	</p>
 
-<h2 id="fragment-overflow">Fragment overflow</h2>
+<h3 id="fragment-overflow">
+Fragmented Overflow</h2>
 
 This section introduces and defines the meaning of
 the ''continue/fragments'' value of the 'continue' property.