[fsp] Rename ObserveEntry with AddWatcher.

chrome/common/extensions/api/file_system_provider.idl

 // Copyright 2013 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.
 
 // Use the <code>chrome.fileSystemProvider</code> API to create file systems,
 // that can be accessible from the file manager on Chrome OS.
 [platforms=("chromeos"),
  implemented_in="chrome/browser/chromeos/extensions/file_system_provider/file_system_provider_api.h"]
 namespace fileSystemProvider {
   // Error codes used by providing extensions in response to requests. For
@@ skipping 45 matching lines @@
 
     // Mime type for the entry.
     DOMString? mimeType;
 
     // Thumbnail image as a data URI in either PNG, JPEG or WEBP format, at most
     // 32 KB in size. Optional, but can be provided only when explicitly
     // requested by the <code>onGetMetadataRequested</code> event.
     DOMString? thumbnail;
   };
 
-  // Represents an observed entry.
-  dictionary ObservedEntry {
+  // Represents a watcher.
+  dictionary Watcher {
     // The path of the entry being observed.
     DOMString entryPath;
 
-    // Whether observing should include all child entries recursively.
+    // Whether watching should include all child entries recursively. It can be
+    // true for directories only.
     boolean recursive;
 
-    // Tag used by the last notification for the observed path.
+    // Tag used by the last notification for the watcher.
     DOMString? lastTag;
   };
 
   // Represents a mounted file system.
   dictionary FileSystemInfo {
     // The identifier of the file system.
     DOMString fileSystemId;
 
     // A human-readable name for the file system. 
     DOMString displayName;
 
     // Whether the file system supports operations which may change contents
     // of the file system (such as creating, deleting or writing to files).
     boolean writable;
 
     // Whether the file system supports the <code>tag</code> field for observing
     // directories.
     [nodoc] boolean? supportsNotifyTag;
 
-    // List of observed entries.
-    [nodoc] ObservedEntry[] observedEntries;
+    // List of watchers.
+    [nodoc] Watcher[] watchers;
   };
 
   // Options for the <code>mount()</code> method.
   dictionary MountOptions {
     // The string indentifier of the file system. Must be unique per each
     // extension.
     DOMString fileSystemId;
 
     // A human-readable name for the file system. 
     DOMString displayName;
@@ skipping 203 matching lines @@
     // The identifier of the file system related to this operation.
     DOMString fileSystemId;
 
     // The unique identifier of this request.
     long requestId;
 
     // An ID of the request to be aborted.
     long operationRequestId;
   };
 
-  // Options for the <code>onObserveDirectoryRequested()</code> event.
-  dictionary ObserveDirectoryRequestedOptions {
+  // Options for the <code>onAddWatcherRequested()</code> event.
+  dictionary AddWatcherRequestedOptions {
     // The identifier of the file system related to this operation.
     DOMString fileSystemId;
 
     // The unique identifier of this request.
     long requestId;
 
-    // The path of the directory to be observed.
-    DOMString directoryPath;
+    // The path of the entry to be observed.
+    DOMString entryPath;
 
-    // Whether observing should include all child entries recursively.
+    // Whether observing should include all child entries recursively. It can be
+    // true for directories only.
     boolean recursive;
   };
 
-  // Options for the <code>onUnobserveEntryRequested()</code> event.
-  dictionary UnobserveEntryRequestedOptions {
+  // Options for the <code>onRemoveWatcherRequested()</code> event.
+  dictionary RemoveWatcherRequestedOptions {
     // The identifier of the file system related to this operation.
     DOMString fileSystemId;
 
     // The unique identifier of this request.
     long requestId;
 
-    // Mode of the observed entry.
+    // The path of the watched entry.
+    DOMString entryPath;
+
+    // Mode of the watcher.
     boolean recursive;
-
-    // The path of the entry to be not observed anymore.
-    DOMString entryPath;
   };
 
   // Information about a change happened to an entry within the observed
   // directory (including the entry itself).
   dictionary Change {
     // The path of the changed entry.
     DOMString entryPath;
 
     // The type of the change which happened to the entry.
     ChangeType changeType;
@@ skipping 223 matching lines @@
     // </code> must be called. Note, that callbacks of the aborted operation
     // must not be called, as they will be ignored. Despite calling <code>
     // errorCallback</code>, the request may be forcibly aborted. 
     [maxListeners=1] static void onAbortRequested(
         AbortRequestedOptions options,
         ProviderSuccessCallback successCallback,
         ProviderErrorCallback errorCallback);
 
     // Raised when setting a new directory watcher is requested. If an error
     // occurs, then <code>errorCallback</code> must be called.
-    [maxListeners=1, nodoc] static void onObserveDirectoryRequested(
-      ObserveDirectoryRequestedOptions options,
+    [maxListeners=1, nodoc] static void onAddWatcherRequested(
+      AddWatcherRequestedOptions options,
       ProviderSuccessCallback successCallback,
       ProviderErrorCallback errorCallback);
 
-    // Raised when the entry should no longer be observed. If an error occurs,
-    // then <code>errorCallback</code> must be called.
-    [maxListeners=1, nodoc] static void onUnobserveEntryRequested(
-      UnobserveEntryRequestedOptions options,
+    // Raised when the watcher should be removed. If an error occurs, then
+    // <code>errorCallback</code> must be called.
+    [maxListeners=1, nodoc] static void onRemoveWatcherRequested(
+      RemoveWatcherRequestedOptions options,
       ProviderSuccessCallback successCallback,
       ProviderErrorCallback errorCallback);
   };
 };