Revert 171080

ppapi/c/private/ppb_flash_file.h

 // Copyright (c) 2012 The Chromium Authors. All rights reserved.
 // Use of this source code is governed by a BSD-style license that can be
 // found in the LICENSE file.
 
 #ifndef PPAPI_C_PRIVATE_PPB_FLASH_FILE_H_
 #define PPAPI_C_PRIVATE_PPB_FLASH_FILE_H_
 
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_instance.h"
 #include "ppapi/c/pp_resource.h"
@@ skipping 14 matching lines @@
 // PPB_Flash_File_ModuleLocal --------------------------------------------------
 #define PPB_FLASH_FILE_MODULELOCAL_INTERFACE_2_0 "PPB_Flash_File_ModuleLocal;2"
 #define PPB_FLASH_FILE_MODULELOCAL_INTERFACE_3_0 "PPB_Flash_File_ModuleLocal;3"
 #define PPB_FLASH_FILE_MODULELOCAL_INTERFACE \
     PPB_FLASH_FILE_MODULELOCAL_INTERFACE_3_0
 
 // This interface provides (for Flash) synchronous access to module-local files.
 // Module-local file paths are '/'-separated UTF-8 strings, relative to a
 // module-specific root.
 struct PPB_Flash_File_ModuleLocal_3_0 {
-  // Deprecated. Returns true.
+  // Does initialization necessary for proxying this interface on background
+  // threads. You must always call this function before using any other
+  // function in this interface for a given instance ID.
+  //
+  // Returns true if multithreaded access is supported. In this case you can
+  // use the rest of the functions from background threads. You may not call
+  // GetInterface or do any other PPAPI operations on background threads at
+  // this time.
   bool (*CreateThreadAdapterForInstance)(PP_Instance instance);
-  // Deprecated. Does nothing.
+
+  // Call when an instance is destroyed when you've previously called
+  // CreateThreadAdapterForInstance.
   void (*ClearThreadAdapterForInstance)(PP_Instance instance);
 
   // Opens a file, returning a file descriptor (posix) or a HANDLE (win32) into
   // file. The return value is the ppapi error, PP_OK if success, one of the
   // PP_ERROR_* in case of failure.
   int32_t (*OpenFile)(PP_Instance instance,
                       const char* path,
                       int32_t mode,
                       PP_FileHandle* file);
 
@@ skipping 80 matching lines @@
   // (except in taking FileRefs instead of paths, of course). We omit the
   // functionality which we do not provide for FileRefs.
   int32_t (*OpenFile)(PP_Resource file_ref_id,
                       int32_t mode,
                       PP_FileHandle* file);
   int32_t (*QueryFile)(PP_Resource file_ref_id,
                        struct PP_FileInfo* info);
 };
 
 #endif  // PPAPI_C_PRIVATE_PPB_FLASH_FILE_H_