     else
       @editor.getScrollLeft()
 
+  # Public: Scrolls the editor to the bottom.
   scrollToBottom: ->
     @editor.setScrollBottom(Infinity)
 
+  # Public: Scrolls the editor to the given screen position.
+  #
+  # screenPosition - An object that represents a buffer position. It can be either
+  #                  an {Object} (`{row, column}`), {Array} (`[row, column]`), or {Point}
+  # options - A hash matching the options available to {::scrollToScreenPosition}
   scrollToScreenPosition: (screenPosition, options) ->
     @editor.scrollToScreenPosition(screenPosition, options)
 
+  # Public: Scrolls the editor to the given buffer position.
+  #
+  # bufferPosition - An object that represents a buffer position. It can be either
+  #                  an {Object} (`{row, column}`), {Array} (`[row, column]`), or {Point}
+  # options - A hash matching the options available to {::scrollToBufferPosition}
   scrollToBufferPosition: (bufferPosition, options) ->
     @editor.scrollToBufferPosition(bufferPosition, options)
 

    screenPosition = screenPositionForPixelPosition(pixelPosition)
    @editor.scrollToScreenPosition(screenPosition)

  pixelPositionForBufferPosition: (bufferPosition) ->
    @editor.pixelPositionForBufferPosition(bufferPosition)

  pixelPositionForScreenPosition: (screenPosition) ->
    @editor.pixelPositionForScreenPosition(screenPosition)


      else
        @focusOnAttach = true

  getEditor: ->
    deprecate("Use EditorView::getModel instead")
    @editor

  # Public: Get the underlying editor model for this view.
  #
  # Returns an {Editor}.
  getModel: -> @editor

  Object.defineProperty @::, 'lineHeight', get: -> @editor.getLineHeightInPixels()
