W3C home > Mailing lists > Public > public-css-commits@w3.org > February 2011

csswg/css3-text Overview.html,1.44,1.45 Overview.src.html,1.139,1.140

From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
Date: Tue, 08 Feb 2011 23:14:50 +0000
To: public-css-commits@w3.org
Message-Id: <E1Pmwlm-0004li-Pq@lionel-hutz.w3.org>
Update of /sources/public/csswg/css3-text
In directory hutz:/tmp/cvs-serv18316

Modified Files:
	Overview.html Overview.src.html 
Log Message:
Add hyphenate-resource property, so that howcome can't object to updating the official WD

Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.html,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -d -r1.44 -r1.45
--- Overview.html	8 Feb 2011 01:31:03 -0000	1.44
+++ Overview.html	8 Feb 2011 23:14:48 -0000	1.45
@@ -90,7 +90,7 @@
     <dt>This version:
 
     <dd><a href="http://dev.w3.org/csswg/css3-text/Overview.html">$Date:
-     2011/02/04 20:01:30 $ (CVS $Revision$)</a> <!--<dd><a
+     2011/02/08 01:31:03 $ (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> -->
      
 
@@ -297,8 +297,19 @@
       class=property>hyphenate-limit-last</code>&rsquo; properties</a>
 
      <li><a href="#hyphenation-resource"><span class=secno>6.5. </span>
-      Hyphenation Resources: the &lsquo;<code
-      class=css>@hyphenate-resource</code>&rsquo; rule</a>
+      Hyphenation Resources</a>
+      <ul class=toc>
+       <li><a href="#at-hyphenate-resource"><span class=secno>6.5.1.
+        </span>the &lsquo;<code class=css>@hyphenate-resource</code>&rsquo;
+        rule </a>
+
+       <li><a href="#the-hyphenate-resource"><span class=secno>6.5.2.
+        </span>The &lsquo;<code
+        class=property>hyphenate-resource</code>&rsquo; property</a>
+
+       <li><a href="#hyphenation-issue"><span class=secno>6.5.3.
+        </span>Hyphenation Resource Issue</a>
+      </ul>
     </ul>
 
    <li><a href="#wrapping"><span class=secno>7. </span> Text Wrapping</a>
@@ -1859,26 +1870,32 @@
   </div>
 
   <h3 id=hyphenation-resource><span class=secno>6.5. </span> Hyphenation
-   Resources: the &lsquo;<code class=css>@hyphenate-resource</code>&rsquo;
-   rule</h3>
+   Resources</h3>
 
-  <p>The &lsquo;<code class=css>@hyphenate-resource</code>&rsquo; <a
+  <h4 id=at-hyphenate-resource><span class=secno>6.5.1. </span>the &lsquo;<a
+   href="#hyphenate-resource"><code
+   class=css>@hyphenate-resource</code></a>&rsquo; rule</h4>
+
+  <p>The &lsquo;<a href="#hyphenate-resource"><code
+   class=css>@hyphenate-resource</code></a>&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 indicating the location of author-suggested
-   hyphenation resources ordered from most to least preferred. The keyword
-   value &lsquo;<code class=css>local</code>&rsquo; may be used in place of
-   one of the &lt;url&gt; values to suggest the use of a local (UA-provided)
-   hyphenation resource. If the &lsquo;<code class=css>local</code>&rsquo;
-   value is missing, it is assumed to be the first (most-preferred) resource
-   in the list.
+  <p>The &lsquo;<a href="#hyphenate-resource"><code
+   class=css>@hyphenate-resource</code></a>&rsquo; rule consists of the
+   &lsquo;<a href="#hyphenate-resource"><code
+   class=css>@hyphenate-resource</code></a>&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
+   indicating the location of author-suggested hyphenation resources ordered
+   from most to least preferred. The keyword value &lsquo;<code
+   class=css>local</code>&rsquo; may be used in place of one of the
+   &lt;url&gt; values to suggest the use of a local (UA-provided) hyphenation
+   resource. If the &lsquo;<code class=css>local</code>&rsquo; value is
+   missing, it is assumed to be the first (most-preferred) resource in the
+   list.
 
   <p>The hyphenation resource list that applies to the text in an element is
    the one given by the last hyphenation mapping declaration whose language
@@ -1919,6 +1936,134 @@
 
   <p>UAs are not required to support this at-rule.
 
+  <h4 id=the-hyphenate-resource><span class=secno>6.5.2. </span>The &lsquo;<a
+   href="#hyphenate-resource"><code
+   class=property>hyphenate-resource</code></a>&rsquo; property</h4>
+
+  <table class=propdef>
+   <tbody>
+    <tr>
+     <th>Name:
+
+     <td><dfn id=hyphenate-resource>hyphenate-resource</dfn>
+
+    <tr>
+     <th>Value:
+
+     <td>none | &lt;uri&gt; [, &lt;uri&gt; ]*
+
+    <tr>
+     <th>Initial:
+
+     <td>none
+
+    <tr>
+     <th>Applies to:
+
+     <td>all elements
+
+    <tr>
+     <th>Inherited:
+
+     <td>yes
+
+    <tr>
+     <th>Percentages:
+
+     <td>N/A
+
+    <tr>
+     <th>Media:
+
+     <td>visual
+
+    <tr>
+     <th>Computed&nbsp;value:
+
+     <td>specified value
+  </table>
+
+  <p>This property specifies a comma-separated list of external resources
+   that can help the UA determine hyphenation points. If more than one
+   resource is specified, the UA should consult each resource &ndash; in
+   turn, from the beginning &ndash; until it finds one that is able to
+   determine hyphenation points in a word. The &lsquo;<code
+   class=property>none</code>&rsquo; value indicates that no external
+   resources are available. In any case, the UA can also use local resources
+   not listed on this property.
+
+  <div class=example>
+   <p>Often, finding the right hyphenate resource is based on knowing the
+    language of the text. The <code>lang</code> attribute is recommended for
+    encoding the language, and the corresponding selector is used in this
+    example:
+
+   <pre>
+<!-- -->:lang(dk) { hyphenate-resource: url("hyph_da_DK.dic"), url("hyph_da_NO.dic") }
+      </pre>
+  </div>
+
+  <p>UAs are not required to support this property.
+
+  <h4 id=hyphenation-issue><span class=secno>6.5.3. </span>Hyphenation
+   Resource Issue</h4>
+
+  <div class=issue>
+   <p>&lsquo;<a href="#hyphenate-resource"><code
+    class=property>hyphenate-resource</code></a>&rsquo; and &lsquo;<a
+    href="#hyphenate-resource"><code
+    class=css>@hyphenate-resource</code></a>&rsquo; are both proposed to
+    solve the same problem; only one is needed.</p>
+
+   <dl>
+    <dt>advantages of &lsquo;<a href="#hyphenate-resource"><code
+     class=css>@hyphenate-resource</code></a>&rsquo;
+
+    <dd>
+     <ul>
+      <li>Minimal data storage (set per-language, not per-element).
+
+      <li>Requires language-tagging, which also enables the correct use of
+       local dictionaries (and can also trigger other typographic
+       improvements).
+
+      <li>Can use RFC4647 language-mapping, which is more intelligent than
+       :lang()'s prefix-matching. (Could also argue that :lang() should use
+       RFC4647.)
+     </ul>
+
+    <dt>disadvantages of &lsquo;<a href="#hyphenate-resource"><code
+     class=css>@hyphenate-resource</code></a>&rsquo;
+
+    <dd>
+     <ul>
+      <li>Requires language-tagging; cannot select on any other criteria.
+       Variations in hyphenation rules within the same language in a given
+       document will require use of subtags.
+     </ul>
+
+    <dt>advantages of &lsquo;<a href="#hyphenate-resource"><code
+     class=property>hyphenate-resource</code></a>&rsquo;
+
+    <dd>
+     <ul>
+      <li>Can use any selector, not just language-mapping.
+
+      <li>Implemented in Prince.
+     </ul>
+
+    <dt>disadvantages of &lsquo;<a href="#hyphenate-resource"><code
+     class=property>hyphenate-resource</code></a>&rsquo;
+
+    <dd>
+     <ul>
+      <li>Requires per-element data storage.
+     </ul>
+   </dl>
+
+   <p>Feedback on this issue is requested.</p>
+  </div>
+
   <h2 id=wrapping><span class=secno>7. </span> Text Wrapping</h2>
 
   <p>Text wrapping is controlled by the &lsquo;<a href="#text-wrap0"><code
