Make new section for defining CSS's notion of first formatted line. Plus lots of typo-level fixes.

Author: fantasai

selectors3/Overview.html

@@ -1441,7 +1441,7 @@ <h4><a name=lang-pseudo>6.6.3. The language pseudo-class :lang</a></h4>
 <p>The difference between <code>:lang(C)</code> and the '|=' operator
 is that the '|=' operator only performs a comparison against a given
 attribute on the element, while the <code>:lang(C)</code> pseudo-class
-uses the UA's knowledge of the document's semantics to perform the
+uses the UAs knowledge of the document's semantics to perform the
 comparison.</p>
 
 <div class=example>
@@ -2010,23 +2010,24 @@ <h4><a name=first-line>7.1. The ::first-line pseudo-element</a></h4>
 paragraph.&lt;/P&gt;
 </pre>
 
+<h5 id="first-formatted-line"><dfn>First formatted line</dfn> definition in CSS</h5>
+
 <p>In CSS, the <code>::first-line</code> pseudo-element can only
 have an effect when attached to a block-like container such as a
 block box, inline-block, table-caption, or table-cell.</p>
 
-<p><a name="first-formatted-line"></a>The "first formatted line" of an
-element may occur inside a
+<p>The first formatted line of an element may occur inside a
 block-level descendant in the same flow (i.e., a block-level
-descendant that is not positioned and not a float). E.g., the first
-line of the <code>div</code> in <code>&lt;DIV>&lt;P>This
-line...&lt;/P>&lt/DIV></code> is the first line of the <code>p</code> (assuming
-that both <code>p</code> and <code>div</code> are block-level).
+descendant that is not positioned and not a float). For example,
+the first line of the <code>DIV</code> in <code>&lt;DIV>&lt;P>This
+line...&lt;/P>&lt/DIV></code> is the first line of the <code>P</code> (assuming
+that both <code>P</code> and <code>DIV</code> are block-level).
 
 <p>The first line of a table-cell or inline-block cannot be the first
 formatted line of an ancestor element. Thus, in <code>&lt;DIV&gt;&lt;P
 STYLE="display: inline-block">Hello&lt;BR&gt;Goodbye&lt;/P&gt;
 etcetera&lt;/DIV&gt;</code> the first formatted line of the
-<code>div</code> is not the line "Hello".
+<code>DIV </code> is not the line "Hello".
 
 <p class="note"><strong>Note:</strong> Note that the first line of the
 <code>p</code> in this fragment: <code>&lt;p&gt&lt;br&gt;First...</code>
@@ -2036,8 +2037,8 @@ <h4><a name=first-line>7.1. The ::first-line pseudo-element</a></h4>
 <p>A UA should act as if the fictional start tags of the
 <code>::first-line</code> pseudo-elements were nested just inside the
 innermost enclosing block-level element. (Since CSS1 and CSS2 were
-silent on this case, authors should not rely on this behavior.) Here
-is an example. The fictional tag sequence for</p>
+silent on this case, authors should not rely on this behavior.)
+For example, the fictional tag sequence for</p>
 
 <pre>
 &lt;DIV>
@@ -2056,8 +2057,8 @@ <h4><a name=first-line>7.1. The ::first-line pseudo-element</a></h4>
 </pre>
 
 <p>The <code>::first-line</code> pseudo-element is similar to an
-inline-level element, but with certain restrictions. In CSS, the
-following properties apply to a <code>::first-line</code>
+inline-level element, but with certain restrictions. The
+following CSS properties apply to a <code>::first-line</code>
 pseudo-element: font properties, color property, background
 properties, 'word-spacing', 'letter-spacing', 'text-decoration',
 'vertical-align', 'text-transform', 'line-height'. UAs may apply other
@@ -2077,7 +2078,7 @@ <h4><a name=first-letter>7.2. The ::first-letter pseudo-element</a></h4>
 letter of the first line of a block, if it is not preceded by any
 other content (such as images or inline tables) on its line. The
 ::first-letter pseudo-element may be used for "initial caps" and "drop
-caps", which are common typographical effects. This type of initial
+caps", which are common typographical effects. In CSS this type of initial
 letter is similar to an inline-level element if its 'float' property
 is 'none'; otherwise, it is similar to a floated element.</p>
 
@@ -2093,7 +2094,7 @@ <h4><a name=first-letter>7.2. The ::first-letter pseudo-element</a></h4>
 
 <div class="example">
 <p>Example:</p>
-<p>This example shows a possible rendering of an initial cap. Note
+<p>This CSS and HTML example shows a possible rendering of an initial cap. Note
 that the 'line-height' that is inherited by the <code>::first-letter</code>
 pseudo-element is 1.1, but the UA in this example has computed the
 height of the first letter differently, so that it doesn't cause any
@@ -2180,8 +2181,9 @@ <h4><a name=first-letter>7.2. The ::first-letter pseudo-element</a></h4>
 money."</p>
 
 <p>In CSS, the <code>::first-letter</code> pseudo-element applies to
-block, list-item, table-cell, table-caption, and inline-block
-elements. <span class="note"><strong>Note:</strong> A future version
+block-like containers such as block, list-item, table-cell, table-caption,
+and inline-block elements.
+<span class="note"><strong>Note:</strong> A future version
 of this specification may allow this pseudo-element to apply to more
 element types.</span></p>
 
