     @currentBuffer.on "saved", @onSaved
     @currentBuffer.on "changed", @onChanged
 
-  # ! Public API
-
-  ###
-   * Gets called when the document has been changed. Returns an array with
-   * suggestions. If `exclusive` is set to true and this method returns suggestions,
-   * the suggestions will be the only ones that are displayed.
-   * @return {Array}
-   * @public
-  ###
+  # Public:  Gets called when the document has been changed. Returns an array
+  # with suggestions. If `exclusive` is set to true and this method returns
+  # suggestions, the suggestions will be the only ones that are displayed.
+  #
+  # Returns an {Array} of Suggestion instances
   buildSuggestions: ->
     selection = @editor.getSelection()
     prefix = @prefixOfSelection selection


    p.stop()

  ###
   * Finds possible matches for the given string / prefix
   * @param  {String} prefix
   * @return {Array}
   * @private
  ###
  findSuggestionsForWord: (prefix) ->
    p = new Perf "Finding matches for '#{prefix}'", {@debug}
    p.start()

    p.stop()
    return results

  # Private: Finds autocompletions in the current syntax scope (e.g. css values)
  #
  # Returns an {Array} of strings
  getCompletionsForCursorScope: ->
    cursorScope = @editor.scopesForBufferPosition @editor.getCursorBufferPosition()
    completions = atom.syntax.propertiesForScope cursorScope, "editor.completions"