@@ -5501,6 +5646,21 @@
      <td>visual
 
     <tr valign=baseline>
+     <td><a class=property href="#hyphenate-resource">hyphenate-resource</a>
+
+     <td>none | &lt;uri&gt; [, &lt;uri&gt; ]*
+
+     <td>none
+
+     <td>all elements
+
+     <td>yes
+
+     <td>N/A
+
+     <td>visual
+
+    <tr valign=baseline>
      <td><a class=property href="#hyphens0">hyphens</a>
 
      <td>none | manual | auto | all
@@ -6086,6 +6246,9 @@
    <li>hyphenate-limit-lines, <a href="#hyphenate-limit-lines"
     title=hyphenate-limit-lines><strong>6.4.</strong></a>
 
+   <li>hyphenate-resource, <a href="#hyphenate-resource"
+    title=hyphenate-resource><strong>6.5.2.</strong></a>
+
    <li>hyphens, <a href="#hyphens0" title=hyphens><strong>6.1.</strong></a>
 
    <li>letter-spacing, <a href="#letter-spacing0"

Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.src.html,v
retrieving revision 1.139
retrieving revision 1.140
diff -u -d -r1.139 -r1.140
--- Overview.src.html	8 Feb 2011 01:31:03 -0000	1.139
+++ Overview.src.html	8 Feb 2011 23:14:48 -0000	1.140
@@ -1270,7 +1270,8 @@
     </div>
 
   <h3 id="hyphenation-resource">
