Merge pull request w3c#97 from progers/specifyPercentage

Specify the text-size-adjust <percentage> value

Author: dbaron

css-size-adjust/Overview.bs

@@ -10,7 +10,7 @@ ED: https://drafts.csswg.org/css-size-adjust/
 Editor: L. David Baron, Mozilla https://www.mozilla.org/, http://dbaron.org/
 Editor: Tantek Çelik, Mozilla https://www.mozilla.org/, http://tantek.com/
 Abstract: This module contains features of CSS relating to one possible mechanism for adapting pages designed for desktop computer displays for display on smaller screens such as those of mobile phones.  This mechanism involves displaying a scaled down display of the Web page and allowing the user to pan and zoom within that display, but within that scaled down display making certain text and similar elements larger than specified by the page author in order to ensure that when a block of wrapped text is zoomed to the width of the device (so it can be read without side-to-side scrolling for each line), the text is large enough to be readable.
-Status Text: <p>The following features are at risk:</p> <ul> <li>the &lt;percentage&gt; value for 'text-size-adjust'</li> <li>the reference to [[!CSS-TEXT-4]]&apos;s 'text-wrap' property</li> </ul>
+Status Text: <p>The following features are at risk:</p> <ul> <li>the reference to [[!CSS-TEXT-4]]&apos;s 'text-wrap' property</li> </ul>
 </pre>
 
 <pre class="link-defaults">
