[css-inline] Move some paragraphs around. Uncomment the processing model notes, since they might be useful to other people.

Author: fantasai

css-inline/Overview.bs

@@ -349,8 +349,9 @@ This property specifies styling for dropped, raised, and sunken initial letters.
   <dd>This optional second argument argument defines the number of lines the initial letter should sink. Values must be greater than zero. If omitted, it duplicates the first argument, floored to the nearest positive whole number.
 </dl>
 
-An <dfn>initial letter</dfn> is a box to which 'initial-letter' applies
-and is not ''initial-letter/normal'': this triggers the special layout considerations described below.
+An <dfn lt="initial letter | initial letter box">initial letter</dfn> is
+a box to which 'initial-letter' applies and is not ''initial-letter/normal'':
+this triggers the special layout considerations described below.
 
 <div class="example">
   Here are some examples of 'initial-letter' usage:
@@ -380,26 +381,43 @@ and is not ''initial-letter/normal'': this triggers the special layout considera
   <pre>p::first-letter { initial-letter: 2; }</pre>
 </div>
 
+Issue: Define interaction with Ruby. Easiest is to make it not apply to/within ruby.
 
+The 'initial-letter' property does not apply to boxes that are not positioned at the start of the line due to bidi reordering.
 
-<!--
-<h4 id="processing-model">Processing Model</h4>
-
-<ol>
-  <li>Find font size based on alignment points and font metrics. No layout information is required.</li>
-
-  <li>Size content box to fit glyph with no overflow. The content box of a non-atomic inline initial letter is the smallest rectangle required to include the entirety of its glyphs and the margin boxes of any atomic inlines it contains.</li>
+<h4 id="processing-model">Layout Model</h4>
 
-  <li>The initial letter's margin box is placed at the edge of the line. If it has no padding or borders, it is negatively offset by the distance from the start edge of its content box to the point in the content that would have been placed at the start edge of the containing block if it had ''initial-letter: none''.</li>
+An <a>initial letter</a> is laid out following the steps outlined below:
 
-  <li>Exclude content within margin box.</li>
+<ol>
+	<li>Find font size based on 'initial-letter-align' alignment points and font metrics.
+	Note that no layout information is required in this step.
+	The font size used for sizing the <a>initial letter</a> contents <em>does not</em> affect its computed 'font-size' property
+	(and therefore has no effect on the computation of ''em'' length values, etc.).
+
+  <li>Size the <a>initial letter</a>’s content box.
+	The content box of a non-atomic inline initial letter
+	is the smallest rectangle required to include the entirety of its glyphs
+	as well as the margin boxes of any atomic inlines it contains.
+
+  <li>The initial letter's margin box is placed at the edge of the line.
+	If it has no padding or borders, it is negatively offset by the distance
+	from the start edge of its content box to the point in the content that
+	would have been placed at the start edge of the containing block if it had ''initial-letter: none''.
+
+  <li>Exclude content within the inline letter's margin box
+	according to 'initial-letter-wrap'.
 </ol>
- -->
 
+<h4 id="initial-letter-box">
+Content-box Size, Margins, Borders, and Padding</h4>
 
-Issue: Define interaction with Ruby. Easiest is to make it not apply to/within ruby.
+Initial letters can be styled with margins, padding, and borders just like any other box.
+Unless 'initial-letter-align' is ''initial-letter-align/pborder-box'',
+its vertical alignment and sizing are not affected;
+however the effective exclusion area is (and corresponds to the margin area).
 
-The 'initial-letter' property does not apply to boxes that are not positioned at the start of the line due to bidi reordering.
+When padding and borders are zero, the initial letter may be kerned; see below.
 
 <h3 id="aligning-initial-letter">
 Alignment of Initial Letters: the 'initial-letter-align' property</h3>
@@ -461,35 +479,6 @@ If 'initial-letter' is applied to an image or other atomic element that does not
 
 Note: For 'vertical-align', the alignment points of an atomic inline are synthesized from the margin edges. [[CSS3-WRITING-MODES]]
 
-
-
-
-
-
-
-
-
-<h3 id="initial-letter-box">
-Margins, Borders, and Padding</h3>
-
-Initial letters can be styled with margins, padding, and borders just like any other box. Their vertical alignment and sizing is not affected; however the effective exclusion area is (and corresponds to the margin area).
-
-When padding and borders are zero, the initial letter may be kerned; see below.
-
-<h3 id="initial-letter-indentation">
-Indentation and Multi-line Effects</h3>
-
-'text-indent' and 'hanging-punctuation' apply to the first line of text as normal in the presence of initial letters. Lines affected by the exclusion are shortened, as in the presence of floats, and are affected the same way.
-
-If an initial letter is too long to fit on one line, it wraps (according to the usual text-wrapping rules), each line filled and formatted exactly as if it were the first line and the initial letter too long to fit any subsequent normal text. Any normal text after the initial letter starts on its last line, affected exactly as if that line were the first line.
-
-
-<figure>
-  <img alt="multi-line drop cap"  src="images/Multi-line-initial.png" width="300">
-  <p class="caption">Drop cap extends to two lines.</p>
-</figure>
-
-
 <!--
   ]]]]]]]]]]]]
   ]]]]]=======
@@ -720,8 +709,19 @@ Only the first line is moved up against the ink of the initial letter.
 </div>
 
 
+<h3 id="initial-letter-indentation">
+Indentation and Multi-line Effects</h3>
+
+'text-indent' and 'hanging-punctuation' apply to the first line of text as normal in the presence of initial letters. Lines affected by the exclusion are shortened, as in the presence of floats, and are affected the same way.
+
+If an initial letter is too long to fit on one line, it wraps (according to the usual text-wrapping rules), each line filled and formatted exactly as if it were the first line and the initial letter too long to fit any subsequent normal text. Any normal text after the initial letter starts on its last line, affected exactly as if that line were the first line.
 
 
+<figure>
+  <img alt="multi-line drop cap"  src="images/Multi-line-initial.png" width="300">
+  <p class="caption">Drop cap extends to two lines.</p>
+</figure>
+
 
 <h3 id="initial-letter-paragraphs">
 Clearing Initial Letters</h3>