W3C home > Mailing lists > Public > public-html-diffs@w3.org > May 2011

hixie: add explicit dependency on File API spec (whatwg r6075)

From: poot <cvsmail@w3.org>
Date: Wed, 04 May 2011 20:04:41 -0400
To: public-html-diffs@w3.org
Message-Id: <E1QHm3c-0002qq-Sp@jay.w3.org>
hixie: add explicit dependency on File API spec (whatwg r6075)

http://dev.w3.org/cvsweb/html5/spec/Overview.html?r1=1.4878&r2=1.4879&f=h
http://html5.org/tools/web-apps-tracker?from=6074&to=6075

===================================================================
RCS file: /sources/public/html5/spec/Overview.html,v
retrieving revision 1.4878
retrieving revision 1.4879
diff -u -d -r1.4878 -r1.4879
--- Overview.html	4 May 2011 23:54:43 -0000	1.4878
+++ Overview.html	5 May 2011 00:01:04 -0000	1.4879
@@ -340,7 +340,7 @@
 
    <h1>HTML5</h1>
    <h2 class="no-num no-toc" id="a-vocabulary-and-associated-apis-for-html-and-xhtml">A vocabulary and associated APIs for HTML and XHTML</h2>
-   <h2 class="no-num no-toc" id="editor-s-draft-4-may-2011">Editor's Draft 4 May 2011</h2>
+   <h2 class="no-num no-toc" id="editor-s-draft-5-may-2011">Editor's Draft 5 May 2011</h2>
    <dl><dt>Latest Published Version:</dt>
     <dd><a href="http://www.w3.org/TR/html5/">http://www.w3.org/TR/html5/</a></dd>
     <dt>Latest Editor's Draft:</dt>
@@ -483,7 +483,7 @@
   Group</a> is the W3C working group responsible for this
   specification's progress along the W3C Recommendation
   track.
-  This specification is the 4 May 2011 Editor's Draft.
+  This specification is the 5 May 2011 Editor's Draft.
   </p><!-- UNDER NO CIRCUMSTANCES IS THE PRECEDING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>Work on this specification is also done at the <a href="http://www.whatwg.org/">WHATWG</a>. The W3C HTML working group
   actively pursues convergence with the WHATWG, as required by the <a href="http://www.w3.org/2007/03/HTML-WG-charter">W3C HTML working
   group charter</a>.</p><!-- UNDER NO CIRCUMSTANCES IS THE FOLLOWING PARAGRAPH TO BE REMOVED OR EDITED WITHOUT TALKING TO IAN FIRST --><p>This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5
@@ -2925,6 +2925,19 @@
 
     </ul></dd>
 
+   <dt>File API</dt>
+
+   <dd>
+
+    <p>This specification uses the following interfaces defined in the
+    File API specification: <a href="#refsFILEAPI">[FILEAPI]</a></p>
+
+    <ul class="brief"><li><dfn id="blob">Blob</dfn></li>
+     <li><dfn id="file">File</dfn></li>
+     <li><dfn id="filelist">FileList</dfn></li>
+
+    </ul></dd>
+
    <dt>Web IDL</dt>
 
    <dd>
@@ -7062,17 +7075,17 @@
      <code title="dom-canvaspixelarray-length">length</code> and pixel
      values as the <var title="">input</var>'s.</dd>
 
-     <dt>If <var title="">input</var> is a <code>File</code> object</dt>
+     <dt>If <var title="">input</var> is a <code><a href="#file">File</a></code> object</dt>
 
-     <dd><p>Let <var title="">output</var> be a newly constructed <code>File</code> object corresponding to the same underlying data.</dd>
+     <dd><p>Let <var title="">output</var> be a newly constructed <code><a href="#file">File</a></code> object corresponding to the same underlying data.</dd>
 
-     <dt>If <var title="">input</var> is a <code>Blob</code> object</dt>
+     <dt>If <var title="">input</var> is a <code><a href="#blob">Blob</a></code> object</dt>
 
-     <dd><p>Let <var title="">output</var> be a newly constructed <code>Blob</code> object corresponding to the same underlying data.</dd>
+     <dd><p>Let <var title="">output</var> be a newly constructed <code><a href="#blob">Blob</a></code> object corresponding to the same underlying data.</dd>
 
-     <dt>If <var title="">input</var> is a <code>FileList</code> object</dt>
+     <dt>If <var title="">input</var> is a <code><a href="#filelist">FileList</a></code> object</dt>
 
