   Displays a tooltip with text content when hovering the mouse over this element:
 
       <a href="/decks" up-tooltip="Show all decks">Decks</a>
-  
-  You can also make an existing `title` attribute appear as a tooltip:
-  
-      <a href="/decks" title="Show all decks" up-tooltip>Decks</a>
+
+  To make the tooltip appear below the element instead of above the element,
+  add an `up-position` attribute:
+
+      <a href="/decks" up-tooltip="Show all decks" up-position="bottom">Decks</a>
 
   @method [up-tooltip]
+  @param {String} [up-animation]
+    The animation used to open the tooltip.
+    Defaults to [`up.tooltip.config.openAnimation`](/up.tooltip.config).
+  @param {String} [up-position]
+    The default position of tooltips relative to the element.
+    Can be either `"top"` or `"bottom"`.
+    Defaults to [`up.tooltip.config.position`](/up.tooltip.config).
   @ujs
   ###
+
   ###*
   Displays a tooltip with HTML content when hovering the mouse over this element:
 

up.tooltip = (($) ->
  
  u = up.util

  setPosition = ($link, $tooltip, position) ->
    linkBox = u.measure($link)

  attach = (linkOrSelector, options = {}) ->
    $link = $(linkOrSelector)
    html = u.option(options.html, $link.attr('up-tooltip-html'))
    text = u.option(options.text, $link.attr('up-tooltip'))
    position = u.option(options.position, $link.attr('up-position'), config.position)
    animation = u.option(options.animation, u.castedAttr($link, 'up-animation'), config.openAnimation)
    animateOptions = up.motion.animateOptions(options, $link)
    close()
    $tooltip = createElement(text: text, html: html)
