Add verbs API to file handlers. Modify the Chrome OS UI so that it displayes the internationalized …

third_party/closure_compiler/externs/file_manager_private.js

-// Copyright 2014 The Chromium Authors. All rights reserved.
+// Copyright 2016 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.
 
+// This file was generated by:

[cmihail, 2016/05/18 02:35:31]

git cl upload asked me to run next command fro this file:
python tools/json_schema_compiler/compiler.py
/usr/local/google/home/cmihail/chrome/src/chrome/common/extensions/api/file_manager_private.idl
--root=. --generator=externs >
/usr/local/google/home/cmihail/chrome/src/third_party/closure_compiler/externs/file_manager_private.js
Though I ended up with more changes, plus it asks me to do some extra changes to
README.chromium (I've ignore that).

Should I just revert this file or go forward with the change (I can ignore it).

[Devlin, 2016/05/18 18:49:41]

This is correct.  The reason there are so many changes is because other people
didn't do it. :)

[cmihail, 2016/05/18 22:53:36]

Hmm, I tried running third_party/closure_compiler/run_compiler as mentioned at
https://chromium.googlesource.com/chromium/src/+/master/docs/closure_compilat...,
but it fails with errors unrelated to the verbs change.

Any recommendations? I don't want to mix up changes that fix things unrelated to
a CL that is already big enough, especially if ending up in a need to revert the
change.

Also, not sure what exactly to write in README.chromium as mostly they contain
license information unrelated to private APIs.

+//   tools/json_schema_compiler/compiler.py.
+// NOTE: The format of types has changed. 'FooType' is now
+//   'chrome.fileManagerPrivate.FooType'.
+// Please run the closure compiler before committing changes.
+// See https://chromium.googlesource.com/chromium/src/+/master/docs/closure_compilation.md
+
 /** @fileoverview Externs generated from namespace: fileManagerPrivate */
 
 /**
+ * @const
+ */
+chrome.fileManagerPrivate = {};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-VolumeType
+ */
+chrome.fileManagerPrivate.VolumeType = {
+  DRIVE: 'drive',
+  DOWNLOADS: 'downloads',
+  REMOVABLE: 'removable',
+  ARCHIVE: 'archive',
+  PROVIDED: 'provided',
+  MTP: 'mtp',
+  TESTING: 'testing',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-DeviceType
+ */
+chrome.fileManagerPrivate.DeviceType = {
+  USB: 'usb',
+  SD: 'sd',
+  OPTICAL: 'optical',
+  MOBILE: 'mobile',
+  UNKNOWN: 'unknown',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-MountCondition
+ */
+chrome.fileManagerPrivate.MountCondition = {
+  UNKNOWN: 'unknown',
+  UNSUPPORTED: 'unsupported',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-MountContext
+ */
+chrome.fileManagerPrivate.MountContext = {
+  USER: 'user',
+  AUTO: 'auto',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-MountCompletedEventType
+ */
+chrome.fileManagerPrivate.MountCompletedEventType = {
+  MOUNT: 'mount',
+  UNMOUNT: 'unmount',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-MountCompletedStatus
+ */
+chrome.fileManagerPrivate.MountCompletedStatus = {
+  SUCCESS: 'success',
+  ERROR_UNKNOWN: 'error_unknown',
+  ERROR_INTERNAL: 'error_internal',
+  ERROR_INVALID_ARGUMENT: 'error_invalid_argument',
+  ERROR_INVALID_PATH: 'error_invalid_path',
+  ERROR_PATH_ALREADY_MOUNTED: 'error_path_already_mounted',
+  ERROR_PATH_NOT_MOUNTED: 'error_path_not_mounted',
+  ERROR_DIRECTORY_CREATION_FAILED: 'error_directory_creation_failed',
+  ERROR_INVALID_MOUNT_OPTIONS: 'error_invalid_mount_options',
+  ERROR_INVALID_UNMOUNT_OPTIONS: 'error_invalid_unmount_options',
+  ERROR_INSUFFICIENT_PERMISSIONS: 'error_insufficient_permissions',
+  ERROR_MOUNT_PROGRAM_NOT_FOUND: 'error_mount_program_not_found',
+  ERROR_MOUNT_PROGRAM_FAILED: 'error_mount_program_failed',
+  ERROR_INVALID_DEVICE_PATH: 'error_invalid_device_path',
+  ERROR_UNKNOWN_FILESYSTEM: 'error_unknown_filesystem',
+  ERROR_UNSUPPORTED_FILESYSTEM: 'error_unsupported_filesystem',
+  ERROR_INVALID_ARCHIVE: 'error_invalid_archive',
+  ERROR_AUTHENTICATION: 'error_authentication',
+  ERROR_PATH_UNMOUNTED: 'error_path_unmounted',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-TransferState
+ */
+chrome.fileManagerPrivate.TransferState = {
+  IN_PROGRESS: 'in_progress',
+  COMPLETED: 'completed',
+  FAILED: 'failed',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-TransferType
+ */
+chrome.fileManagerPrivate.TransferType = {
+  UPLOAD: 'upload',
+  DOWNLOAD: 'download',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-CopyProgressStatusType
+ */
+chrome.fileManagerPrivate.CopyProgressStatusType = {
+  BEGIN_COPY_ENTRY: 'begin_copy_entry',
+  END_COPY_ENTRY: 'end_copy_entry',
+  PROGRESS: 'progress',
+  SUCCESS: 'success',
+  ERROR: 'error',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-FileWatchEventType
+ */
+chrome.fileManagerPrivate.FileWatchEventType = {
+  CHANGED: 'changed',
+  ERROR: 'error',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-ChangeType
+ */
+chrome.fileManagerPrivate.ChangeType = {
+  ADD_OR_UPDATE: 'add_or_update',
+  DELETE: 'delete',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-SearchType
+ */
+chrome.fileManagerPrivate.SearchType = {
+  EXCLUDE_DIRECTORIES: 'EXCLUDE_DIRECTORIES',
+  SHARED_WITH_ME: 'SHARED_WITH_ME',
+  OFFLINE: 'OFFLINE',
+  ALL: 'ALL',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-ZoomOperationType
+ */
+chrome.fileManagerPrivate.ZoomOperationType = {
+  IN: 'in',
+  OUT: 'out',
+  RESET: 'reset',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-InspectionType
+ */
+chrome.fileManagerPrivate.InspectionType = {
+  NORMAL: 'normal',
+  CONSOLE: 'console',
+  ELEMENT: 'element',
+  BACKGROUND: 'background',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-DeviceEventType
+ */
+chrome.fileManagerPrivate.DeviceEventType = {
+  DISABLED: 'disabled',
+  REMOVED: 'removed',
+  HARD_UNPLUGGED: 'hard_unplugged',
+  FORMAT_START: 'format_start',
+  FORMAT_SUCCESS: 'format_success',
+  FORMAT_FAIL: 'format_fail',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-DriveSyncErrorType
+ */
+chrome.fileManagerPrivate.DriveSyncErrorType = {
+  DELETE_WITHOUT_PERMISSION: 'delete_without_permission',
+  SERVICE_UNAVAILABLE: 'service_unavailable',
+  NO_SERVER_SPACE: 'no_server_space',
+  MISC: 'misc',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-TaskResult
+ */
+chrome.fileManagerPrivate.TaskResult = {
+  OPENED: 'opened',
+  MESSAGE_SENT: 'message_sent',
+  FAILED: 'failed',
+  EMPTY: 'empty',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-DriveShareType
+ */
+chrome.fileManagerPrivate.DriveShareType = {
+  CAN_EDIT: 'can_edit',
+  CAN_COMMENT: 'can_comment',
+  CAN_VIEW: 'can_view',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-EntryPropertyName
+ */
+chrome.fileManagerPrivate.EntryPropertyName = {
+  SIZE: 'size',
+  MODIFICATION_TIME: 'modificationTime',
+  THUMBNAIL_URL: 'thumbnailUrl',
+  CROPPED_THUMBNAIL_URL: 'croppedThumbnailUrl',
+  IMAGE_WIDTH: 'imageWidth',
+  IMAGE_HEIGHT: 'imageHeight',
+  IMAGE_ROTATION: 'imageRotation',
+  PINNED: 'pinned',
+  PRESENT: 'present',
+  HOSTED: 'hosted',
+  AVAILABLE_OFFLINE: 'availableOffline',
+  AVAILABLE_WHEN_METERED: 'availableWhenMetered',
+  DIRTY: 'dirty',
+  CUSTOM_ICON_URL: 'customIconUrl',
+  CONTENT_MIME_TYPE: 'contentMimeType',
+  SHARED_WITH_ME: 'sharedWithMe',
+  SHARED: 'shared',
+  EXTERNAL_FILE_URL: 'externalFileUrl',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-EntryTagVisibility
+ */
+chrome.fileManagerPrivate.EntryTagVisibility = {
+  PRIVATE: 'private',
+  PUBLIC: 'public',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-Source
+ */
+chrome.fileManagerPrivate.Source = {
+  FILE: 'file',
+  DEVICE: 'device',
+  NETWORK: 'network',
+  SYSTEM: 'system',
+};
+
+/**
+ * @enum {string}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-Verb
+ */
+chrome.fileManagerPrivate.Verb = {
+  OPEN_WITH: 'open_with',
+  ADD_TO: 'add_to',
+  PACK_WITH: 'pack_with',
+};
+
+/**
  * @typedef {{
  *   taskId: string,
  *   title: string,
+ *   verb: !chrome.fileManagerPrivate.Verb,
  *   iconUrl: string,
- *   isDefault: boolean
+ *   isDefault: boolean,
+ *   isGenericFileHandler: boolean
  * }}
- */
-var FileTask;
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-FileTask
+ */
+chrome.fileManagerPrivate.FileTask;
 
 /**
  * @typedef {{
  *   size: (number|undefined),
  *   modificationTime: (number|undefined),
  *   thumbnailUrl: (string|undefined),
  *   croppedThumbnailUrl: (string|undefined),
- *   externalFileUrl: (string|undefined),
  *   imageWidth: (number|undefined),
  *   imageHeight: (number|undefined),
  *   imageRotation: (number|undefined),
  *   pinned: (boolean|undefined),
  *   present: (boolean|undefined),
  *   hosted: (boolean|undefined),
- *   dirty: (boolean|undefined),
  *   availableOffline: (boolean|undefined),
  *   availableWhenMetered: (boolean|undefined),
+ *   dirty: (boolean|undefined),
  *   customIconUrl: (string|undefined),
  *   contentMimeType: (string|undefined),
  *   sharedWithMe: (boolean|undefined),
- *   shared: (boolean|undefined)
+ *   shared: (boolean|undefined),
+ *   externalFileUrl: (string|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-EntryProperties
  */
-var EntryProperties;
+chrome.fileManagerPrivate.EntryProperties;
 
 /**
  * @typedef {{
  *   totalSize: number,
  *   remainingSize: number
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-MountPointSizeStats
  */
-var MountPointSizeStats;
+chrome.fileManagerPrivate.MountPointSizeStats;
 
 /**
  * @typedef {{
  *   profileId: string,
  *   displayName: string,
  *   isCurrentProfile: boolean
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-ProfileInfo
  */
-var ProfileInfo;
+chrome.fileManagerPrivate.ProfileInfo;
 
 /**
  * @typedef {{
  *   volumeId: string,
  *   fileSystemId: (string|undefined),
  *   extensionId: (string|undefined),
- *   source: string,
+ *   source: !chrome.fileManagerPrivate.Source,
  *   volumeLabel: (string|undefined),
- *   profile: ProfileInfo,
+ *   profile: !chrome.fileManagerPrivate.ProfileInfo,
  *   sourcePath: (string|undefined),
- *   volumeType: string,
- *   deviceType: (string|undefined),
+ *   volumeType: !chrome.fileManagerPrivate.VolumeType,
+ *   deviceType: (!chrome.fileManagerPrivate.DeviceType|undefined),
  *   devicePath: (string|undefined),
  *   isParentDevice: (boolean|undefined),
  *   isReadOnly: boolean,
  *   hasMedia: boolean,
  *   configurable: boolean,
  *   watchable: boolean,
- *   mountCondition: (string|undefined),
- *   mountContext: (string|undefined)
+ *   mountCondition: (!chrome.fileManagerPrivate.MountCondition|undefined),
+ *   mountContext: (!chrome.fileManagerPrivate.MountContext|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-VolumeMetadata
  */
-var VolumeMetadata;
+chrome.fileManagerPrivate.VolumeMetadata;
 
 /**
  * @typedef {{
- *   eventType: string,
- *   status: string,
- *   volumeMetadata: VolumeMetadata,
+ *   eventType: !chrome.fileManagerPrivate.MountCompletedEventType,
+ *   status: !chrome.fileManagerPrivate.MountCompletedStatus,
+ *   volumeMetadata: !chrome.fileManagerPrivate.VolumeMetadata,
  *   shouldNotify: boolean
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-MountCompletedEvent
  */
-var MountCompletedEvent;
+chrome.fileManagerPrivate.MountCompletedEvent;
 
 /**
  * @typedef {{
  *   fileUrl: string,
- *   transferState: string,
- *   transferType: string,
+ *   transferState: !chrome.fileManagerPrivate.TransferState,
+ *   transferType: !chrome.fileManagerPrivate.TransferType,
  *   processed: number,
  *   total: number,
  *   num_total_jobs: number
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-FileTransferStatus
  */
-var FileTransferStatus;
+chrome.fileManagerPrivate.FileTransferStatus;
 
 /**
  * @typedef {{
- *   type: string,
+ *   type: !chrome.fileManagerPrivate.DriveSyncErrorType,
  *   fileUrl: string
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-DriveSyncErrorEvent
  */
-var DriveSyncErrorEvent;
+chrome.fileManagerPrivate.DriveSyncErrorEvent;
 
 /**
  * @typedef {{
- *   type: string,
+ *   type: !chrome.fileManagerPrivate.CopyProgressStatusType,
  *   sourceUrl: (string|undefined),
  *   destinationUrl: (string|undefined),
  *   size: (number|undefined),
  *   error: (string|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-CopyProgressStatus
  */
-var CopyProgressStatus;
+chrome.fileManagerPrivate.CopyProgressStatus;
 
 /**
  * @typedef {{
  *   url: string,
- *   changes: Array
+ *   changes: !Array<!chrome.fileManagerPrivate.ChangeType>
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-FileChange
  */
-var FileChange;
+chrome.fileManagerPrivate.FileChange;
 
 /**
  * @typedef {{
- *   eventType: string,
+ *   eventType: !chrome.fileManagerPrivate.FileWatchEventType,
  *   entry: Object,
- *   changedFiles: (Array|undefined)
+ *   changedFiles: (!Array<!chrome.fileManagerPrivate.FileChange>|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-FileWatchEvent
  */
-var FileWatchEvent;
+chrome.fileManagerPrivate.FileWatchEvent;
 
 /**
  * @typedef {{
  *   driveEnabled: boolean,
  *   cellularDisabled: boolean,
  *   hostedFilesDisabled: boolean,
  *   searchSuggestEnabled: boolean,
  *   use24hourClock: boolean,
  *   allowRedeemOffers: boolean,
  *   timezone: string
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-Preferences
  */
-var Preferences;
+chrome.fileManagerPrivate.Preferences;
 
 /**
  * @typedef {{
  *   cellularDisabled: (boolean|undefined),
  *   hostedFilesDisabled: (boolean|undefined)
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-PreferencesChange
  */
-var PreferencesChange;
+chrome.fileManagerPrivate.PreferencesChange;
 
 /**
  * @typedef {{
  *   query: string,
  *   nextFeed: string
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-SearchParams
  */
-var SearchParams;
+chrome.fileManagerPrivate.SearchParams;
 
 /**
  * @typedef {{
  *   query: string,
- *   types: string,
+ *   types: !chrome.fileManagerPrivate.SearchType,
  *   maxResults: number
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-SearchMetadataParams
  */
-var SearchMetadataParams;
+chrome.fileManagerPrivate.SearchMetadataParams;
 
 /**
  * @typedef {{
  *   entry: Object,
  *   highlightedBaseName: string
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-SearchResult
  */
-var SearchResult;
+chrome.fileManagerPrivate.SearchResult;
 
 /**
  * @typedef {{
  *   type: string,
- *   reason: (string|undefined)
+ *   reason: (string|undefined),
+ *   hasCellularNetworkAccess: boolean
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-DriveConnectionState
  */
-var DriveConnectionState;
+chrome.fileManagerPrivate.DriveConnectionState;
 
 /**
  * @typedef {{
- *   type: string,
+ *   type: !chrome.fileManagerPrivate.DeviceEventType,
  *   devicePath: string
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-DeviceEvent
  */
-var DeviceEvent;
+chrome.fileManagerPrivate.DeviceEvent;
 
 /**
  * @typedef {{
  *   extensionId: string,
  *   name: string,
  *   configurable: boolean,
  *   watchable: boolean,
  *   multipleMounts: boolean,
- *   source: string
+ *   source: !chrome.fileManagerPrivate.manifestTypes.FileSystemProviderSource
  * }}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#type-ProvidingExtension
  */
-var ProvidingExtension;
-
-/**
- * @typedef {{
- *   id: string,
- *   title: (string|undefined)
- * }}
- */
-var EntryAction;
-
-/**
- * @const
- */
-chrome.fileManagerPrivate = {};
+chrome.fileManagerPrivate.ProvidingExtension;
 
 /**
  * Logout the current user for navigating to the re-authentication screen for
  * the Google account.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-logoutUserForReauthentication
  */
 chrome.fileManagerPrivate.logoutUserForReauthentication = function() {};
 
 /**
  * Cancels file selection.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-cancelDialog
  */
 chrome.fileManagerPrivate.cancelDialog = function() {};
 
 /**
  * Executes file browser task over selected files. |taskId| The unique
- * identifier of task to execute. |entries| Array of file entries |callback|
+ * identifier of task to execute. |entries| Array of entries |callback|
  * @param {string} taskId
- * @param {!Array<!Entry>} entries
- * @param {function((boolean|undefined))} callback |result| Result of the task
- *     execution.
+ * @param {!Array<Object>} entries
+ * @param {function(!chrome.fileManagerPrivate.TaskResult):void} callback
+ *     |result| Result of the task execution.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-executeTask
  */
 chrome.fileManagerPrivate.executeTask = function(taskId, entries, callback) {};
 
 /**
- * Sets the default task for the supplied MIME types and path extensions.
- * Lists of MIME types and entries may contain duplicates.
- * |taskId| The unique identifier of task to mark as default. |entries| Array
- * of selected file entries to extract path extensions from. |mimeTypes| Array
- * of selected file MIME types. |callback|
+ * Sets the default task for the supplied MIME types and path extensions. Lists
+ * of MIME types and URLs may contain duplicates. Additionally, the list of MIME
+ * types can be empty. |taskId| The unique identifier of task to mark as
+ * default. |entries| Array of selected entries to extract path extensions from.
+ * |mimeTypes| Array of selected file MIME types. |callback|
  * @param {string} taskId
- * @param {!Array<!Entry>} entries
+ * @param {!Array<Object>} entries
  * @param {!Array<string>} mimeTypes
- * @param {!function()} callback Callback that does not take arguments.
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-setDefaultTask
  */
-chrome.fileManagerPrivate.setDefaultTask = function(taskId, entries, mimeTypes,
-    callback) {};
+chrome.fileManagerPrivate.setDefaultTask = function(taskId, entries, mimeTypes, callback) {};
 
 /**
  * Gets the list of tasks that can be performed over selected files. |entries|
  * Array of selected entries |callback|
- * @param {!Array<!Entry>} entries
- * @param {function((!Array<!FileTask>|undefined))} callback |tasks| The list of
- *     matched file entries for this task.
+ * @param {!Array<Object>} entries
+ * @param {function(!Array<!chrome.fileManagerPrivate.FileTask>):void} callback
+ *     |tasks| The list of matched file entries for this task.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getFileTasks
  */
 chrome.fileManagerPrivate.getFileTasks = function(entries, callback) {};
 
 /**
+ * Gets the MIME type of a file. |entry| Entry to be checked. |callback|
+ * @param {Object} entry
+ * @param {function(string):void} callback |result| Mime type of the file.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getMimeType
+ */
+chrome.fileManagerPrivate.getMimeType = function(entry, callback) {};
+
+/**
  * Gets localized strings and initialization data. |callback|
- * @param {function((!Object|undefined))} callback |result| Hash containing the
- *     string assets.
+ * @param {function(Object):void} callback |result| Hash containing the string
+ *     assets.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getStrings
  */
 chrome.fileManagerPrivate.getStrings = function(callback) {};
 
 /**
- * Adds file watch. |entry| Entry of file to watch |callback|
- * @param {!Entry} entry
- * @param {function((boolean|undefined))} callback |success| True when file
- *     watch is successfully added.
+ * Adds file watch. |entry| Entry to watch |callback|
+ * @param {Object} entry
+ * @param {function(boolean):void} callback |success| True when file watch is
+ *     successfully added.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-addFileWatch
  */
 chrome.fileManagerPrivate.addFileWatch = function(entry, callback) {};
 
 /**
- * Removes file watch. |entry| Entry of watched file to remove |callback|
- * @param {!Entry} entry
- * @param {function((boolean|undefined))} callback |success| True when file
- *     watch is successfully
- * removed.
+ * Removes file watch. |entry| Watched entry |callback|
+ * @param {Object} entry
+ * @param {function(boolean):void} callback |success| True when file watch is
+ *     successfully removed.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-removeFileWatch
  */
 chrome.fileManagerPrivate.removeFileWatch = function(entry, callback) {};
 
 /**
  * Enables the extenal file scheme necessary to initiate drags to the browser
  * window for files on the external backend.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-enableExternalFileScheme
  */
 chrome.fileManagerPrivate.enableExternalFileScheme = function() {};
 
 /**
- * Requests R/W access to the specified entries as |entryUrls|. Note, that only
- * files backed by external file system backend will be granted the access.
+ * Requests granting R/W permissions for the passed entries. It's a best effort
+ * operation. Some files may not be granted access if the url is invalid or not
+ * backed by the external file system. |entryUrls| Urls for the entries to be
+ * accessed. |callback|
  * @param {!Array<string>} entryUrls
- * @param {function()} callback Completion callback.
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-grantAccess
  */
 chrome.fileManagerPrivate.grantAccess = function(entryUrls, callback) {};
 
 /**
  * Selects multiple files. |selectedPaths| Array of selected paths
  * |shouldReturnLocalPath| true if paths need to be resolved to local paths.
  * |callback|
  * @param {!Array<string>} selectedPaths
  * @param {boolean} shouldReturnLocalPath
- * @param {function()} callback Callback that does not take arguments.
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-selectFiles
  */
-chrome.fileManagerPrivate.selectFiles = function(selectedPaths,
-    shouldReturnLocalPath, callback) {};
+chrome.fileManagerPrivate.selectFiles = function(selectedPaths, shouldReturnLocalPath, callback) {};
 
 /**
  * Selects a file. |selectedPath| A selected path |index| Index of Filter
  * |forOpening| true if paths are selected for opening. false if for saving.
  * |shouldReturnLocalPath| true if paths need to be resolved to local paths.
  * |callback|
  * @param {string} selectedPath
  * @param {number} index
  * @param {boolean} forOpening
  * @param {boolean} shouldReturnLocalPath
- * @param {function()} callback Callback that does not take arguments.
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-selectFile
  */
-chrome.fileManagerPrivate.selectFile = function(selectedPath, index, forOpening,
-    shouldReturnLocalPath, callback) {};
+chrome.fileManagerPrivate.selectFile = function(selectedPath, index, forOpening, shouldReturnLocalPath, callback) {};
 
 /**
- * Requests additional properties for files. |entries| list of entries of files
- * |callback|
- * @param {!Array<!Entry>} entries
- * @param {!Array<string>} names
- * @param {function((!Array<!EntryProperties>|undefined))} callback
- *     |entryProperties| A dictionary containing properties of the requested
- *     entries.
+ * Requests additional properties for files. |entries| list of entries |names|
+ * list of requested properties by their names. |callback| Completion callback.
+ * May return less than requested properties     if some are not available. In
+ * the same time, it can return properties     which were not requested (if it's
+ * cheap to compute them).
+ * @param {!Array<Object>} entries
+ * @param {!Array<!chrome.fileManagerPrivate.EntryPropertyName>} names
+ * @param {function(!Array<!chrome.fileManagerPrivate.EntryProperties>):void}
+ *     callback |entryProperties| A dictionary containing properties of the
+ *     requested entries.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getEntryProperties
  */
-chrome.fileManagerPrivate.getEntryProperties = function(entries, names,
-    callback) {};
+chrome.fileManagerPrivate.getEntryProperties = function(entries, names, callback) {};
 
 /**
- * Pins/unpins a Drive file in the cache. |entry| Entry of a file to pin/unpin.
- * |pin| Pass true to pin the file. |callback| Completion callback.
+ * Pins/unpins a Drive file in the cache. |entry| Entry to pin/unpin. |pin| Pass
+ * true to pin the file. |callback| Completion callback.
  * $(ref:runtime.lastError) will be set if     there was an error.
- * @param {!Entry} entry
+ * @param {Object} entry
  * @param {boolean} pin
- * @param {function()} callback Callback that does not take arguments.
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-pinDriveFile
  */
 chrome.fileManagerPrivate.pinDriveFile = function(entry, pin, callback) {};
 
 /**
- * Resolves file entries in the isolated file system and returns corresponding
+ * Resolves entries in the isolated file system and returns corresponding
  * entries in the external file system mounted to Chrome OS file manager
  * backend. If resolving entry fails, the entry will be just ignored and the
  * corresponding entry does not appear in the result.
- * @param {!Array<!Entry>} entries
- * @param {function((!Array<!Entry>|undefined))} callback Completion callback
- *     with resolved entries.
+ * @param {!Array<Object>} entries
+ * @param {function(!Array<Object>):void} callback |entries| External entries.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-resolveIsolatedEntries
  */
-chrome.fileManagerPrivate.resolveIsolatedEntries = function(entries,
-    callback) {};
+chrome.fileManagerPrivate.resolveIsolatedEntries = function(entries, callback) {};
 
 /**
- * Mount a resource or a file. |source| Mount point source. For compressed
- * files it is relative file path     within external file system |callback|
+ * Mount a resource or a file. |source| Mount point source. For compressed files
+ * it is relative file path     within external file system |callback|
  * @param {string} source
- * @param {function((string|undefined))} callback Callback with source path of
- *     the mount.
+ * @param {function(string):void} callback |sourcePath| Source path of the
+ *     mount.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-addMount
  */
 chrome.fileManagerPrivate.addMount = function(source, callback) {};
 
 /**
  * Unmounts a mounted resource. |volumeId| An ID of the volume.
  * @param {string} volumeId
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-removeMount
  */
 chrome.fileManagerPrivate.removeMount = function(volumeId) {};
 
 /**
  * Get the list of mounted volumes. |callback|
- * @param {function((!Array<!VolumeMetadata>|undefined))} callback Callback with
- *     the list of VolumeMetadata representing mounted volumes.
+ * @param {function(!Array<!chrome.fileManagerPrivate.VolumeMetadata>):void}
+ *     callback |volumeMetadataList| The list of VolumeMetadata representing
+ *     mounted volumes.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getVolumeMetadataList
  */
 chrome.fileManagerPrivate.getVolumeMetadataList = function(callback) {};
 
 /**
  * Cancels ongoing file transfers for selected files. |entries| Array of files
- * for which ongoing transfer should be canceled.
- * @param {!Array<!FileEntry>} entries
- * @param {function()} callback
+ * for which ongoing transfer should be canceled. |callback| Completion callback
+ * of the cancel.
+ * @param {!Array<Object>} entries
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-cancelFileTransfers
  */
 chrome.fileManagerPrivate.cancelFileTransfers = function(entries, callback) {};
 
 /**
- * Cancels all ongoing file transfers.
- * @param {function()} callback
+ * Cancels all ongoing file transfers. |callback| Completion callback of the
+ * cancel.
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-cancelAllFileTransfers
  */
 chrome.fileManagerPrivate.cancelAllFileTransfers = function(callback) {};
 
 /**
  * Starts to copy an entry. If the source is a directory, the copy is done
- * recursively. |entry| Entry of the source entry to be copied. |parent| Entry
- * of the destination directory. |newName| Name of the new entry. It must not
- * contain '/'. |callback| Completion callback.
- * @param {!Entry} entry
- * @param {!DirectoryEntry} parentEntry
+ * recursively. |entry| Entry of the source entry to be copied. |parentEntry|
+ * Entry for the destination (parent) directory. |newName| Name of the new
+ * entry. It must not contain '/'. |callback| Completion callback.
+ * @param {Object} entry
+ * @param {Object} parentEntry
  * @param {string} newName
- * @param {function((number|undefined))} callback |copyId| ID of the copy task.
- *     Can be used to identify the progress, and to cancel the task.
+ * @param {function(number):void} callback |copyId| ID of the copy task. Can be
+ *     used to identify the progress, and to cancel the task.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-startCopy
  */
-chrome.fileManagerPrivate.startCopy = function(entry, parentEntry, newName,
-    callback) {};
+chrome.fileManagerPrivate.startCopy = function(entry, parentEntry, newName, callback) {};
 
 /**
  * Cancels the running copy task. |copyId| ID of the copy task to be cancelled.
  * |callback| Completion callback of the cancel.
  * @param {number} copyId
- * @param {function()} callback Callback that does not take arguments.
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-cancelCopy
  */
 chrome.fileManagerPrivate.cancelCopy = function(copyId, callback) {};
 
 /**
  * Retrieves total and remaining size of a mount point. |volumeId| ID of the
  * volume to be checked. |callback|
  * @param {string} volumeId
- * @param {function((!MountPointSizeStats|undefined))} callback Name/value pairs
- *     of size stats. Will be undefined if stats could not be determined.
+ * @param {function(!chrome.fileManagerPrivate.MountPointSizeStats):void}
+ *     callback |sizeStats| Name/value pairs of size stats. Will be undefined if
+ *     stats could not be determined.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getSizeStats
  */
 chrome.fileManagerPrivate.getSizeStats = function(volumeId, callback) {};
 
 /**
  * Formats a mounted volume. |volumeId| ID of the volume to be formatted.
  * @param {string} volumeId
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-formatVolume
  */
 chrome.fileManagerPrivate.formatVolume = function(volumeId) {};
 
 /**
  * Retrieves file manager preferences. |callback|
- * @param {function((!Preferences|undefined))} callback
+ * @param {function(!chrome.fileManagerPrivate.Preferences):void} callback
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getPreferences
  */
 chrome.fileManagerPrivate.getPreferences = function(callback) {};
 
 /**
  * Sets file manager preferences. |changeInfo|
- * @param {PreferencesChange} changeInfo
+ * @param {!chrome.fileManagerPrivate.PreferencesChange} changeInfo
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-setPreferences
  */
 chrome.fileManagerPrivate.setPreferences = function(changeInfo) {};
 
 /**
  * Performs drive content search. |searchParams| |callback|
- * @param {SearchParams} searchParams
- * @param {function((!Array<Entry>|undefined), (string|undefined))} callback
- * Entries and ID of the feed that contains next chunk of the search result.
- * Should be sent to the next searchDrive request to perform incremental search.
+ * @param {!chrome.fileManagerPrivate.SearchParams} searchParams
+ * @param {function(!Array<Object>, string):void} callback |entries| |nextFeed|
+ *     ID of the feed that contains next chunk of the search result.     Should
+ *     be sent to the next searchDrive request to perform     incremental
+ *     search.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-searchDrive
  */
 chrome.fileManagerPrivate.searchDrive = function(searchParams, callback) {};
 
 /**
  * Performs drive metadata search. |searchParams| |callback|
- * @param {SearchMetadataParams} searchParams
- * @param {function((!Array<!SearchResult>|undefined))} callback
+ * @param {!chrome.fileManagerPrivate.SearchMetadataParams} searchParams
+ * @param {function(!Array<!chrome.fileManagerPrivate.SearchResult>):void}
+ *     callback
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-searchDriveMetadata
  */
-chrome.fileManagerPrivate.searchDriveMetadata = function(searchParams,
-    callback) {};
+chrome.fileManagerPrivate.searchDriveMetadata = function(searchParams, callback) {};
 
 /**
- * Search for files in the given volume, whose content hash matches the list of
- * given hashes.
+ * Search files in the volume having |volumeId| by using |hashList|.
+ * sub-directories) the given |targetDirectoryUrl|.
  * @param {string} volumeId
- * @param {!Array<string>} hashes
- * @param {function((!Object<string, !Array<string>>|undefined))} callback
+ * @param {!Array<string>} hashList
+ * @param {function(Object):void} callback |urls| The map of hash and array of
+ *     FileEntry's URL. The array can be empty if the corresponding file is not
+ *     found.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-searchFilesByHashes
  */
-chrome.fileManagerPrivate.searchFilesByHashes = function(volumeId, hashes,
-    callback) {};
+chrome.fileManagerPrivate.searchFilesByHashes = function(volumeId, hashList, callback) {};
 
 /**
  * Create a zip file for the selected files. |parentEntry| Entry of the
- * directory containing the selected files. |entries| Selected entries.
- * The files must be under the directory specified by |parentEntry|. |destName|
- * Name of the destination zip file. The zip file will be created under the
- * directory specified by |parentEntry|.
- * @param {!DirectoryEntry} parentEntry
- * @param {!Array<!Entry>} entries
+ * directory containing the selected files. |entries| Entries of the selected
+ * files. The files must be under the     directory specified by |parentEntry|.
+ * |destName| Name of the destination zip file. The zip file will be created
+ * under the directory specified by |parentEntry|. |callback| TODO(mtomasz):
+ * Swap order of |entries| and |parentEntry|.
+ * @param {Object} parentEntry
+ * @param {!Array<Object>} entries
  * @param {string} destName
- * @param {function((boolean|undefined))} callback
+ * @param {function(boolean):void} callback
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-zipSelection
  */
-chrome.fileManagerPrivate.zipSelection = function(parentEntry, entries,
-    destName, callback) {};
+chrome.fileManagerPrivate.zipSelection = function(parentEntry, entries, destName, callback) {};
 
 /**
  * Retrieves the state of the current drive connection. |callback|
- * @param {function((!DriveConnectionState|undefined))} callback
+ * @param {function(!chrome.fileManagerPrivate.DriveConnectionState):void}
+ *     callback
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getDriveConnectionState
  */
 chrome.fileManagerPrivate.getDriveConnectionState = function(callback) {};
 
 /**
  * Checks whether the path name length fits in the limit of the filesystem.
- * |parentEntry| The parent directory entry. |name| The name of the file.
- * |callback| Called back when the check is finished.
- * @param {!DirectoryEntry} parentEntry
+ * |parentEntry| The entry of the parent directory entry. |name| The name of the
+ * file. |callback| Called back when the check is finished.
+ * @param {Object} parentEntry
  * @param {string} name
- * @param {function((boolean|undefined))} callback |result| true if the length
- *     is in the valid range, false otherwise.
+ * @param {function(boolean):void} callback |result| true if the length is in
+ *     the valid range, false otherwise.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-validatePathNameLength
  */
-chrome.fileManagerPrivate.validatePathNameLength = function(
-    parentEntry, name, callback) {};
+chrome.fileManagerPrivate.validatePathNameLength = function(parentEntry, name, callback) {};
 
 /**
  * Changes the zoom factor of the Files.app. |operation| Zooming mode.
- * @param {string} operation
+ * @param {!chrome.fileManagerPrivate.ZoomOperationType} operation
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-zoom
  */
 chrome.fileManagerPrivate.zoom = function(operation) {};
 
 /**
  * Requests a Drive API OAuth2 access token. |refresh| Whether the token should
  * be refetched instead of using the cached     one. |callback|
  * @param {boolean} refresh
- * @param {function((string|undefined))} callback |accessToken| OAuth2 access
- *     token, or an empty string if failed to fetch.
+ * @param {function(string):void} callback |accessToken| OAuth2 access token, or
+ *     an empty string if failed to fetch.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-requestAccessToken
  */
 chrome.fileManagerPrivate.requestAccessToken = function(refresh, callback) {};
 
 /**
  * Requests a Webstore API OAuth2 access token. |callback|
- * @param {function((string|undefined))} callback |accessToken| OAuth2 access
- *     token, or an empty string if failed to fetch.
+ * @param {function(string):void} callback |accessToken| OAuth2 access token, or
+ *     an empty string if failed to fetch.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-requestWebStoreAccessToken
  */
 chrome.fileManagerPrivate.requestWebStoreAccessToken = function(callback) {};
 
 /**
- * Requests a share dialog url for the specified file.
- * @param {!Entry} entry
- * @param {function((string|undefined))} callback Callback with the result url.
+ * Requests a share dialog url for the specified file. |entry| The entry to
+ * share. |callback|
+ * @param {Object} entry
+ * @param {function(string):void} callback |url| Result url.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getShareUrl
  */
 chrome.fileManagerPrivate.getShareUrl = function(entry, callback) {};
 
 /**
- * Requests a download url to download the file contents.
- * @param {!Entry} entry
- * @param {function((string|undefined))} callback Callback with the result url.
+ * Requests a download url to download the file contents. |entry| The entry to
+ * download. |callback|
+ * @param {Object} entry
+ * @param {function(string):void} callback |url| Result url.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getDownloadUrl
  */
 chrome.fileManagerPrivate.getDownloadUrl = function(entry, callback) {};
 
 /**
- * Requests to share drive files.
- * @param {!Entry} entry
- * @param {string} shareType
- * @param {function()} callback Callback that does not take arguments.
+ * Requests to share drive files. |entry| Entry to be shared. |shareType| Type
+ * of access that is getting granted.
+ * @param {Object} entry
+ * @param {!chrome.fileManagerPrivate.DriveShareType} shareType
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-requestDriveShare
  */
-chrome.fileManagerPrivate.requestDriveShare = function(entry, shareType,
-    callback) {};
-
-/**
- * Requests to install a webstore item. |item_id| The id of the item to
- * install. |silentInstallation| False to show installation prompt. True not to
- * show. |callback|
- * @param {string} itemId
- * @param {boolean} silentInstallation
- * @param {function()} callback Callback that does not take arguments.
- */
-chrome.fileManagerPrivate.installWebstoreItem = function(itemId,
-    silentInstallation, callback) {};
+chrome.fileManagerPrivate.requestDriveShare = function(entry, shareType, callback) {};
 
 /**
  * Obtains a list of profiles that are logged-in.
- * @param {function((!Array<!ProfileInfo>|undefined), (string|undefined),
- *     (string|undefined))} callback Callback with list of profile information,
- *     |runningProfile| ID of the profile that runs the application instance.
- *     |showingProfile| ID of the profile that shows the application window.
+ * @param {function(!Array<!chrome.fileManagerPrivate.ProfileInfo>, string, string):void}
+ *     callback |profiles| List of profile information. |runningProfile| ID of
+ *     the profile that runs the application instance. |showingProfile| ID of
+ *     the profile that shows the application window.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getProfiles
  */
 chrome.fileManagerPrivate.getProfiles = function(callback) {};
 
 /**
  * Opens inspector window. |type| InspectionType which specifies how to open
  * inspector.
- * @param {string} type
+ * @param {!chrome.fileManagerPrivate.InspectionType} type
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-openInspector
  */
 chrome.fileManagerPrivate.openInspector = function(type) {};
 
 /**
- * Computes an MD5 checksum for the given file.
- * @param {!Entry} entry
- * @param {function((string|undefined))} callback
+ * Computes an MD5 checksum for the given file. |entry| The entry of the file to
+ * checksum. |callback|
+ * @param {Object} entry
+ * @param {function(string):void} callback |checksum| Result checksum.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-computeChecksum
  */
 chrome.fileManagerPrivate.computeChecksum = function(entry, callback) {};
 
 /**
- * Gets the MIME type of a file.
- * @param {!Entry} entry
- * @param {function((string|undefined))} callback Callback that MIME type of the
- *     file is passed.
- */
-chrome.fileManagerPrivate.getMimeType = function(entry, callback) {};
-
-/**
- * Gets a flag indicating whether user metrics reporting is enabled.
- * @param {function((boolean|undefined))} callback
+ * Is UMA enabled?
+ * @param {function(boolean):void} callback |result| Boolean result returned by
+ *     the invoked function.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-isUMAEnabled
  */
 chrome.fileManagerPrivate.isUMAEnabled = function(callback) {};
 
 /**
  * Sets a tag on a file or a directory. Only Drive files are supported.
- * @param {!Entry} entry
- * @param {string} visibility 'private' or 'public'
+ * @param {Object} entry
+ * @param {!chrome.fileManagerPrivate.EntryTagVisibility} visibility
  * @param {string} key
  * @param {string} value
- * @param {function()} callback
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-setEntryTag
  */
-chrome.fileManagerPrivate.setEntryTag = function(entry, visibility, key,
-    value, callback) {};
+chrome.fileManagerPrivate.setEntryTag = function(entry, visibility, key, value, callback) {};
 
 /**
- * Gets a flag indicating whether PiexLoader is enabled.
- * @param {function((boolean|undefined))} callback
+ * Returns if Piex loader is enabled.
+ * @param {function(boolean):void} callback |result| Boolean result returned by
+ *     the invoked function.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-isPiexLoaderEnabled
  */
 chrome.fileManagerPrivate.isPiexLoaderEnabled = function(callback) {};
 
 /**
  * Returns list of available providing extensions.
- * @param {function((!Array<!ProvidingExtension>|undefined))} callback
+ * @param {function(!Array<!chrome.fileManagerPrivate.ProvidingExtension>):void}
+ *     callback |extensions| List of providing extensions.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getProvidingExtensions
  */
 chrome.fileManagerPrivate.getProvidingExtensions = function(callback) {};
 
 /**
  * Requests adding a new provided file system. If not possible, then an error
  * via chrome.runtime.lastError is returned.
- * @param {string} extensionId
- * @param {function()} callback
+ * @param {string} extension_id
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-addProvidedFileSystem
  */
-chrome.fileManagerPrivate.addProvidedFileSystem =
-    function(extensionId, callback) {};
+chrome.fileManagerPrivate.addProvidedFileSystem = function(extension_id, callback) {};
 
 /**
- * Requests configuring an existing file system. If not possible, then returns
- * an error via chrome.runtime.lastError.
+ * Requests configuring an existing volume. If not possible, then returns an
+ * error via chrome.runtime.lastError.
  * @param {string} volumeId
- * @param {function()} callback
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-configureVolume
  */
 chrome.fileManagerPrivate.configureVolume = function(volumeId, callback) {};
 
 /**
- * Requests fetching list of actions for the specified set of entries. If not
- * possible, then returns an error via chrome.runtime.lastError.
- * @param {!Array<!Entry>} entries
- * @param {function((!Array<!EntryAction>|undefined))} callback
+ * Requests list of custom actions for the specified entries. If not possible,
+ * then an error via chrome.runtime.lastError is returned.
+ * @param {!Array<Object>} entries
+ * @param {function(!Array<!chrome.fileManagerPrivate.fileSystemProvider.Action>):void}
+ *     callback |actions| List of actions.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-getCustomActions
  */
 chrome.fileManagerPrivate.getCustomActions = function(entries, callback) {};
 
 /**
- * Executes the action on the specified set of entries. If not possible, then
- * returns an error via chrome.runtime.lastError.
- * @param {!Array<!Entry>} entries
+ * Executes a custom action for a set of entries. If not possible, then an error
+ * via chrome.runtime.lastError is returned.
+ * @param {!Array<Object>} entries
  * @param {string} actionId
- * @param {function()} callback
+ * @param {function():void} callback Callback that does not take arguments.
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#method-executeCustomAction
  */
-chrome.fileManagerPrivate.executeCustomAction = function(
-    entries, actionId, callback) {};
+chrome.fileManagerPrivate.executeCustomAction = function(entries, actionId, callback) {};
 
-/** @type {!ChromeEvent} */
+/**
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#event-onMountCompleted
+ */
 chrome.fileManagerPrivate.onMountCompleted;
 
-/** @type {!ChromeEvent} */
+/**
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#event-onFileTransfersUpdated
+ */
 chrome.fileManagerPrivate.onFileTransfersUpdated;
 
-/** @type {!ChromeEvent} */
+/**
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#event-onCopyProgress
+ */
 chrome.fileManagerPrivate.onCopyProgress;
 
-/** @type {!ChromeEvent} */
+/**
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#event-onDirectoryChanged
+ */
 chrome.fileManagerPrivate.onDirectoryChanged;
 
-/** @type {!ChromeEvent} */
+/**
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#event-onPreferencesChanged
+ */
 chrome.fileManagerPrivate.onPreferencesChanged;
 
-/** @type {!ChromeEvent} */
+/**
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#event-onDriveConnectionStatusChanged
+ */
 chrome.fileManagerPrivate.onDriveConnectionStatusChanged;
 
-/** @type {!ChromeEvent} */
+/**
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#event-onDeviceChanged
+ */
 chrome.fileManagerPrivate.onDeviceChanged;
 
-/** @type {!ChromeEvent} */
+/**
+ * @type {!ChromeEvent}
+ * @see https://developer.chrome.com/extensions/fileManagerPrivate#event-onDriveSyncError
+ */
 chrome.fileManagerPrivate.onDriveSyncError;