   # performance, use {TextBuffer.load} instead.
   #
   # * `filePath` The {String} file path.
-  # * `params` {Object}
-  #   * `encoding` {String} The file's encoding.
-  #   * `shouldDestroyOnFileDelete` A {Function} that returns a {Boolean}
-  #     indicating whether the buffer should be destroyed if its file is
-  #     deleted.
+  # * `params` An {Object} with the following properties:
+  #   * `encoding` (optional) {String} The file's encoding.
+  #   * `shouldDestroyOnFileDelete` (optional) A {Function} that returns a
+  #     {Boolean} indicating whether the buffer should be destroyed if its file
+  #     is deleted.
   #
   # Returns a {TextBuffer} instance.
   @loadSync: (filePath, params) ->

    return if filePath is @getPath()
    @setFile(new File(filePath) if filePath)

  setFile: (file) ->
    return if file.getPath() is @getPath()
    @file = file


  # Public: Create a new buffer backed by the given file path.
  #
  # * `source` Either a {String} path to a local file or (experimentally) a file
  #   {Object} as described by the {::setFile} method.
  # * `params` An {Object} with the following properties:
  #   * `encoding` (optional) {String} The file's encoding.
  #   * `shouldDestroyOnFileDelete` (optional) A {Function} that returns a
  #     {Boolean} indicating whether the buffer should be destroyed if its file
  #     is deleted.
  #
  # Returns a {Promise} that resolves with a {TextBuffer} instance.
  @load: (source, params) ->
