mid-edit dealing with bikeshed errors

Author: astearns

css-text-4/Overview.bs

@@ -149,7 +149,11 @@ Line Breaking and Word Boundaries</h2>
 <h2 id="wrapping">
 Text Wrapping</h2>
 
-	Text wrapping is controlled by the 'text-wrap' and overflow-wrap properties:
+	Text wrapping is controlled by the 'text-wrap',
+	'wrap-before',
+	'wrap-after',
+	'wrap-inside',
+	and overflow-wrap properties:
 
 	Issue: Add final level 3 overflow-wrap
 
@@ -158,7 +162,7 @@ Text Wrap Settings: the 'text-wrap' property</h3>
 
 	<pre class="propdef">
 	Name: text-wrap
-	Value: normal | nowrap | avoid | balance
+	Value: normal | nowrap | balance
 	Initial: normal
 	Applies to: all elements
 	Inherited: yes
@@ -167,30 +171,23 @@ Text Wrap Settings: the 'text-wrap' property</h3>
 	Media: visual
 	</pre>
 
-	This property specifies the mode for text wrapping. Possible values:
+	This property specifies the mode for text wrapping. 
+	Possible values:
 
 	<dl dfn-for=text-wrap dfn-type=value>
 		<dt><dfn>normal</dfn>
 		<dd>
-			Lines may break at allowed break points, as determined by the
-			line-breaking rules in effect. Line breaking behavior defined
-			for the WJ, ZW, and GL line-breaking classes in
-			[[!UAX14]] must be honored.
+			Lines may break at allowed break points, 
+			as determined by the line-breaking rules in effect. 
+			Line breaking behavior defined
+			for the WJ, ZW, and GL line-breaking classes 
+			in [[!UAX14]] must be honored.
 
 		<dt><dfn>nowrap</dfn>
 		<dd>
 			Lines may not break; text that does not fit within the block container
 			overflows it.
 
-		<dt><dfn>avoid</dfn>
-		<dd>
-			Line breaking is suppressed within the element: the UA may only break
-			within the element if there are no other valid break points in the
-			line. If the text breaks, line-breaking restrictions are honored as for
-			''text-wrap/normal''.
-
-			Issue: Should this maybe be handled by 'break-inside'?
-
 		<dt><dfn>balance</dfn>
 		<dd>
 			Same as ''text-wrap/normal'' for inline-level elements.
@@ -220,46 +217,147 @@ Text Wrap Settings: the 'text-wrap' property</h3>
 
 	</dl>
 
-	Regardless of the 'text-wrap' value, lines always break at forced breaks:
-	for all values, line-breaking behavior defined for the BK, CR, LF, CM
-	NL, and SG line breaking classes in [[!UAX14]] must
-	be honored.
+	Regardless of the 'text-wrap' value, 
+	lines always break at forced breaks:
+	for all values, 
+	line-breaking behavior defined 
+	for the BK, CR, LF, CM NL, and SG line breaking classes 
+	in [[!UAX14]] must be honored.
 
-	When <span class="property">'text-wrap'</span> is set to ''text-wrap/normal'' or
-	''text-wrap/avoid'', UAs that allow breaks at punctuation other than spaces
+	UAs that allow breaks at punctuation other than spaces
 	should prioritize breakpoints.
-	For example, if breaks after slashes have a lower priority than spaces,
-	the sequence “check /etc” will never break between the ‘/’ and the ‘e’.
-	The UA may use the width of the containing block, the text's language,
+	For example, 
+	if breaks after slashes have a lower priority than spaces,
+	the sequence “check /etc” 
+	will never break between the ‘/’ and the ‘e’.
+	The UA may use the width of the containing block, 
+	the text's language,
 	and other factors in assigning priorities.
-	As long as care is taken to avoid such awkward breaks, allowing breaks at
-	appropriate punctuation other than spaces is recommended, as it results
-	in more even-looking margins, particularly in narrow measures.</p>
+	As long as care is taken to avoid such awkward breaks, 
+	allowing breaks at appropriate punctuation other than spaces 
+	is recommended, 
+	as it results in more even-looking margins, 
+	particularly in narrow measures.
 
 	<!-- add a sample prioritization algorithm -->
 
