| Index: third_party/WebKit/public/platform/WebFileSystem.h
|
| diff --git a/third_party/WebKit/public/platform/WebFileSystem.h b/third_party/WebKit/public/platform/WebFileSystem.h
|
| index 706c1257d5c7b86568877e6e018714d18431f499..aeb02168750e63aa3e1ab80d189bed0ecf600471 100644
|
| --- a/third_party/WebKit/public/platform/WebFileSystem.h
|
| +++ b/third_party/WebKit/public/platform/WebFileSystem.h
|
| @@ -82,14 +82,16 @@ class WebFileSystem {
|
| WebFileSystemCallbacks) {}
|
|
|
| // Moves a file or directory at |srcPath| to |destPath|.
|
| - // WebFileSystemCallbacks::didSucceed() must be called when the operation is completed successfully.
|
| + // WebFileSystemCallbacks::didSucceed() must be called when the operation is
|
| + // completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void move(const WebURL& srcPath,
|
| const WebURL& destPath,
|
| WebFileSystemCallbacks) = 0;
|
|
|
| // Copies a file or directory at |srcPath| to |destPath|.
|
| - // WebFileSystemCallbacks::didSucceed() must be called when the operation is completed successfully.
|
| + // WebFileSystemCallbacks::didSucceed() must be called when the operation is
|
| + // completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void copy(const WebURL& srcPath,
|
| const WebURL& destPath,
|
| @@ -97,19 +99,22 @@ class WebFileSystem {
|
|
|
| // Deletes a file or directory at a given |path|.
|
| // It is an error to try to remove a directory that is not empty.
|
| - // WebFileSystemCallbacks::didSucceed() must be called when the operation is completed successfully.
|
| + // WebFileSystemCallbacks::didSucceed() must be called when the operation is
|
| + // completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void remove(const WebURL& path, WebFileSystemCallbacks) = 0;
|
|
|
| // Deletes a file or directory recursively at a given |path|.
|
| - // WebFileSystemCallbacks::didSucceed() must be called when the operation is completed successfully.
|
| + // WebFileSystemCallbacks::didSucceed() must be called when the operation is
|
| + // completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void removeRecursively(const WebURL& path,
|
| WebFileSystemCallbacks) = 0;
|
|
|
| - // Retrieves the metadata information of the file or directory at the given |path|.
|
| - // This may not always return the local platform path in remote filesystem cases.
|
| - // WebFileSystemCallbacks::didReadMetadata() must be called with a valid metadata when the retrieval is completed successfully.
|
| + // Retrieves the metadata information of the file or directory at the given
|
| + // |path|. This may not always return the local platform path in remote
|
| + // filesystem cases. WebFileSystemCallbacks::didReadMetadata() must be called
|
| + // with a valid metadata when the retrieval is completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void readMetadata(const WebURL& path, WebFileSystemCallbacks) = 0;
|
|
|
| @@ -119,7 +124,8 @@ class WebFileSystem {
|
| // If |exclusive| is false, it succeeds if the |path| already exists or
|
| // it has successfully created a new file at |path|.
|
| //
|
| - // WebFileSystemCallbacks::didSucceed() must be called when the operation is completed successfully.
|
| + // WebFileSystemCallbacks::didSucceed() must be called when the operation is
|
| + // completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void createFile(const WebURL& path,
|
| bool exclusive,
|
| @@ -128,7 +134,8 @@ class WebFileSystem {
|
| // Creates a directory at a given |path|.
|
| // If the |path| doesn't exist, it creates a new directory at |path|.
|
| // If |exclusive| is true, it fails if the |path| already exists.
|
| - // If |exclusive| is false, it succeeds if the |path| already exists or it has successfully created a new directory at |path|.
|
| + // If |exclusive| is false, it succeeds if the |path| already exists or it has
|
| + // successfully created a new directory at |path|.
|
| //
|
| // WebFileSystemCallbacks::didSucceed() must be called when
|
| // the operation is completed successfully.
|
| @@ -138,40 +145,52 @@ class WebFileSystem {
|
| WebFileSystemCallbacks) = 0;
|
|
|
| // Checks if a file exists at a given |path|.
|
| - // WebFileSystemCallbacks::didSucceed() must be called when the operation is completed successfully.
|
| + // WebFileSystemCallbacks::didSucceed() must be called when the operation is
|
| + // completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void fileExists(const WebURL& path, WebFileSystemCallbacks) = 0;
|
|
|
| // Checks if a directory exists at a given |path|.
|
| - // WebFileSystemCallbacks::didSucceed() must be called when the operation is completed successfully.
|
| + // WebFileSystemCallbacks::didSucceed() must be called when the operation is
|
| + // completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void directoryExists(const WebURL& path, WebFileSystemCallbacks) = 0;
|
|
|
| - // Reads directory entries of a given directory at |path| and returns a callbacks ID which can be used to wait for additional results.
|
| - // WebFileSystemCallbacks::didReadDirectory() must be called when the operation is completed successfully.
|
| + // Reads directory entries of a given directory at |path| and returns a
|
| + // callbacks ID which can be used to wait for additional results.
|
| + // WebFileSystemCallbacks::didReadDirectory() must be called when the
|
| + // operation is completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual int readDirectory(const WebURL& path, WebFileSystemCallbacks) = 0;
|
|
|
| // Creates a WebFileWriter that can be used to write to the given file.
|
| - // WebFileSystemCallbacks::didCreateFileWriter() must be called with the created WebFileWriter when the operation is completed successfully.
|
| + // WebFileSystemCallbacks::didCreateFileWriter() must be called with the
|
| + // created WebFileWriter when the operation is completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void createFileWriter(const WebURL& path,
|
| WebFileWriterClient*,
|
| WebFileSystemCallbacks) = 0;
|
|
|
| - // Creates a snapshot file for a given file specified by |path|. It returns the metadata of the created snapshot file.
|
| - // The returned metadata should include a local platform path to the snapshot image.
|
| - // In local filesystem cases the backend may simply return the metadata of the file itself (as well as readMetadata does), while in
|
| - // remote filesystem case the backend may download the file into a temporary snapshot file and return the metadata of the temporary file.
|
| + // Creates a snapshot file for a given file specified by |path|. It returns
|
| + // the metadata of the created snapshot file. The returned metadata should
|
| + // include a local platform path to the snapshot image. In local filesystem
|
| + // cases the backend may simply return the metadata of the file itself (as
|
| + // well as readMetadata does), while in remote filesystem case the backend may
|
| + // download the file into a temporary snapshot file and return the metadata of
|
| + // the temporary file.
|
| // The returned metadata is used to create a File object for the |path|.
|
| - // The snapshot file is supposed to be deleted when the last reference to a blink::File referring to it's path is dropped.
|
| - // WebFileSystemCallbacks::didCreateSnapshotFile() with the metadata of the snapshot file must be called when the operation is completed successfully.
|
| + // The snapshot file is supposed to be deleted when the last reference to a
|
| + // blink::File referring to it's path is dropped.
|
| + // WebFileSystemCallbacks::didCreateSnapshotFile() with the metadata of the
|
| + // snapshot file must be called when the operation is completed successfully.
|
| // WebFileSystemCallbacks::didFail() must be called otherwise.
|
| virtual void createSnapshotFileAndReadMetadata(const WebURL& path,
|
| WebFileSystemCallbacks) = 0;
|
|
|
| - // Waits for additional results returned for the method call and returns true if possible.
|
| - // Returns false if there is no running method call corresponding for the given ID.
|
| + // Waits for additional results returned for the method call and returns true
|
| + // if possible.
|
| + // Returns false if there is no running method call corresponding for the
|
| + // given ID.
|
| // |callbacksId| must be the value returned by the original method call.
|
| virtual bool waitForAdditionalResult(int callbacksId) = 0;
|
|
|
|
|