Skip to content

Commit e53a3ac

Browse files
committed
[css-break] Clarify parallel breaks by using flow -> formatting context, now that we have a good definition for that. Improve linking.
1 parent 2491e83 commit e53a3ac

2 files changed

Lines changed: 15 additions & 15 deletions

File tree

css-break/Overview.bs

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -99,7 +99,7 @@ Fragmentation Model and Terminology</h2>
9999
</dd>
100100
<dt><dfn>fragmented flow</dfn></dt>
101101
<dd>
102-
A content flow that is being laid out in a <i>fragmentation context</i>.
102+
Content that is being laid out in a <i>fragmentation context</i>.
103103
The <i>fragmented flow</i> consists of the content of a (possibly anonymous) box
104104
called the <dfn>fragmentation root</dfn>.
105105
</dd>
@@ -146,11 +146,11 @@ Fragmentation Model and Terminology</h2>
146146
Parallel Fragmentation Flows</h3>
147147

148148
<p>
149-
When multiple flows are laid out parallel to each other,
150-
fragmentation is performed independently in each flow.
149+
When multiple <a>formatting contexts</a> are laid out parallel to each other,
150+
fragmentation is performed independently in each <a>formatting context</a>.
151151
For example, if an element is floated,
152152
then a forced break inside the float
153-
will not affect the content wrapping outside the float
153+
will not affect the content outside the float
154154
(except insofar as it may increase the height of the float).
155155
</p>
156156

@@ -525,7 +525,7 @@ Page Break Aliases: the 'page-break-before', 'page-break-after', and 'page-break
525525
Rules for Breaking</h2>
526526

527527
<p>
528-
A fragmented flow may be broken across fragmentainers at a number of
528+
A <a>fragmented flow</a> may be broken across <a>fragmentainers</a> at a number of
529529
<a href="#possible-breaks">possible break points</a>. In the case of
530530
<a href="#forced-breaks">forced breaks</a>, the UA is required to
531531
break the flow at that point. In the case of
@@ -705,7 +705,7 @@ Unforced Breaks</h3>
705705
<dl>
706706
<dt>Rule 1</dt>
707707
<dd>
708-
A fragmented flow may break at a <a href="#btw-blocks">class A break point</a> only if
708+
A <a>fragmented flow</a> may break at a <a href="#btw-blocks">class A break point</a> only if
709709
all the 'break-after' and 'break-before' values applicable to this
710710
break point allow it, which is when at least one of them forces a
711711
break or when none of them forbid it
@@ -772,7 +772,7 @@ Unforced Breaks</h3>
772772
<h3 id="best-breaks">
773773
Optimizing Unforced Breaks</h3>
774774

775-
<p>While CSS3 requires that a fragmented flow must break at allowed
775+
<p>While CSS3 requires that a <a>fragmented flow</a> must break at allowed
776776
break points in order to avoid overflowing the fragmentainers in its
777777
fragmentation context, it does not define whether content breaks
778778
at a particular <a href="#unforced-breaks">allowed break</a>.