-     <dd><p>Let <var title="">output</var> be a newly constructed <code>FileList</code> object containing a list of newly constructed <code>File</code> objects corresponding to the same underlying data as those in <var title="">input</var>, maintaining their relative order.</dd>
+     <dd><p>Let <var title="">output</var> be a newly constructed <code><a href="#filelist">FileList</a></code> object containing a list of newly constructed <code><a href="#file">File</a></code> objects corresponding to the same underlying data as those in <var title="">input</var>, maintaining their relative order.</dd>
 
      <dt>If <var title="">input</var> is an Array object</dt>
 
@@ -31167,7 +31180,7 @@
            attribute DOMString <a href="#dom-input-dirname" title="dom-input-dirName">dirName</a>;
            attribute boolean <a href="#dom-fe-disabled" title="dom-fe-disabled">disabled</a>;
   readonly attribute <a href="#htmlformelement">HTMLFormElement</a> <a href="#dom-fae-form" title="dom-fae-form">form</a>;
-  readonly attribute <span>FileList</span> <a href="#dom-input-files" title="dom-input-files">files</a>;
+  readonly attribute <a href="#filelist">FileList</a> <a href="#dom-input-files" title="dom-input-files">files</a>;
            attribute DOMString <a href="#dom-fs-formaction" title="dom-fs-formAction">formAction</a>;
            attribute DOMString <a href="#dom-fs-formenctype" title="dom-fs-formEnctype">formEnctype</a>;
            attribute DOMString <a href="#dom-fs-formmethod" title="dom-fs-formMethod">formMethod</a>;
@@ -35477,7 +35490,7 @@
 
    <dd>
 
-    <p>Returns a <code>FileList</code> object listing the <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a> of
+    <p>Returns a <code><a href="#filelist">FileList</a></code> object listing the <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a> of
     the form control.</p>
 
     <p>Returns null if the control isn't a file control.</p>
@@ -35598,7 +35611,7 @@
   <hr><p>The <dfn id="dom-input-files" title="dom-input-files"><code>files</code></dfn> IDL
   attribute allows scripts to access the element's <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>. On
   getting, if the IDL attribute applies, it must return a
-  <code>FileList</code> object that represents the current <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>. The
+  <code><a href="#filelist">FileList</a></code> object that represents the current <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>. The
   same object must be returned until the list of <a href="#concept-input-type-file-selected" title="concept-input-type-file-selected">selected files</a>
   changes. If the IDL attribute does not apply, then it must instead
   return null. <a href="#refsFILEAPI">[FILEAPI]</a></p>
@@ -51610,7 +51623,7 @@
        </dd>
 
 
-       <dt><i>File</i></dt>
+       <dt><i><a href="#file">File</a></i></dt>
        <dd>
         <p>Binary data with a file name.</p>
        </dd>
@@ -51733,7 +51746,7 @@
   DOMString <a href="#dom-datatransfer-getdata" title="dom-DataTransfer-getData">getData</a>(in DOMString format);
   void <a href="#dom-datatransfer-setdata" title="dom-DataTransfer-setData">setData</a>(in DOMString format, in DOMString data);
   void <a href="#dom-datatransfer-cleardata" title="dom-DataTransfer-clearData">clearData</a>(in optional DOMString format);
-  readonly attribute <span>FileList</span> <a href="#dom-datatransfer-files" title="dom-DataTransfer-files">files</a>;
+  readonly attribute <a href="#filelist">FileList</a> <a href="#dom-datatransfer-files" title="dom-DataTransfer-files">files</a>;
 };</pre><dl class="domintro"><dt><var title="">dataTransfer</var> . <code title="dom-DataTransfer-dropEffect"><a href="#dom-datatransfer-dropeffect">dropEffect</a></code> [ = <var title="">value</var> ]</dt>
 
    <dd>
@@ -51834,7 +51847,7 @@
 
    <dd>
 
-    <p>Returns a <code>FileList</code> of the files being dragged, if any.</p>
+    <p>Returns a <code><a href="#filelist">FileList</a></code> of the files being dragged, if any.</p>
 
    </dd>
 
@@ -51932,7 +51945,7 @@
 
    <li><p>If there are any items in the <a href="#drag-data-store-item-list">drag data store item
    list</a> whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a>
-   is <i>File</i>, then add an entry to the list <var title="">L</var>
+   is <i><a href="#file">File</a></i>, then add an entry to the list <var title="">L</var>
    consisting of the string "<code title="">Files</code>". (This value
    can be distinguished from the other values because it is not
    lowercase.)</li>
@@ -52051,18 +52064,18 @@
   were included in the drag).</p>
 
   <p>The <dfn id="dom-datatransfer-files" title="dom-DataTransfer-files"><code>files</code></dfn>
