All the docs for this API were lost -- please copy them from the diff above.  (And update the type annotation -- I think `@param {!FileEntry|Array.<FileEntry>} file` ?)