 
   # Public: Creates a new selection at the given marker.
   #
-  # * marker:
-  #   The {DisplayBufferMarker} to highlight
-  # * options:
-  #   + A hash of options that pertain to the {Selection} constructor.
+  # marker  - The {DisplayBufferMarker} to highlight
+  # options - An {Object} that pertains to the {Selection} constructor.
   #
   # Returns the new {Selection}.
   addSelection: (marker, options={}) ->

  # or if its column goes beyond a line's length, this "sanitizes" the value
  # to a real position.
  #
  # * bufferPosition:
  #   The {Point} to clip
  #
  # Returns the new, clipped {Point}. Note that this could be the same as
  #   `bufferPosition` if no clipping was performed.


  # Public: Returns the indentation level of the given a buffer row
  #
  # bufferRow - A {Number} indicating the buffer row.
  indentationForBufferRow: (bufferRow) ->
    @indentLevelForLine(@lineForBufferRow(bufferRow))

  # Public: Sets the indentation level for the given buffer row.
  #
  # bufferRow - A {Number} indicating the buffer row.
  # newLevel - A {Number} indicating the new indentation level.
  setIndentationForBufferRow: (bufferRow, newLevel) ->
    currentIndentLength = @lineForBufferRow(bufferRow).match(/^\s*/)[0].length
    newIndentString = @buildIndentString(newLevel)