-  attribute must return a <a href="#live">live</a> <code>FileList</code>
-  sequence consisting of <code>File</code> objects representing the
+  attribute must return a <a href="#live">live</a> <code><a href="#filelist">FileList</a></code>
+  sequence consisting of <code><a href="#file">File</a></code> objects representing the
   files found by the following steps. The same object must be returned
-  each time. Furthermore, for a given <code>FileList</code> object and
-  a given underlying file, the same <code>File</code> object must be
+  each time. Furthermore, for a given <code><a href="#filelist">FileList</a></code> object and
+  a given underlying file, the same <code><a href="#file">File</a></code> object must be
   used each time.</p>
 
   <ol><li><p>Start with an empty list <var title="">L</var>.</li>
 
    <li><p>If the <code><a href="#datatransfer">DataTransfer</a></code> object is no longer
    associated with a <a href="#drag-data-store">drag data store</a>, the
-   <code>FileList</code> is empty. Abort these steps; return the
+   <code><a href="#filelist">FileList</a></code> is empty. Abort these steps; return the
    empty list <var title="">L</var>.</li>
 
    <li><p>If the <a href="#drag-data-store">drag data store</a>'s <a href="#drag-data-store-mode" title="drag data
@@ -52071,7 +52084,7 @@
 
    <li><p>For each item in the <a href="#drag-data-store-item-list">drag data store item list</a>
     whose <a href="#the-drag-data-item-kind" title="the drag data item
-   kind">kind</a> is <i>File</i> ,
+   kind">kind</a> is <i><a href="#file">File</a></i> ,
    add the item's data (the file, in particular its name and contents,
    as well as its <a href="#the-drag-data-item-type-string" title="the drag data item type
    string">type</a>) to the list <var title="">L</var>.</li>
@@ -52090,7 +52103,7 @@
   <a href="#dom-datatransferitems-removeitem" title="dom-DataTransferItems-removeItem">deleter</a> void (in unsigned long index);
   void <a href="#dom-datatransferitems-clear" title="dom-DataTransferItems-clear">clear</a>();
 
-  <a href="#datatransferitem">DataTransferItem</a> <a href="#dom-datatransferitems-add" title="dom-DataTransferItems-add">add</a>(in DOMString data, in DOMString type);  <a href="#datatransferitem">DataTransferItem</a> <a href="#dom-datatransferitems-add" title="dom-DataTransferItems-add">add</a>(in <span>File</span> data);};</pre><dl class="domintro"><dt><var title="">items</var> . <code title="dom-DataTransferItems-length"><a href="#dom-datatransferitems-length">length</a></code></dt>
+  <a href="#datatransferitem">DataTransferItem</a> <a href="#dom-datatransferitems-add" title="dom-DataTransferItems-add">add</a>(in DOMString data, in DOMString type);  <a href="#datatransferitem">DataTransferItem</a> <a href="#dom-datatransferitems-add" title="dom-DataTransferItems-add">add</a>(in <a href="#file">File</a> data);};</pre><dl class="domintro"><dt><var title="">items</var> . <code title="dom-DataTransferItems-length"><a href="#dom-datatransferitems-length">length</a></code></dt>
 
    <dd><p>Returns the number of items in the <a href="#drag-data-store">drag data store</a>.</dd>
 
@@ -52225,16 +52238,16 @@
      </dd>
 
 
-     <dt>If the first argument to the method is a <code>File</code></dt>
+     <dt>If the first argument to the method is a <code><a href="#file">File</a></code></dt>
 
      <dd>
 
       <p>Add an item to the <a href="#drag-data-store-item-list">drag data store item list</a>
       whose <a href="#the-drag-data-item-kind" title="the drag data item kind">kind</a> is
-      <i>File</i>, whose <a href="#the-drag-data-item-type-string" title="the drag data item type
-      string">type string</a> is the <code title="dom-Blob-type">type</code> of the <code>File</code>,
+      <i><a href="#file">File</a></i>, whose <a href="#the-drag-data-item-type-string" title="the drag data item type
+      string">type string</a> is the <code title="dom-Blob-type">type</code> of the <code><a href="#file">File</a></code>,
       <a href="#converted-to-ascii-lowercase">converted to ASCII lowercase</a>, and whose data is the
-      same as the <code>File</code>'s data.</p>
+      same as the <code><a href="#file">File</a></code>'s data.</p>
 
      </dd>
 
