Improve organization of vertical-font-features section.

Author: fantasai

css3-writing-modes/Overview.html

@@ -1822,36 +1822,45 @@ <h3 id=text-orientation><span class=secno>5.1. </span> Orienting Text: the
   <h4 id=vertical-font-features><span class=secno>5.1.1. </span> Vertical
    Typesetting and Font Features</h4>
 
-  <p>Vertical font metrics are used to set upright characters in &lsquo;<a
-   href="#mixed-right"><code class=css>mixed-right</code></a>&rsquo; and
-   &lsquo;<a href="#upright"><code class=css>upright</code></a>&rsquo; modes.
-   The UA must synthesize vertical font metrics for fonts that lack them.
-   (This specification does not define heuristics for synthesizing such
-   metrics.) Additionally, font features (such as alternate glyphs) intended
-   for use in vertical typesetting must be used. (E.g. the OpenType
-   &lsquo;<code class=css>vert</code>&rsquo; feature must be enabled.)
-
-  <p>Characters from horizontal shaping scripts (such as Arabic) are shaped
-   in their isolated forms when typeset upright.
-
-  <p>For sideways characters in &lsquo;<a href="#mixed-right"><code
-   class=css>mixed-right</code></a>&rsquo; and &lsquo;<a
-   href="#upright"><code class=css>upright</code></a>&rsquo; modes, vertical
-   typesetting features are not used. However, if the font has features meant
-   to be enabled for sideways text that is typeset in vertical lines, those
-   features and tables are used.
-
-  <p>In the &lsquo;<a href="#sideways"><code
-   class=css>sideways</code></a>&rsquo;, &lsquo;<a
-   href="#sideways-right"><code class=css>sideways-right</code></a>&rsquo;,
-   and &lsquo;<a href="#sideways-left"><code
-   class=css>sideways-left</code></a>&rsquo; modes, text is typeset using
-   horizontal font metrics and the normal set of features used for horizontal
-   text runs. Vertical metrics, vertical glyph variations, and any other
-   features meant for text typeset in vertical lines are <em>not</em> used.
-
-  <p class=issue>This section needs additional reworking. Suggestions are
-   welcome. <!-- random notes
+  <p>When typesetting text in vertical writing modes:
+
+  <ul>
+   <li>Upright characters in &lsquo;<a href="#mixed-right"><code
+    class=css>mixed-right</code></a>&rsquo; and &lsquo;<a
+    href="#upright"><code class=css>upright</code></a>&rsquo; modes are
+    typeset with vertical font metrics. The UA must synthesize vertical font
+    metrics for fonts that lack them. (This specification does not define
+    heuristics for synthesizing such metrics.) Additionally, font features
+    (such as alternate glyphs) intended for use in vertical typesetting must
+    be used. (E.g. the OpenType &lsquo;<code class=css>vert</code>&rsquo;
+    feature must be enabled.) Furthermore, characters from horizontal cursive
+    scripts (such as Arabic) are shaped in their isolated forms when typeset
+    upright.
+
+   <li>Sideways characters in &lsquo;<a href="#mixed-right"><code
+    class=css>mixed-right</code></a>&rsquo; and &lsquo;<a
+    href="#upright"><code class=css>upright</code></a>&rsquo; modes are
+    typeset with horizontal metrics, and vertical typesetting features are
+    not used. However, if the font has features meant to be enabled for
+    sideways text that is typeset in vertical lines (e.g. to adjust brush
+    stroke angles or alignment), those features are used.
+    <p class=issue>Propose &lsquo;<code class=property>svrt</code>&rsquo; as
+     an OpenType substitution feature that is applied to rotated horizontal
+     text in vertical text runs, to handle these cases.
+
+   <li>All text in &lsquo;<a href="#sideways"><code
+    class=css>sideways</code></a>&rsquo;, &lsquo;<a
+    href="#sideways-right"><code class=css>sideways-right</code></a>&rsquo;,
+    and &lsquo;<a href="#sideways-left"><code
+    class=css>sideways-left</code></a>&rsquo; modes is typeset using
+    horizontal font metrics and the normal set of features used for
+    horizontal text runs. Vertical metrics, vertical glyph variations, and
+    any other features meant for text typeset in vertical lines are
+    <em>not</em> used.
+  </ul>
+
+  <p class=issue>This section needs additional work. Suggestions are welcome.
+   <!-- random notes
   Property to customize text-orientation (and line breaking class) of various
   characters (yes, the name is horrible, we need a better one):
     text-symbolize: latin ||