@@ -2193,23 +2195,23 @@ <h4><a name=first-letter>7.2. The ::first-letter pseudo-element</a></h4>
 
 <div class="example">
 <p>Example:</p>
-<p>The fictional tag sequence for this HTMLfragment:
+<p>The fictional tag sequence for this HTML fragment:
 <pre>&lt;div>
 &lt;p>The first text.</pre>
 <p>is:
 <pre>&lt;div>
 &lt;p>&lt;div::first-letter>&lt;p::first-letter>T&lt;/...>&lt;/...>he first text.</pre>
 </div>
 
-<p>The first letter of a table-cell or inline-block cannot be the
+<p>In CSS the first letter of a table-cell or inline-block cannot be the
 first letter of an ancestor element. Thus, in <code>&lt;DIV&gt;&lt;P
 STYLE="display: inline-block">Hello&lt;BR&gt;Goodbye&lt;/P&gt;
-etcetera&lt;/DIV&gt;</code> the first letter of the <code>div</code> is not the
-letter "H". In fact, the <code>div</code> doesn't have a first letter.
+etcetera&lt;/DIV&gt;</code> the first letter of the <code>DIV</code> is not the
+letter "H". In fact, the <code>DIV</code> doesn't have a first letter.
 
 <p>The first letter must occur on the <a
 href="#first-formatted-line">first formatted line.</a> For example, in
-this fragment: <code>&lt;p&gt&lt;br&gt;First...</code> the first line
+this HTML fragment: <code>&lt;p&gt&lt;br&gt;First...</code> the first line
 doesn't contain any letters and <code>::first-letter</code> doesn't
 match anything (assuming the default style for <code>br</code> in HTML
 4). In particular, it does not match the "F" of "First."
@@ -2224,25 +2226,25 @@ <h4><a name=first-letter>7.2. The ::first-letter pseudo-element</a></h4>
 
 <div class="example">
 <p>Example:</p>
-<p>After the rule 'p::before {content: "Note: "}', the selector
-'p::first-letter' matches the "N" of "Note".</p>
+<p>After the rule <code>p::before {content: "Note: "}</code>, the selector
+<code>p::first-letter</code> matches the "N" of "Note".</p>
 </div>
 
 <p class="note"><strong>Note:</strong>
-In some cases the ::first-letter pseudo-element should include
+In some cases the <code>::first-letter</code> pseudo-element should include
 more than just the first non-punctuation character on a line.  For
 example, combining characters must be kept with their base character.
 Additionally, some languages may have specific rules about how to
 treat certain letter combinations.  The UA definition of
-::first-letter should include at least the default grapheme cluster as
-defined by UAX29 and may include more than that as appropriate.  In
-Dutch, for example, if the letter combination "ij" appears at the
+<code>::first-letter</code> should include at least the default grapheme
+cluster as defined by UAX29 and may include more than that as appropriate.
+In Dutch, for example, if the letter combination "ij" appears at the
 beginning of an element, both letters should be considered within the
-::first-letter pseudo-element. <a href="#refsUAX29">[UAX29]</a>
+<code>::first-letter</code> pseudo-element. <a href="#refsUAX29">[UAX29]</a>
 
-<p>If the letters that would form the ::first-letter are not in the
+<p>If the letters that would form the <code>::first-letter</code> are not in the
 same element, such as "'T" in <code>&lt;p>'&lt;em>T...</code>, the UA
-may create a ::first-letter pseudo-element from one of the elements,
+may create a <code>::first-letter</code> pseudo-element from one of the elements,
 both elements, or simply not create a pseudo-element.</p>
 
 <p>Similarly, if the first letter(s) of the block are not at the start
@@ -2251,7 +2253,7 @@ <h4><a name=first-letter>7.2. The ::first-letter pseudo-element</a></h4>
 
 <div class="example">
 <p>Example:</p>
-<p><a name="overlapping-example">The following example</a> illustrates
+<p><a name="overlapping-example">The following CSS and HTML example</a> illustrates
 how overlapping pseudo-elements may interact.  The first letter of
 each P element will be green with a font size of '24pt'. The rest of
 the first formatted line will be 'blue' while the rest of the
@@ -2327,9 +2329,9 @@ <h3><a name=descendant-combinators>8.1. Descendant combinator</a></h3>
  <p>represents a <code>p</code> element that is a grandchild or later
  descendant of a <code>div</code> element. Note the whitespace on
  either side of the "*" is not part of the universal selector; the
- whitespace is a combinator indicating that the DIV must be the
+ whitespace is a combinator indicating that the <code>div</code> must be the
  ancestor of some element, and that that element must be an ancestor
- of the P.</p>
+ of the <code>p</code>.</p>
  <p>The following selector, which combines descendant combinators and
  <a href="#attribute-selectors">attribute selectors</a>, represents an
  element that (1) has the <code>href</code> attribute set and (2) is
@@ -2454,7 +2456,7 @@ <h2><a name=w3cselgrammar>10. The grammar of Selectors</a></h2>
 <h3><a name=grammar>10.1. Grammar</a></h3>
 
 <p>The grammar below defines the syntax of Selectors.  It is globally
-LL(1) and can be locally LL(2) (but note that most UA's should not use
+LL(1) and can be locally LL(2) (but note that most UAs should not use
 it directly, since it doesn't express the parsing conventions). The
 format of the productions is optimized for human consumption and some
 shorthand notations beyond Yacc (see <a href="#refsYACC">[YACC]</a>)