hixie: Add a link to the fakepath example from the fakepath impl requirement. (whatwg r6083)

hixie: Add a link to the fakepath example from the fakepath impl
requirement. (whatwg r6083)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4886&r2=1.4887&f=h
http://html5.org/tools/web-apps-tracker?from=6082&to=6083

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4886
retrieving revision 1.4887
diff -u -d -r1.4886 -r1.4887
--- Overview.html 5 May 2011 08:36:47 -0000 1.4886
+++ Overview.html 5 May 2011 19:26:54 -0000 1.4887
@@ -34323,7 +34323,7 @@
   <p>User agents should prevent the user from selecting files that are
   not accepted by one (or more) of these tokens.</p>
 
-  </div><div class="example">
+  </div><div class="example" id="fakepath-srsly">
 
    <p>For historical reasons, the <code title="dom-input-value"><a href="#dom-input-value">value</a></code> IDL attribute prefixes the
    filename with the string "<code title="">C:\fakepath\</code>". Some
@@ -35571,34 +35571,56 @@
 
   <dl><dt><dfn id="dom-input-value-value" title="dom-input-value-value">value</dfn>
 
-   <dd>On getting, it must return the current <a href="#concept-fe-value" title="concept-fe-value">value</a> of the element. On setting,
-   it must set the element's <a href="#concept-fe-value" title="concept-fe-value">value</a> to the new value, set the
-   element's <a href="#concept-input-value-dirty-flag" title="concept-input-value-dirty-flag">dirty value
-   flag</a> to true, and then invoke the <a href="#value-sanitization-algorithm">value sanitization
-   algorithm</a>, if the element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute's current state
-   defines one.</dd>
+   <dd>
+
+    <p>On getting, it must return the current <a href="#concept-fe-value" title="concept-fe-value">value</a> of the element. On setting,
+    it must set the element's <a href="#concept-fe-value" title="concept-fe-value">value</a> to the new value, set the
+    element's <a href="#concept-input-value-dirty-flag" title="concept-input-value-dirty-flag">dirty value
+    flag</a> to true, and then invoke the <a href="#value-sanitization-algorithm">value sanitization
+    algorithm</a>, if the element's <code title="attr-input-type"><a href="#attr-input-type">type</a></code> attribute's current state
+    defines one.</p>
+
+   </dd>
 
    <dt><dfn id="dom-input-value-default" title="dom-input-value-default">default</dfn>
 
-   <dd>On getting, if the element has a <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, it must return
-   that attribute's value; otherwise, it must return the empty
-   string. On setting, it must set the element's <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute to the new
-   value.</dd>
+   <dd>
+
+    <p>On getting, if the element has a <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, it must return
+    that attribute's value; otherwise, it must return the empty
+    string. On setting, it must set the element's <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute to the new
+    value.</p>
+
+   </dd>
 
    <dt><dfn id="dom-input-value-default-on" title="dom-input-value-default-on">default/on</dfn>
 
-   <dd>On getting, if the element has a <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, it must return
-   that attribute's value; otherwise, it must return the string "<code title="">on</code>". On setting, it must set the element's <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute to the new
-   value.</dd>
+   <dd>
+
+    <p>On getting, if the element has a <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute, it must return
+    that attribute's value; otherwise, it must return the string
+    "<code title="">on</code>". On setting, it must set the element's
+    <code title="attr-input-value"><a href="#attr-input-value">value</a></code> attribute to the new
+    value.</p>
+
+   </dd>
 
    <dt><dfn id="dom-input-value-filename" title="dom-input-value-filename">filename</dfn>
 
-   <dd>On getting, it must return the string "<code title="">C:\fakepath\</code>" followed by the filename of the first
-   file in the list of <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>, if
-   any, or the empty string if the list is empty. On setting, if the
-   new value is the empty string, it must empty the list of <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>;
-   otherwise, it must throw an <code><a href="#invalid_state_err">INVALID_STATE_ERR</a></code>
-   exception.</dd>
+   <dd id="fakepath-orly">
+
+    <p>On getting, it must return the string "<code title="">C:\fakepath\</code>" followed by the filename of the
+    first file in the list of <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>, if
+    any, or the empty string if the list is empty. On setting, if the
+    new value is the empty string, it must empty the list of <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>;
+    otherwise, it must throw an <code><a href="#invalid_state_err">INVALID_STATE_ERR</a></code>
+    exception.</p>
+
+    <p class="note">This "fakepath" requirement is a sad accident of
+    history. See <a href="#fakepath-srsly">the example in the File
+    Upload state section</a> for more information.</p>
+
+   </dd>
 
   </dl><hr><p>The <dfn id="dom-input-checked" title="dom-input-checked"><code>checked</code></dfn> IDL
   attribute allows scripts to manipulate the <a href="#concept-fe-checked" title="concept-fe-checked">checkedness</a> of an

Received on Thursday, 5 May 2011 19:29:13 UTC