       result.push(marker) if marker.matchesParams(params)
     result.sort (a, b) -> a.compare(b)
 
+  # Public: Create a marker with the given range.
+  #
+  # See the documentation for {TextBuffer::markRange}
   markRange: (range, options={}) ->
     @createMarker(@delegate.clipRange(range), Marker.extractParams(options))
 
+  # Public: Create a marker with the given position and no tail.
+  #
+  # See the documentation for {TextBuffer::markPosition}
   markPosition: (position, options={}) ->
     options.tailed ?= false
     position = @delegate.clipPosition(position)
     @markRange(new Range(position, position), options)
+
+  ###
+  Section: Private - TextBuffer interface
+  ###
 
   splice: (start, oldExtent, newExtent) ->
     end = start.traverse(oldExtent)

    @nextMarkerId = 0
    @destroyed = false

  destroy: ->
    @destroyed = true
    @delegate.markerLayerDestroyed(this)

    return

  ###
  Section: Private - Marker interface
  ###

  markerUpdated: ->
