Sketch out @hyphenate-resource rule from Oslo F2F notes.

Author: fantasai

css3-text/Overview.html

@@ -90,7 +90,7 @@ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 17 January
     <dt>This version:
 
     <dd><a href="http://dev.w3.org/csswg/css3-text/Overview.html">$Date:
-     2011/01/17 02:25:32 $ (CVS $Revision$)</a> <!--<dd><a
+     2011/01/17 02:30:16 $ (CVS $Revision$)</a> <!--<dd><a
       href="http://www.w3.org/TR/2010/WD-css3-text-20101005/">http://www.w3.org/TR/2010/WD-css3-text-20101005/</a></dd> -->
 
 
@@ -287,6 +287,10 @@ <h2 class="no-num no-toc" id=contents>Table of Contents</h2>
       Hyphenation Line Limits: the &lsquo;<code
       class=property>hyphenate-limit-lines</code>&rsquo; and &lsquo;<code
       class=property>hyphenate-limit-last</code>&rsquo; properties</a>
+
+     <li><a href="#hyphenation-resource"><span class=secno>6.4. </span>
+      Hyphenation Resources: the &lsquo;<code
+      class=css>@hyphenate-resource</code>&rsquo; rule</a>
     </ul>
 
    <li><a href="#wrapping"><span class=secno>7. </span> Text Wrapping</a>
@@ -1713,6 +1717,52 @@ <h3 id=hyphenate-line-limits><span class=secno>6.3. </span> Hyphenation
     </pre>
   </div>
 
+  <h3 id=hyphenation-resource><span class=secno>6.4. </span> Hyphenation
+   Resources: the &lsquo;<code class=css>@hyphenate-resource</code>&rsquo;
+   rule</h3>
+
+  <p>The &lsquo;<code class=css>@hyphenate-resource</code>&rsquo; <a
+   href="http://www.w3.org/TR/CSS21/syndata.html#at-rules">at-rule</a> allows
+   the author to specify hyphenation resources that the UA may use to help it
+   hyphenate text correctly.
+
+  <p>The &lsquo;<code class=css>@hyphenate-resource</code>&rsquo; rule
+   consists of the &lsquo;<code class=css>@hyphenate-resource</code>&rsquo;
+   at-keyword followed by a hyphenation mapping declaration block, which has
+   the same syntax as a declaration block, except that the properties are
+   language codes and the property values are comma-separated lists of
+   &lt;url&gt; component values.
+
+  <p>The author-specified hyphenation resources that apply to the text in an
+   element are the resources given by the last hyphenation mapping
+   declaration whose language code matches the language of the element.
+   Language code matching must be performed using RFC4647 [[!RFC4647]] <span
+   class=issue>explain exactly how</span>.
+
+  <p class=note>Since the last matching declaration takes effect, authors
+   should list the most general mapping first, and the most specific last.
+   Note also that declarations are not concatenated, so if multiple
+   dictionaries are needed, they must be listed completely in each
+   declaration.
+
+  <pre class=example>
+    @hyphenate-resource {
+      en:    url(en-GB.hy);
+      en-US: url(en-US.hy);
+      fr:    url(fr.hy);
+    }
+  </pre>
+
+  <p>The UA may use its own dictionaries in addition to, or in place of,
+   those suggested by the author.
+
+  <p class=issue>Mix in an &lsquo;<code class=css>auto</code>&rsquo; keyword,
+   to specify priority of UA dictionary wrt author dictionary?
+
+  <p class=issue>Use a format specifier, like @font-face?
+
+  <p>UAs are not required to support this at-rule.
+
   <h2 id=wrapping><span class=secno>7. </span> Text Wrapping</h2>
 
   <p>Text wrapping is controlled by the &lsquo;<a href="#text-wrap0"><code
@@ -4596,7 +4646,7 @@ <h4 id=text-emphasis-position><span class=secno>11.2.4. </span> Emphasis
     class=css>below right</code>&rsquo;</dfn>
 
    <dd>Draw marks below the text in horizontal layout, to the right in
-    vertical typographic.
+    vertical typographic mode.
   </dl>
 
   <p class=issue>Do we need to add &lsquo;<code class=css>left</code>&rsquo;