-    Hyphenation Resources: the ''@hyphenate-resource'' rule</h3>
+    Hyphenation Resources</h3>
+  <h4 id="at-hyphenate-resource">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
@@ -1323,6 +1324,92 @@
 
   <p>UAs are not required to support this at-rule.</p>
 
+  <h4 id="the-hyphenate-resource">The 'hyphenate-resource' property</h4>
+
+    <table class=propdef>
+      <tr>
+        <th>Name: 
+        <td><dfn>hyphenate-resource</dfn>
+      <tr>
+        <th>Value: 
+        <td>none | &lt;uri&gt; [, &lt;uri&gt; ]*
+      <tr>
+        <th>Initial: 
+        <td>none
+      <tr>
+        <th>Applies to: 
+        <td>all elements
+      <tr>
+        <th>Inherited: 
+        <td>yes
+      <tr>
+        <th>Percentages: 
+        <td>N/A
+      <tr>
+        <th>Media: 
+        <td>visual
+      <tr>
+        <th>Computed&nbsp;value: 
+        <td>specified value
+    </table>
+
+    <p>This property specifies a comma-separated list of external resources
+     that can help the UA determine hyphenation points. If more than one
+     resource is specified, the UA should consult each resource &ndash;
+     in turn, from the beginning &ndash; until it finds one that is able to
+     determine hyphenation points in a word. The 'none' value indicates that
+     no external resources are available. In any case, the UA can also use
+     local resources not listed on this property.
+
+    <div class="example">
+      <p>Often, finding the right hyphenate resource is based on knowing the
+      language of the text. The <code>lang</code> attribute is recommended
+      for encoding the language, and the corresponding selector is used in
+      this example:
+      <pre>
+<!-- -->:lang(dk) { hyphenate-resource: url("hyph_da_DK.dic"), url("hyph_da_NO.dic") }
+      </pre>
+    </div>
+
+    <p>UAs are not required to support this property.</p>
+    
+  <h4 id="hyphenation-issue">Hyphenation Resource Issue</h4>
+    
+    <div class="issue">
+      <p>'hyphenate-resource' and ''@hyphenate-resource'' are both proposed
+        to solve the same problem; only one is needed.</p>
+
+      <dl>
+        <dt>advantages of ''@hyphenate-resource''</dt>
+        <dd><ul>
+          <li>Minimal data storage (set per-language, not per-element).
+          <li>Requires language-tagging, which also enables the correct use
+            of local dictionaries (and can also trigger other typographic
+            improvements).
+          <li>Can use RFC4647 language-mapping, which is more intelligent
+            than :lang()'s prefix-matching. (Could also argue that :lang()
+            should use RFC4647.)
+        </ul></dd>
+        <dt>disadvantages of ''@hyphenate-resource''</dt>
+        <dd><ul>
+          <li>Requires language-tagging; cannot select on any other criteria.
+            Variations in hyphenation rules within the same language in a given
+            document will require use of subtags.
+        </ul></dd>
+        <dt>advantages of 'hyphenate-resource'</dt>
+        <dd><ul>
+          <li>Can use any selector, not just language-mapping.
+          <li>Implemented in Prince.
+        </ul></dd>
+        <dt>disadvantages of 'hyphenate-resource'</dt>
+        <dd><ul>
+          <li>Requires per-element data storage.
+        </ul></dd>
+      </dl>
+      
+      <p>Feedback on this issue is requested.</p>
+    </div>
+
 <h2 id="wrapping">
   Text Wrapping</h2>
 
Received on Tuesday, 8 February 2011 23:14:52 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 19:26:01 UTC