+<h3 id="wrap-before">
+Inline breaks between boxes: the 'wrap-before'/'wrap-after' properties</h3>
+
+	<pre class="propdef">
+	Name: wrap-before, wrap-after
+	Value: auto | avoid | avoid-line | avoid-flex | line | flex
+	Initial: auto
+	Applies to: all elements
+	Inherited: no
+	Percentages: n/a
+	Computed value: as specified
+	Media: visual
+	</pre>
+
+	These properties specify modifications to break opportunities 
+	in line and flex line breaking 
+	Possible values:
+
+	<dl dfn-for=wrap-before dfn-type=value>
+		<dt><dfn>auto</dfn>
+		<dd>
+			Lines may break at allowed break points 
+			before and after the element, 
+			as determined by the line-breaking rules in effect. 
+
+		<dt><dfn>avoid</dfn>
+		<dd>
+			Flex and line breaking is suppressed before/after the element: 
+			the UA may only break before/after the element 
+			if there are no other valid break points 
+			in the line. 
+			If the text breaks, 
+			line-breaking restrictions are honored as for
+			''wrap-before/auto''.
+
+		<dt><dfn>avoid-line</dfn>
+		<dd>
+			Same as ''wrap-before/avoid'', 
+			but only for line breaks.
+
+		<dt><dfn>avoid-flex</dfn>
+		<dd>
+			Same as ''wrap-before/avoid'', 
+			but only for flex breaks.
+
+		<dt><dfn>line</dfn>
+		<dd>
+			Force a line break before/after the element 
+			if this is a valid line break point.
+
+		<dt><dfn>flex</dfn>
+		<dd>
+			Force a flex break before/after the element 
+			if this is a valid flex line break point 
+			and the element is a flex item 
+			in a multi-line flex container.
+
+<h3 id="wrap-inside">
+Line breaks within boxes: the 'wrap-inside' property</h3>
+
+	<pre class="propdef">
+	Name: wrap-inside
+	Value: auto | avoid
+	Initial: auto
+	Applies to: all elements
+	Inherited: no
+	Percentages: n/a
+	Computed value: as specified
+	Media: visual
+	</pre>
+
+	<dl dfn-for=wrap-inside dfn-type=value>
+		<dt><dfn>auto</dfn>
+		<dd>
+			Lines may break at allowed break points 
+			within the element, 
+			as determined by the line-breaking rules in effect. 
+
+		<dt><dfn>avoid</dfn>
+		<dd>
+			Line breaking is suppressed within the element: 
+			the UA may only break within the element 
+			if there are no other valid break points in the line.
+			If the text breaks, 
+			line-breaking restrictions are honored as for
+			''wrap-inside/auto''.
+
+			If elements with ''wrap-inside/avoid'' are nested 
+			and the UA must break within these elements, 
+			a break in an outer element must be used 
+			before a break within an inner element may be used.
+
 <h4 id="example-avoid">
-Example of using 'text-wrap: avoid' in presenting a footer</h4>
+Example of using 'wrap-inside: avoid' in presenting a footer</h4>
 
 	<div class="example">
 
-		The priority of breakpoints can be set to reflect the intended
-		grouping of text.
+		The priority of breakpoints can be set 
+		to reflect the intended grouping of text.
 
 		Given the rules
 
 		<pre>
-			footer { text-wrap: avoid; /* inherits to all descendants */ }
+			footer { wrap-inside: avoid; }
+			venue { wrap-inside: avoid; }
+			date { wrap-inside: avoid; }
+			place { wrap-inside: avoid; }
 		</pre>
 
 		and the following markup:
 
 		<pre>
-			&lt;footer>
-			&lt;venue>27th Internationalization and Unicode Conference&lt;/venue>
-			&amp;#8226; &lt;date>April 7, 2005&lt;/date> &amp;#8226;
-			&lt;place>Berlin, Germany&lt;/place>
-			&lt;/footer>
+			<footer>
+			<venue>27th Internationalization and Unicode Conference</venue>
+			&#8226; <date>April 7, 2005</date> &#8226;
+			<place>Berlin, Germany</place>
+			</footer>
 		</pre>
 
 		In a narrow window the footer could be broken as