@@ -4959,6 +5009,14 @@ <h3 class=no-num id=recent-changes> Changes from the <a
     &lsquo;<code class=css>ideograph-parenthesis</code>&rsquo; values of
     &lsquo;<a href="#text-autospace0"><code
     class=property>text-autospace</code></a>&rsquo;.
+
+   <li>Copied hyphenation controls over from <a
+    href="http://www.w3.org/TR/css3-gcpm">CSS3 Generated Content for Paged
+    Media Module</a> and updated with feedback from <a
+    href="http://lists.w3.org/Archives/Public/www-style/2010Nov/0241.html">TPAC</a>
+    and <a
+    href="http://lists.w3.org/Archives/Public/www-style/2010Sep/0002.html">Oslo
+    F2F</a>.
   </ul>
 
   <h2 class=no-num id=acknowledgements> Acknowledgements</h2>

css3-text/Overview.src.html

@@ -1167,6 +1167,48 @@ <h3 id="hyphenate-line-limits">
 <!-- -->Antarctica.
       <pre>
     </div>
+    
+  <h3 id="hyphenation-resource">
+    Hyphenation Resources: the ''@hyphenate-resource'' rule</h3>
+    
+  <p>The ''@hyphenate-resource'' <a href="http://www.w3.org/TR/CSS21/syndata.html#at-rules">at-rule</a>
+    allows the author to specify hyphenation resources that the UA
+    may use to help it hyphenate text correctly.
+    
+  <p>The ''@hyphenate-resource'' rule consists of the ''@hyphenate-resource''
+    at-keyword followed by a hyphenation mapping declaration block, which
+    has the same syntax as a declaration block, except that the properties
+    are language codes and the property values are comma-separated lists
+    of &lt;url&gt; component values.
+
+  <p>The author-specified hyphenation resources that apply to the text in
+    an element are the resources given by the last hyphenation mapping
+    declaration whose language code matches the language of the element.
+    Language code matching must be performed using RFC4647 [[!RFC4647]]
+    <span class="issue">explain exactly how</span>.</p>
+    
+  <p class="note">Since the last matching declaration takes effect,
+    authors should list the most general mapping first, and the most
+    specific last. Note also that declarations are not concatenated,
+    so if multiple dictionaries are needed, they must be listed
+    completely in each declaration.</p>
+
+  <pre class="example">
+    @hyphenate-resource {
+      en:    url(en-GB.hy);
+      en-US: url(en-US.hy);
+      fr:    url(fr.hy);
+    }
+  </pre>
+  
+  <p>The UA may use its own dictionaries in addition to, or in place of,
+    those suggested by the author.
+  
+  <p class="issue">Mix in an ''auto'' keyword, to specify priority of
+    UA dictionary wrt author dictionary?</p>
+  <p class="issue">Use a format specifier, like @font-face?</p>
+  
+  <p>UAs are not required to support this at-rule.</p>
 
 <h2 id="wrapping">
   Text Wrapping</h2>
@@ -3491,7 +3533,7 @@ <h4 id="text-emphasis-position">
           vertical typographic mode. This is the default position.</dd>
       <dt><dfn title="text-emphasis:below-right">''below right''</dfn></dt>
         <dd>Draw marks below the text in horizontal layout, to the right in
-          vertical typographic.</dd>
+          vertical typographic mode.</dd>
     </dl>
 
     <p class="issue">Do we need to add ''left'' combinations?</p>
@@ -3784,6 +3826,10 @@ <h3 class="no-num" id="recent-changes">
         'punctuation-trim'.
     <li>Removed ''ideograph-space'' and ''ideograph-parenthesis'' values
         of 'text-autospace'.
+    <li>Copied hyphenation controls over from
+      <a href="http://www.w3.org/TR/css3-gcpm">CSS3 Generated Content for Paged Media Module</a>
+      and updated with feedback from <a href="http://lists.w3.org/Archives/Public/www-style/2010Nov/0241.html">TPAC</a>
+      and <a href="http://lists.w3.org/Archives/Public/www-style/2010Sep/0002.html">Oslo F2F</a>.
   </ul>
 
 <h2 class="no-num" id="acknowledgements">