Move DirectoryReader::ReadEntries to FileRef::ReadDirectoryEntries

ppapi/c/ppb_file_ref.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.
  */
 
-/* From ppb_file_ref.idl modified Thu Mar  7 12:02:53 2013. */
+/* From ppb_file_ref.idl modified Thu May  2 15:33:16 2013. */
 
 #ifndef PPAPI_C_PPB_FILE_REF_H_
 #define PPAPI_C_PPB_FILE_REF_H_
 
+#include "ppapi/c/pp_array_output.h"
 #include "ppapi/c/pp_bool.h"
 #include "ppapi/c/pp_completion_callback.h"
 #include "ppapi/c/pp_file_info.h"
 #include "ppapi/c/pp_macros.h"
 #include "ppapi/c/pp_resource.h"
 #include "ppapi/c/pp_stdint.h"
 #include "ppapi/c/pp_time.h"
 #include "ppapi/c/pp_var.h"
 
 #define PPB_FILEREF_INTERFACE_1_0 "PPB_FileRef;1.0"
@@ skipping 150 matching lines @@
    * @param[in] new_file_ref A <code>PP_Resource</code> corresponding to a new
    * file reference.
    * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
    * completion of Rename().
    *
    * @return An int32_t containing an error code from <code>pp_errors.h</code>.
    */
   int32_t (*Rename)(PP_Resource file_ref,
                     PP_Resource new_file_ref,
                     struct PP_CompletionCallback callback);
-  /*
+  /**
    * Query() queries info about a file or directory. You must have access to
    * read this file or directory if it exists in the external filesystem.
    *
    * @param[in] file_ref A <code>PP_Resource</code> corresponding to a file
    * reference.
    * @param[out] info A pointer to a <code>PP_FileInfo</code> which will be
    * populated with information about the file or directory.
    * @param[in] callback A <code>PP_CompletionCallback</code> to be called upon
    * completion of Query().
    *
    * @return An int32_t containing an error code from <code>pp_errors.h</code>.
    */
   int32_t (*Query)(PP_Resource file_ref,
                    struct PP_FileInfo* info,
                    struct PP_CompletionCallback callback);
+  /**
+   * READS all entries in a directory.

[dmichael (off chromium), 2013/05/02 23:20:43]

why all-caps?

[hamaji, 2013/05/02 23:36:34]

Done.

+   *
+   * @param[in] file_ref A <code>PP_Resource</code> corresponding to a directory
+   * reference.
+   * @param[in] output An output array which will receive
+   * <code>PP_DirectoryEntry</code> objects on success.
+   * @param[in] callback A <code>PP_CompletionCallback</code> to run on
+   * completion.
+   *
+   * @return An int32_t containing an error code from <code>pp_errors.h</code>.
+   */
+  int32_t (*ReadDirectoryEntries)(PP_Resource file_ref,
+                                  struct PP_ArrayOutput output,
+                                  struct PP_CompletionCallback callback);
 };
 
 typedef struct PPB_FileRef_1_1 PPB_FileRef;
 
 struct PPB_FileRef_1_0 {
   PP_Resource (*Create)(PP_Resource file_system, const char* path);
   PP_Bool (*IsFileRef)(PP_Resource resource);
   PP_FileSystemType (*GetFileSystemType)(PP_Resource file_ref);
   struct PP_Var (*GetName)(PP_Resource file_ref);
   struct PP_Var (*GetPath)(PP_Resource file_ref);
@@ skipping 10 matching lines @@
   int32_t (*Rename)(PP_Resource file_ref,
                     PP_Resource new_file_ref,
                     struct PP_CompletionCallback callback);
 };
 /**
  * @}
  */
 
 #endif  /* PPAPI_C_PPB_FILE_REF_H_ */