@@ -173,9 +173,14 @@ Size adjustment control: the 'text-size-adjust' property {#adjustment-control}
     <dt><dfn>none</dfn></dt>
       <dd>Renderers must not do size adjustment when displaying on a small device.</dd>
     <dt><dfn>&lt;percentage&gt;</dfn></dt>
-      <dd><span class="issue">Need to define what percentages actually mean.  Are they a minimum or a set value?  What exactly are they relative to?</span></dd>
+      <dd>When displaying on a small device, renderers must not do size adjustment but instead the computed value of 'font-size' must be multiplied by this percentage.
+      <p class="note">Note: This means that 'text-size-adjust: 100%;' is equivalent to 'text-size-adjust: none;'.</p></dd>
   </dl>
 
+  Issue: "Small device" is not well defined. We should clearly specify
+  when text size adjustment should apply. For example, in practice a
+  large tablet is considered by vendors to be a small device.
+
 Acknowledgments {#acknowledgments}
 ==================================
 

css-size-adjust/Overview.html

@@ -52,7 +52,7 @@
   <div class="head">
    <p data-fill-with="logo"><a class="logo" href="http://www.w3.org/"> <img alt="W3C" height="48" src="https://www.w3.org/Icons/w3c_home" width="72"> </a> </p>
    <h1 class="p-name no-ref" id="title">CSS Mobile Text Size Adjustment Module Level 1</h1>
-   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2016-03-03">3 March 2016</time></span></h2>
+   <h2 class="no-num no-toc no-ref heading settled" id="subtitle"><span class="content">Editor’s Draft, <time class="dt-updated" datetime="2016-03-06">6 March 2016</time></span></h2>
    <div data-fill-with="spec-metadata">
     <dl>
      <dt>This version:
@@ -101,7 +101,6 @@ <h2 class="no-num no-toc no-ref heading settled" id="status"><span class="conten
    <p></p>
    <p>The following features are at risk:</p>
    <ul>
-    <li>the &lt;percentage> value for <a class="property" data-link-type="propdesc" href="#propdef-text-size-adjust">text-size-adjust</a>
     <li>the reference to <a data-link-type="biblio" href="#biblio-css-text-4">[CSS-TEXT-4]</a>'s <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-text-4/#propdef-text-wrap">text-wrap</a> property
    </ul>
   </div>
@@ -246,7 +245,7 @@ <h2 class="heading settled" data-level="3" id="adjustment-control"><span class="
     <tbody>
      <tr>
       <th>Name:
-      <td><dfn class="dfn-paneled css" data-dfn-type="property" data-export="" data-lt="text-size-adjust" id="propdef-text-size-adjust">text-size-adjust<span class="dfn-panel"><b><a href="#propdef-text-size-adjust">#propdef-text-size-adjust</a></b><b>Referenced in:</b><span><a href="#ref-for-propdef-text-size-adjust-1">2. Default size adjustment</a></span><span><a href="#ref-for-propdef-text-size-adjust-2">3. Size adjustment control: the text-size-adjust property</a></span></span></dfn>
+      <td><dfn class="dfn-paneled css" data-dfn-type="property" data-export="" data-lt="text-size-adjust" id="propdef-text-size-adjust">text-size-adjust<span class="dfn-panel" data-deco=""><b><a href="#propdef-text-size-adjust">#propdef-text-size-adjust</a></b><b>Referenced in:</b><span><a href="#ref-for-propdef-text-size-adjust-1">2. Default size adjustment</a></span><span><a href="#ref-for-propdef-text-size-adjust-2">3. Size adjustment control: the text-size-adjust property</a></span></span></dfn>
      <tr class="value">
       <th>Value:
       <td class="prod">auto <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> none <a data-link-type="grammar" href="https://drafts.csswg.org/css-values-3/#comb-one">|</a> &lt;percentage>
@@ -281,8 +280,13 @@ <h2 class="heading settled" data-level="3" id="adjustment-control"><span class="
     <dt><dfn class="css" data-dfn-for="text-size-adjust" data-dfn-type="value" data-export="" id="valdef-text-size-adjust-none">none<a class="self-link" href="#valdef-text-size-adjust-none"></a></dfn>
     <dd>Renderers must not do size adjustment when displaying on a small device.
     <dt><dfn class="css" data-dfn-for="text-size-adjust" data-dfn-type="value" data-export="" id="valdef-text-size-adjust-percentage">&lt;percentage><a class="self-link" href="#valdef-text-size-adjust-percentage"></a></dfn>
-    <dd><span class="issue" id="issue-3563c84d"><a class="self-link" href="#issue-3563c84d"></a>Need to define what percentages actually mean.  Are they a minimum or a set value?  What exactly are they relative to?</span>
+    <dd>
+     When displaying on a small device, renderers must not do size adjustment but instead the computed value of <a class="property" data-link-type="propdesc" href="https://drafts.csswg.org/css-fonts-3/#propdef-font-size">font-size</a> must be multiplied by this percentage. 
+     <p class="note" role="note">Note: This means that 'text-size-adjust: 100%;' is equivalent to 'text-size-adjust: none;'.</p>
    </dl>
+   <p class="issue" id="issue-0028bf4a"><a class="self-link" href="#issue-0028bf4a"></a> "Small device" is not well defined. We should clearly specify
+  when text size adjustment should apply. For example, in practice a
+  large tablet is considered by vendors to be a small device.</p>
    <h2 class="heading settled" data-level="4" id="acknowledgments"><span class="secno">4. </span><span class="content">Acknowledgments</span><a class="self-link" href="#acknowledgments"></a></h2>
    <p>The editors would like to thank:
   .</p>
@@ -479,7 +483,9 @@ <h2 class="no-num no-ref heading settled" id="issues-index"><span class="content
 innovation and improvement.<a href="#issue-7ada1e3c"> ↵ </a></div>
    <div class="issue">Define
 this with more detail/precision.<a href="#issue-499161e9"> ↵ </a></div>
-   <div class="issue">Need to define what percentages actually mean.  Are they a minimum or a set value?  What exactly are they relative to?<a href="#issue-3563c84d"> ↵ </a></div>
+   <div class="issue"> "Small device" is not well defined. We should clearly specify
+  when text size adjustment should apply. For example, in practice a
+  large tablet is considered by vendors to be a small device.<a href="#issue-0028bf4a"> ↵ </a></div>
   </div>
 <script>
         document.body.addEventListener("click", function(e) {