Added example with two ways to vertically align text in a P to the bottom of the P.

Author: bert-github

css3-layout/Overview.src.html

@@ -554,6 +554,27 @@ <h3>Summary and examples</h3>
 on slot c.
 </div>
 
+<div class=example>
+<p>This example shows two [three] ways to align the contents of a
+fixed-height paragraph to the bottom of the box:
+
+<dl>
+<dt>Method 1 <dd>
+<pre>P {height: 20em; grid: "." "*" fit-content}</pre>
+<dt>Method 2 <dd>
+<pre>P {height: 20em; grid: "*"}
+P::slot(*) {vertical-align: bottom}</pre>
+<dt>[Method 3] <dd class=issue>
+<pre>P {height: 20em; vertical-align: bottom}</pre>
+</dl>
+
+<p>However, the styles differ in case the content is taller than 20 em
+and overflows: the first style has a baseline-aligned content which
+will thus overflow <em>below</em> the element's box; the second
+example has bottom-aligned content, which will thus overflow
+<em>above</em> the element's box.
+</div>
+
 <!--=================================================================-->
 
 <h3 id=dependencies>Dependencies on other modules</h3>
@@ -988,54 +1009,25 @@ <h3 id=grid-row-sizes >Specifying the height of rows: 'grid-rows'</h3>
 
 <table class=propdef>
 <tbody>
-<tr>
-<th>Name:
-<td><dfn>grid-rows</dfn>
-
-<tr>
-<th><a href="#values" >Value</a>:
-<td>auto | <var>&lt;row-height&gt;</var>+
-
-<tr>
-<th>Initial:
-<td>auto
-
-<tr>
-<th>Applies to:
-<td><span>block container</span> elements
-
-<tr>
-<th>Inherited:
-<td>no
-
-<tr>
-<th>Animatable:
-<td>yes, between grids with the same number of tracks
-
-<tr>
-<th>Percentages:
-<td>N/A
-
-<tr>
-<th>Media:
-<td>visual
-
-<tr>
-<th>Computed&nbsp;value:
-<td>specified value
-
-<tr>
-<th>Canonical order:
-<td><abbr title="follows order of property value definition">per
-grammar</abbr>
+<tr><th>Name: <td><dfn>grid-rows</dfn>
+<tr><th><a href="#values" >Value</a>: <td>auto | <var>&lt;row-height&gt;</var>+
+<tr><th>Initial: <td>auto
+<tr><th>Applies to: <td><span>block container</span> elements
+<tr><th>Inherited: <td>no
+<tr><th>Animatable: <td>yes, between grids with the same number of tracks
+<tr><th>Percentages: <td>N/A
+<tr><th>Media: <td>visual
+<tr><th>Computed&nbsp;value: <td>specified value
+<tr><th>Canonical order: <td><abbr title="follows order of property
+value definition">per grammar</abbr>
 </table>
 
 <p>The 'grid-rows' property specifies the heights of the rows of a
 grid.
 
 <pre class=prod>
 <dfn>&lt;row-height&gt;</dfn> = <var>&lt;length&gt;</var> | <var>&lt;percentage&gt;</var> | * | <var>&lt;fraction&gt;</var> |
-  <var>&lt;minmax&gt;</var> | min-content | max-content | auto
+  <var>&lt;minmax&gt;</var> | min-content | max-content | fit-content
 <dfn>&lt;minmax&gt;</dfn> = minmax( <var>&lt;row-height&gt;</var> , <var>&lt;row-height&gt;</var> )
 </pre>
 
@@ -1090,7 +1082,7 @@ <h3 id=grid-row-sizes >Specifying the height of rows: 'grid-rows'</h3>
 is ignored and ''minmax(<var>p</var>,<var>q</var>)'' is treated as
 'minmax(<var>p</var>,<var>p</var>)'.
 
-<dt>auto
+<dt>fit-content
 <dd>
 Equivalent to 'minmax(min-content, max-content)'.
 </dl>
@@ -2461,9 +2453,40 @@ <h2 id=region-based>Styling the contents of slots: '::flow()'</h2>
 that is inside slot a (similar to how '::first-line' selects the part
 of an element that is on the first line).
 
-<p>Inherited properties&hellip;
+<div class=example>
+<p>For example, this selector selects (the part of) a P that has been
+flowed into a slot called c:
+
+<pre>P::flow(b) { color: yellow }</pre>
+</div>
+
+<p>Only the following properties apply to the ''flow()''
+pseudo-element:… [not display, position, flow, float]
+
+<p>Inherited properties… [inherit from the document tree, not from the
+pseudo-element]
+
+<p>Non-inherited properties… 
 
-<p>Non-inherited properties&hellip;
+<div class=issue>
+<p>The css3-regions draft proposes a different notation, with an
+at-rule for styling (the parts of) elements that are inside the
+pseudo-element of another element:
+
+<pre>@region BODY::slot(c) { P { color: yellow } }
+@region P::first-line { EM { font-weight: normal } }</pre>
+
+<p>Another possibility is to allow selectors to have parts after the
+pseudo-element:
+
+<pre>BODY::slot(c) P { color: yellow }
+P::first-line EM { font-weight: normal }</pre>
+
+<p>Yet another possibility is a generic 'region()' pseudo-element:
+
+<pre>P::region(BODY::slot(c)) { color: yellow }
+EM::region(P::first-line) { font-weight: normal }</pre>
+</div>
 </div>
 
 <!--=================================================================-->
@@ -4015,9 +4038,7 @@ <h4>''fit-content'' vs ''auto'' vs&hellip;</h4>
 <p>''fit-content'' in the Box Module is defined as something else, viz.,
 min(max(available width, ''min-content''), ''max-content'')).
 
-<p>In this specification, ''auto'' (not ''fit-content'') is allowed
-for column and row sizes and has the meaning of ''minmax(min-content,
-max-content)''.
+<p>An alternative name could be ''auto''.
 
 <!--=================================================================-->