@@ -336,7 +434,7 @@ Hyphens: the 'hyphenate-character' property</h3>
 	</pre>
 
 	This property specifies strings that are shown between parts of
-	hyphenated words. The <dfn for=hyphenate-character>''auto''</dfn> value means that the user agent should
+	hyphenated words. The <dfn for=hyphenate-character>auto</dfn> value means that the user agent should
 	find an appropriate value, preferably from the same source as the
 	hyphenation dictionary. If a string is specified, it appears at
 	the end of the line before a hyphenation break.
@@ -402,12 +500,14 @@ Hyphenation Character Limits: the 'hyphenate-limit-chars' property</h3>
 	the minimum for characters before the hyphenation point, and
 	the third value is the minimum for characters after the hyphenation
 	point. If the third value is missing, it is the same as the second.
-	If the second value is missing, then it is ''auto''. The ''auto''
+	If the second value is missing, 
+	then it is ''hyphenate-limit-chars/auto''. 
+	The ''hyphenate-limit-chars/auto''
 	value means that the UA chooses a value that adapts to the current
 	layout.
 
 	<p class="note">Unless the UA is able to calculate a better value, it
-		is suggested that ''auto'' means 2 for before and after, and 5 for
+		is suggested that ''hyphenate-limit-chars/auto'' means 2 for before and after, and 5 for
 		the word total.
 
 	<div class="example">
@@ -532,7 +632,7 @@ Alignment and Justification</h2>
 <h3 id="character-alignment">
 Character-based Alignment in a Table Column</h3>
 
