   #    ##    ## ##     ## ##       ##     ## ##    ##  ##    ##
   #     ######   #######  ########  #######  ##     ##  ######
 
+  # Returns the default text color for an editor content.
+  #
+  # The color value is directly read from the `EditorView` computed
+  # styles.
+  #
+  # Returns a {String}.
   getDefaultColor: ->
     @transparentize(@minimapView.editorView.css('color'), @getTextOpacity())
 
+  # Returns the text color for the passed-in `token` object.
+  #
+  # The color value is read from the DOM by creating a node structure
+  # that match the token `scope` property.
+  #
+  # token - A token {Object}.
+  #
+  # Returns a {String}.
   getTokenColor: (token) ->
     #Retrieve color from cache if available
     flatScopes = token.scopes.join()

      @tokenColorCache[flatScopes] = color
    @tokenColorCache[flatScopes]

  getDecorationColor: (decoration) ->
    properties = decoration.getProperties()
    return properties.color if properties.color?


    value

  # Internal: Creates a DOM node container for all the operations that
  # need to read styles properties from DOM.
  ensureDummyNodeExistence: ->
    unless @dummyNode?
      @dummyNode = document.createElement('span')
      @dummyNode.style.visibility = 'hidden'
      @editorView.append(@dummyNode)

  # Internal: Converts a `rgb(...)` color into a `rgba(...)` color
  # with the specified opacity.
  #
  # color - The {String} of the color to modify.
  # opacity - The opacity {Number} to apply to the color.
  #
  # Returns a {String}.
  transparentize: (color, opacity=1) ->
    color.replace('rgb(', 'rgba(').replace(')', ", #{opacity})")

  #    ########  ########     ###    ##      ##
  #    ##     ## ##     ##   ## ##   ##  ##  ##