@@ -3743,10 +3752,6 @@ <h2 class=no-num id=vertical-typesetting-details>Appendix C: Vertical
      responsibility of the font system. They do not determine categorization
      or orientation.
 
-    <p class=issue>Propose &lsquo;<code class=property>svrt</code>&rsquo; as
-     an OpenType substitution feature that is applied to rotated horizontal
-     text in vertical text runs, to handle these cases.
-
     <div class=note> This category is expected to include:
      <ul>
       <li>All East Asian fullwidth (F) and wide (W) characters except

css3-writing-modes/Overview.src.html

@@ -1288,27 +1288,36 @@ <h3 id="text-orientation">
 <h4 id=vertical-font-features>
 Vertical Typesetting and Font Features</h4>
 
-  <p>Vertical font metrics
-    are used to set upright characters in ''mixed-right'' and ''upright'' modes.
-    The UA must synthesize vertical font metrics for fonts that lack them.
-    (This specification does not define heuristics for synthesizing such metrics.)
-    Additionally, font features (such as alternate glyphs) intended
-    for use in vertical typesetting must be used.
-    (E.g. the OpenType ''vert'' feature must be enabled.)
-  <p>Characters from horizontal shaping scripts (such as Arabic)
-    are shaped in their isolated forms when typeset upright.
-  <p>For sideways characters in ''mixed-right'' and ''upright'' modes, vertical
-    typesetting features are not used.
-    However, if the font has features meant to be enabled
-    for sideways text that is typeset in vertical lines,
-    those features and tables are used.
-  <p>In the ''sideways'', ''sideways-right'', and ''sideways-left'' modes,
-    text is typeset using horizontal font metrics and the normal set of features
-    used for horizontal text runs.
-    Vertical metrics, vertical glyph variations, and any other features meant
-    for text typeset in vertical lines are <em>not</em> used.
-
-  <p class=issue>This section needs additional reworking. Suggestions are welcome.
+  <p>When typesetting text in vertical writing modes:
+  
+  <ul>
+    <li>Upright characters in ''mixed-right'' and ''upright'' modes are
+      typeset with vertical font metrics.
+      The UA must synthesize vertical font metrics for fonts that lack them.
+      (This specification does not define heuristics for synthesizing such metrics.)
+      Additionally, font features (such as alternate glyphs) intended
+      for use in vertical typesetting must be used.
+      (E.g. the OpenType ''vert'' feature must be enabled.)
+      Furthermore, characters from horizontal cursive scripts (such as Arabic)
+      are shaped in their isolated forms when typeset upright.
+    <li>Sideways characters in ''mixed-right'' and ''upright'' modes are
+      typeset with horizontal metrics,
+      and vertical typesetting features are not used.
+      However, if the font has features meant to be enabled
+      for sideways text that is typeset in vertical lines
+      (e.g. to adjust brush stroke angles or alignment),
+      those features are used.
+      <p class="issue">Propose 'svrt' as an OpenType substitution feature
+      that is applied to rotated horizontal text in vertical text runs,
+      to handle these cases.
+    <li>All text in ''sideways'', ''sideways-right'', and ''sideways-left'' modes is
+      typeset using horizontal font metrics and the normal set of features
+      used for horizontal text runs.
+      Vertical metrics, vertical glyph variations, and any other features meant
+      for text typeset in vertical lines are <em>not</em> used.
+  </ul>
+
+  <p class=issue>This section needs additional work. Suggestions are welcome.
 
 <!-- random notes
   Property to customize text-orientation (and line breaking class) of various
@@ -2782,9 +2791,6 @@ <h2 id="vertical-typesetting-details" class="no-num">Appendix C:
       and alignment, that are not fundamental to the character's form,
       are the responsibility of the font system.
       They do not determine categorization or orientation.
-      <p class="issue">Propose 'svrt' as an OpenType substitution feature
-      that is applied to rotated horizontal text in vertical text runs,
-      to handle these cases.
       <div class=note>
         This category is expected to include:
         <ul>