-	When multiple cells in a column have an <i>alignment character</i> specified,
+	When multiple cells in a column have an alignment character specified,
 	the alignment character of each such cell in the column is centered along
 	a single column-parallel axis and the rest of the text in the column
 	shifted accordingly. (Note that the strings do not have to be the same
@@ -693,14 +793,14 @@ Character Class Spacing: the 'text-spacing' property</h3>
 		<dt><dfn>ideograph-alpha</dfn>
 		<dd>
 			Creates 1/4em extra spacing between runs of
-			<i>ideographs</i> and <i>non-ideographic letters</i>.
+			<a>ideographs</a> and <a>non-ideographic letters</a>.
 
 			Note: A commonly used algorithm for determining this behavior is specified in [[JLREQ]].
 
 		<dt><dfn>ideograph-numeric</dfn>
 		<dd>
 			Creates 1/4em extra spacing between runs of
-			<i>ideographs</i> and <i>non-ideographic numerals</i> glyphs.
+			<a>ideographs</a> and <a>non-ideographic numerals</a> glyphs.
 
 			Note: A commonly used algorithm for determining this behavior is specified in [[JLREQ]].
 
@@ -716,36 +816,36 @@ Character Class Spacing: the 'text-spacing' property</h3>
 
 		<dt><dfn>space-start</dfn>
 		<dd>
-			Set <i>fullwidth opening punctuation</i> with full-width glyphs (spaced)
+			Set <a>fullwidth opening punctuation</a> with full-width glyphs (spaced)
 			at the start of each line.
 
 		<dt><dfn>trim-start</dfn>
 		<dd>
-			Set <i>fullwidth opening punctuation</i> with half-width glyphs (flush)
+			Set <a>fullwidth opening punctuation</a> with half-width glyphs (flush)
 			at the start of each line.
 
 		<dt><dfn>allow-end</dfn>
 		<dd>
-			Set <i>fullwidth closing punctuation</i> with half-width glyphs (flush)
+			Set <a>fullwidth closing punctuation</a> with half-width glyphs (flush)
 			at the end of each line
 			if it does not otherwise fit prior to justification;
 			otherwise set the punctuation with full-width glyphs.
 
 		<dt><dfn>space-end</dfn>
 		<dd>
-			Set <i>fullwidth opening punctuation</i> with full-width glyphs (spaced)
+			Set <a>fullwidth opening punctuation</a> with full-width glyphs (spaced)
 			at the start of each line.
 
 		<dt><dfn>trim-end</dfn>
 		<dd>
-			Set <i>fullwidth closing punctuation</i> with half-width glyphs (flush)
+			Set <a>fullwidth closing punctuation</a> with half-width glyphs (flush)
 			at the end of each line.
 
 		<dt><dfn>space-adjacent</dfn>
 		<dd>
-			Set <i>fullwidth opening punctuation</i> with full-width glyphs (spaced)
+			Set <a>fullwidth opening punctuation</a> with full-width glyphs (spaced)
 			when not at the start of the line.
-			Set <i>fullwidth closing punctuation</i> with full-width glyphs (spaced)
+			Set <a>fullwidth closing punctuation</a> with full-width glyphs (spaced)
 			when not at the end of the line.
 
 		<dt><dfn>trim-adjacent</dfn>
@@ -827,19 +927,19 @@ Fullwidth Punctuation Collapsing</h4>
 
 	<ul>
 		<li>
-			Set <i>fullwidth opening punctuation</i> half-width if the previous character is
-			a <i>fullwidth opening punctuation</i>,
-			<i>fullwidth middle dot punctuation</i>,
+			Set <a>fullwidth opening punctuation</a> half-width if the previous character is
+			a <a>fullwidth opening punctuation</a>,
+			<a>fullwidth middle dot punctuation</a>,
 			or ideographic space (U+3000).
 			Else set it full-width.
 		<li>
-			Set <i>fullwidth closing punctuation</i> half-width if the next character is
-			a <i>fullwidth closing punctuation</i>,
-			<i>fullwidth middle dot punctuation</i>,
+			Set <a>fullwidth closing punctuation</a> half-width if the next character is
+			a <a>fullwidth closing punctuation</a>,
+			<a>fullwidth middle dot punctuation</a>,
 			or ideographic space (U+3000).
 			Else set it full-width.
 		<li>
-			Set <i>fullwidth closing punctuation</i> followed by <i>fullwidth opening punctuation</i>
+			Set <a>fullwidth closing punctuation</a> followed by <a>fullwidth opening punctuation</a>
 			each at "3/4-width", i.e. halfway between full-width and half-width.
 	</ul>
 
@@ -897,7 +997,7 @@ Text Spacing Character Classes</h4>
 				<li>All characters that belongs to Han Unicode Script Property [[!UAX24]].
 			</ul>
 
-		<dt><dfn>ion-ideographic letters</dfn>
+		<dt><dfn>non-ideographic letters</dfn>
 		<dd>
 			Includes all typographic character units that
 			belong to Unicode Letters [L*] and Mark [M*] category,
@@ -923,16 +1023,16 @@ Text Spacing Character Classes</h4>
 		<dt><dfn>fullwidth opening punctuation</dfn>
 		<dd>
 			Includes any opening punctuation character (Unicode category <code>Ps</code>)
-			that belongs to the <i>CJK Symbols and Punctuation</i> block (U+3000&#8211;U+303F)
-			or is categorized as <i>East Asian Fullwidth (F)</i> by [[!UAX11]].
+			that belongs to the <a>CJK Symbols and Punctuation</a> block (U+3000&#8211;U+303F)
+			or is categorized as <a>East Asian Fullwidth (F)</a> by [[!UAX11]].
 			Also includes LEFT SINGLE QUOTATION MARK (U+2018) and LEFT DOUBLE QUOTATION MARK (U+201C).
 			When trimmed, the left (for horizontal text) or top (for vertical text) half is kerned.
 
 		<dt><dfn>fullwidth closing punctuation</dfn>
 		<dd>
 			Includes any closing punctuation character (Unicode category <code>Pe</code>)
-			that belongs to the <i>CJK Symbols and Punctuation</i> block (U+3000&#8211;U+303F)
-			or is categorized as <i>East Asian Fullwidth (F)</i> by [[!UAX11]].
+			that belongs to the <a>CJK Symbols and Punctuation</a> block (U+3000&#8211;U+303F)
+			or is categorized as <a>East Asian Fullwidth (F)</a> by [[!UAX11]].
 			Also includes RIGHT SINGLE QUOTATION MARK (U+2019) and RIGHT DOUBLE QUOTATION MARK (U+201D).
 			May also include fullwidth colon punctuation and/or fullwidth dot punctuation (see below).
 			When trimmed, the right (for horizontal text) or bottom (for vertical text) half is kerned.