2009/dap/file-system file-dir-sys.html,1.14,1.15

Update of /sources/public/2009/dap/file-system
In directory hutz:/tmp/cvs-serv16552

Modified Files:
	file-dir-sys.html 
Log Message:
The createWriter call was synchronous, but that conflicts with the FileWriter's
length member, which must be asynchronously cached during creation so as not to
block the main thread.  I made createWriter be asynchronous to fix this.


Index: file-dir-sys.html
===================================================================
RCS file: /sources/public/2009/dap/file-system/file-dir-sys.html,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- file-dir-sys.html	14 Aug 2010 00:06:38 -0000	1.14
+++ file-dir-sys.html	25 Aug 2010 18:24:22 -0000	1.15
@@ -807,12 +807,22 @@
         </p>
         <dl title='[NoInterfaceObject] interface FileEntry : Entry'
             class='idl'>
-          <dt>FileWriter createWriter ()</dt>
+          <dt>void createWriter ()</dt>
           <dd>
             <p>
               Creates a new <code>FileWriter</code> associated with the file
               that this <code>FileEntry</code> represents.
             </p>
+            <dl class='parameters'>
+              <dt>FileWriterCallback successCallback</dt>
+              <dd>
+                A callback that is called with the new <a>FileWriter</a>.
+              </dd>
+              <dt>optional ErrorCallback errorCallback</dt>
+              <dd>
+                A callback that is called when errors happen.
+              </dd>
+            </dl>
           </dd>
           <dt>File file ()</dt>
           <dd>
@@ -911,6 +921,22 @@
         </section>
 
         <section>
+          <h2>The <code>FileWriterCallback</code> interface</h2>
+          <p>
+          This interface is the callback used to create a <a>FileWriter</a>.
+          </p>
+          <dl title='[NoInterfaceObject, Callback=FunctionOnly] interface
+              FileWriterCallback' class='idl'>
+            <dt>void handleEvent (FileWriter fileWriter)</dt>
+            <dd>
+              <p>
+              Used to supply a <a>FileWriter</a> as a response to a user query.
+              </p>
+            </dd>
+          </dl>
+        </section>
+
+        <section>
           <h2>The <code>VoidCallback</code> interface</h2>
           <p>
             This interface is the generic callback used to indicate success of

Received on Wednesday, 25 August 2010 18:24:26 UTC