   # Returns a {Point}.
   screenPositionForBufferPosition: (bufferPosition, options) -> @displayBuffer.screenPositionForBufferPosition(bufferPosition, options)
 
-  # Public: Convert a position in screen-coordinates to buffer-coordinates.
+  # Essential: Convert a position in screen-coordinates to buffer-coordinates.
   #
   # The position is clipped via {::clipScreenPosition} prior to the conversion.
   #

  # Returns a {Range}.
  clipBufferRange: (range) -> @buffer.clipRange(range)

  # Public: Clip the given {Point} to a valid position on screen.
  #
  # If the given {Point} describes a position that is actually reachable by the
  # cursor based on the current contents of the screen, it is returned

  #
  # Returns a {Point}.
  clipScreenPosition: (screenPosition, options) -> @displayBuffer.clipScreenPosition(screenPosition, options)

  ###
  Section: Grammars
