 
   # Given a file path, this sets its {TextBuffer}.
   #
-  # absoluteFilePath - A {String} representing a path
-  # text - The {String} text to use as a buffer
+  # absoluteFilePath - A {String} representing a path.
+  # text - The {String} text to use as a buffer.
   #
   # Returns a promise that resolves to the {TextBuffer}.
   buildBuffer: (absoluteFilePath) ->

  # Public: Given a path to a file, this constructs and associates a new
  # {Editor}, showing the file.
  #
  # * filePath:
  #   The {String} path of the file to associate with
  # * options:
  #   Options that you can pass to the {Editor} constructor
  #
  # Returns a promise that resolves to an {Editor}.
  open: (filePath, options={}) ->

  #
  # An {Editor} will be used if no openers return a value.
  #
  # ## Example
  # ```coffeescript
  #   atom.project.registerOpener (filePath) ->
  #     if path.extname(filePath) is '.toml'
  #       return new TomlEditor(filePath)
  # ```
  #
  # opener - A {Function} to be called when a path is being opened.
  registerOpener: (opener) -> @openers.push(opener)

  # Public: Remove a previously registered opener.
