 
   # 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={}) ->


  # Public: Performs a replace across all the specified files in the project.
  #
  # regex - A {RegExp} to search with.
  # replacementText - Text to replace all matches of regex with
  # filePaths - List of file path strings to run the replace on.
  # iterator - A {Function} callback on each file with replacements:
  #            `({filePath, replacements}) ->`.
  replace: (regex, replacementText, filePaths, iterator) ->
    deferred = Q.defer()