css-break/Overview.html

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@
5454
<div class="head">
5555
<p data-fill-with="logo"><a class="logo" href="http://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/Icons/w3c_home" width="72"> </a> </p>
5656
<h1 class="p-name no-ref" id="title">CSS Fragmentation Module Level 3</h1>
57-
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2015-10-27">27 October 2015</time></span></h2>
57+
<h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2015-12-01">1 December 2015</time></span></h2>
5858
<div data-fill-with="spec-metadata">
5959
<dl>
6060
<dt>This version:
@@ -234,7 +234,7 @@ <h2 class="heading settled" data-level="2" id="fragmentation-model"><span class=
234234
(Descendants of the <a data-link-type="dfn" href="#fragmentation-root">fragmentation root</a> may have other block flow directions,
235235
but fragmentation proceeds according to the block flow direction applied to the <a data-link-type="dfn" href="#fragmentation-root">fragmentation root</a>.)
236236
<dt><dfn data-dfn-type="dfn" data-export="" id="fragmented-flow">fragmented flow<a class="self-link" href="#fragmented-flow"></a></dfn>
237-
<dd> A content flow that is being laid out in a <a data-link-type="dfn" href="#fragmentation-context">fragmentation context</a>.
237+
<dd> Content that is being laid out in a <a data-link-type="dfn" href="#fragmentation-context">fragmentation context</a>.
238238
The <a data-link-type="dfn" href="#fragmented-flow">fragmented flow</a> consists of the content of a (possibly anonymous) box
239239
called the <dfn data-dfn-type="dfn" data-export="" id="fragmentation-root">fragmentation root<a class="self-link" href="#fragmentation-root"></a></dfn>.
240240
<dt><dfn data-dfn-type="dfn" data-export="" id="fragmentation-direction">fragmentation direction<a class="self-link" href="#fragmentation-direction"></a></dfn>
@@ -259,11 +259,11 @@ <h2 class="heading settled" data-level="2" id="fragmentation-model"><span class=
259259
and similarly creates box fragments when it breaks <a href="http://www.w3.org/TR/CSS21/visuren.html#inline-boxes">inline boxes</a> across <a href="http://www.w3.org/TR/CSS21/visuren.html#line-box">line boxes</a>.
260260
However, inline breaking is not covered here; see <a data-link-type="biblio" href="#biblio-css21">[CSS21]</a>/<a data-link-type="biblio" href="#biblio-css3text">[CSS3TEXT]</a>. </p>
261261
<h3 class="heading settled" data-level="2.1" id="parallel-flows"><span class="secno">2.1. </span><span class="content"> Parallel Fragmentation Flows</span><a class="self-link" href="#parallel-flows"></a></h3>
262-
<p> When multiple flows are laid out parallel to each other,
263-
fragmentation is performed independently in each flow.
262+
<p> When multiple <a data-link-type="dfn" href="https://drafts.csswg.org/css-display-3/#formatting-context">formatting contexts</a> are laid out parallel to each other,
263+
fragmentation is performed independently in each <a data-link-type="dfn" href="https://drafts.csswg.org/css-display-3/#formatting-context">formatting context</a>.
264264
For example, if an element is floated,
265265
then a forced break inside the float
266-
will not affect the content wrapping outside the float
266+
will not affect the content outside the float
267267
(except insofar as it may increase the height of the float). </p>
268268
<p> The following are examples of parallel flows
269269
whose contents will fragment independently: </p>
@@ -509,7 +509,7 @@ <h3 class="heading settled" data-level="3.4" id="page-break-properties"><span cl
509509
<td><span class="css">page</span>
510510
</table>
511511
<h2 class="heading settled" data-level="4" id="breaking-rules"><span class="secno">4. </span><span class="content"> Rules for Breaking</span><a class="self-link" href="#breaking-rules"></a></h2>
512-
<p> A fragmented flow may be broken across fragmentainers at a number of <a href="#possible-breaks">possible break points</a>. In the case of <a href="#forced-breaks">forced breaks</a>, the UA is required to
512+
<p> A <a data-link-type="dfn" href="#fragmented-flow">fragmented flow</a> may be broken across <a data-link-type="dfn" href="#fragmentainer">fragmentainers</a> at a number of <a href="#possible-breaks">possible break points</a>. In the case of <a href="#forced-breaks">forced breaks</a>, the UA is required to
513513
break the flow at that point. In the case of <a href="#unforced-breaks">unforced breaks</a>, the UA has to choose
514514
among the possible breaks that are allowed. </p>
515515
<p> To guarantee progress, fragmentainers are assumed to have a minimum <a data-link-type="dfn" href="https://drafts.csswg.org/css-writing-modes-3/#block-size">block size</a> of 1px regardless of their used size. </p>
@@ -613,7 +613,7 @@ <h3 class="heading settled" data-level="4.4" id="unforced-breaks"><span class="s
613613
at a <a href="#possible-breaks">possible break point</a> is allowed: </p>
614614
<dl>
615615
<dt>Rule 1
616-
<dd> A fragmented flow may break at a <a href="#btw-blocks">class A break point</a> only if
616+
<dd> A <a data-link-type="dfn" href="#fragmented-flow">fragmented flow</a> may break at a <a href="#btw-blocks">class A break point</a> only if
617617
all the <a class="property" data-link-type="propdesc" href="#propdef-break-after">break-after</a> and <a class="property" data-link-type="propdesc" href="#propdef-break-before">break-before</a> values applicable to this
618618
break point allow it, which is when at least one of them forces a
619619
break or when none of them forbid it
@@ -650,7 +650,7 @@ <h3 class="heading settled" data-level="4.4" id="unforced-breaks"><span class="s
650650
so that each fragmentainer has a non-zero amount of content,
651651
in order to guarantee progress through the content. </span></p>
652652
<h3 class="heading settled" data-level="4.5" id="best-breaks"><span class="secno">4.5. </span><span class="content"> Optimizing Unforced Breaks</span><a class="self-link" href="#best-breaks"></a></h3>
653-
<p>While CSS3 requires that a fragmented flow must break at allowed
653+
<p>While CSS3 requires that a <a data-link-type="dfn" href="#fragmented-flow">fragmented flow</a> must break at allowed
654654
break points in order to avoid overflowing the fragmentainers in its
655655
fragmentation context, it does not define whether content breaks
656656
at a particular <a href="#unforced-breaks">allowed break</a>.

0 commit comments

Comments
 (0)