@@ -52250,7 +52263,7 @@
   <code><a href="#datatransfer">DataTransfer</a></code> object.<pre class="idl">interface <dfn id="datatransferitem">DataTransferItem</dfn> {
     readonly attribute DOMString <a href="#dom-datatransferitem-kind" title="dom-DataTransferItem-kind">kind</a>;
     readonly attribute DOMString <a href="#dom-datatransferitem-type" title="dom-DataTransferItem-type">type</a>;
-    void <a href="#dom-datatransferitem-getasstring" title="dom-DataTransferItem-getAsString">getAsString</a>(in <a href="#functionstringcallback">FunctionStringCallback</a> callback);    <span>File</span> <a href="#dom-datatransferitem-getasfile" title="dom-DataTransferItem-getAsFile">getAsFile</a>();};
+    void <a href="#dom-datatransferitem-getasstring" title="dom-DataTransferItem-getAsString">getAsString</a>(in <a href="#functionstringcallback">FunctionStringCallback</a> callback);    <a href="#file">File</a> <a href="#dom-datatransferitem-getasfile" title="dom-DataTransferItem-getAsFile">getAsFile</a>();};
 
 [Callback=FunctionOnly, NoInterfaceObject]
 interface <dfn id="functionstringcallback">FunctionStringCallback</dfn> {
@@ -52281,7 +52294,7 @@
    <dt><var title="">file</var> = <var title="">item</var> . <code title="dom-DataTransferItem-getAsFile"><a href="#dom-datatransferitem-getasfile">getAsFile</a></code>()</dt>
    <dd>
 
-    <p>Returns a <code>File</code> object, if <a href="#the-drag-data-item-kind">the drag data item kind</a> is <i>File</i>.</p>
+    <p>Returns a <code><a href="#file">File</a></code> object, if <a href="#the-drag-data-item-kind">the drag data item kind</a> is <i><a href="#file">File</a></i>.</p>
 
    </dd>
 
@@ -52317,7 +52330,7 @@
 
   <table><thead><tr><th> Kind <th> String
    <tbody><tr><td> <i>Plain Unicode string</i> <td> "<code title="">string</code>"
-    <tr><td> <i>File</i> <td> "<code title="">file</code>"
+    <tr><td> <i><a href="#file">File</a></i> <td> "<code title="">file</code>"
   </table><p>The <dfn id="dom-datatransferitem-type" title="dom-DataTransferItem-type"><code>type</code></dfn> attribute
   must return the empty string if the <code><a href="#datatransferitem">DataTransferItem</a></code>
   object is in the <i>disabled mode</i>; otherwise it must return
@@ -52347,10 +52360,10 @@
   <ol><li><p>If the <code><a href="#datatransferitem">DataTransferItem</a></code> object is not in the <i title="concept-dnd-rw"><a href="#concept-dnd-rw">read/write mode</a></i> or the <i title="concept-dnd-ro"><a href="#concept-dnd-ro">read-only mode</a></i>, return null and abort
    these steps.</li>
 
-   <li><p>If <a href="#the-drag-data-item-kind">the drag data item kind</a> is not <i>File</i>,
+   <li><p>If <a href="#the-drag-data-item-kind">the drag data item kind</a> is not <i><a href="#file">File</a></i>,
    then return null and abort these steps.</li>
 
-   <li><p>Return a new <code>File</code> object representing the
+   <li><p>Return a new <code><a href="#file">File</a></code> object representing the
    actual data of the item represented by the
    <code><a href="#datatransferitem">DataTransferItem</a></code> object.</p>
 
@@ -52572,7 +52585,7 @@
      <dd>The MIME type of the file, if known, or "<code>application/octet-stream</code>" otherwise.</dd>
 
      <dt><a href="#the-drag-data-item-kind">The drag data item kind</a>
-     <dd><i>File</i></dd>
+     <dd><i><a href="#file">File</a></i></dd>
 
      <dt>The actual data</dt>
      <dd>The file's contents and name.</dd>
@@ -53246,7 +53259,7 @@
    case-insensitive</a> match for the string "<code title="">f:</code>")<dt>
 
    </dt><dd><p>Indicates that items with <a href="#the-drag-data-item-kind">the drag data item
-   kind</a> <i>File</i> and <a href="#the-drag-data-item-type-string">the drag data item type
+   kind</a> <i><a href="#file">File</a></i> and <a href="#the-drag-data-item-type-string">the drag data item type
    string</a> set to a value that matches the remainder of the
    keyword are accepted.</dd>
 
@@ -53331,7 +53344,7 @@
        <dd>
 
         <p>Let <var title="">kind</var> be
-        <i>File</i>.</p>
+        <i><a href="#file">File</a></i>.</p>
 
        </dd>
Received on Thursday, 5 May 2011 00:04:43 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Thursday, 5 May 2011 00:04:43 GMT