Minor changes as per Christians most-recent review of the docs.

ppapi/api/ppb_file_system.idl

Index: ppapi/api/ppb_file_system.idl
===================================================================
--- ppapi/api/ppb_file_system.idl	(revision 122146)
+++ ppapi/api/ppb_file_system.idl	(working copy)
@@ -51,10 +51,12 @@
    * completion of Open().
    *
    * @return An int32_t containing an error code from <code>pp_errors.h</code>.
-   *
-   * TODO(brettw) clarify whether this must have completed before a file can
-   * be opened in it. Clarify what it means to be "completed."
    */
+  
+   /* 
+    * TODO(brettw) clarify whether this must have completed before a file can
+    * be opened in it. Clarify what it means to be "completed."
+    */
   int32_t Open([in] PP_Resource file_system,
                [in] int64_t expected_size,
                [in] PP_CompletionCallback callback);