diff --git includes/theme.inc includes/theme.inc
index c8857f6..2b720b8 100644
--- includes/theme.inc
+++ includes/theme.inc
@@ -1126,7 +1126,18 @@ function theme_status_messages($display = NULL) {
  * Return a themed set of links.
  *
  * @param $links
- *   A keyed array of links to be themed.
+ *   An associative array of links to be themed. The key for each link is used
+ *   as its css class. Each link should be itself an array, with the following
+ *   keys:
+ *   - title: the link text
+ *   - href: the link URL. If omitted, the 'title' is shown as a plain text
+ *     item in the links list.
+ *   - html: (optional) whether or not 'title' is HTML. If set, the title
+ *     will not be escaped.
+ *   - attributes: (optional) attributes for the <span> tag used in place
+ *     of an anchor if no 'href' is passed. Ignored if an href is passed.
+ *   Array items are passed on to the l() function's $options parameter when
+ *   creating the link.
  * @param $attributes
  *   A keyed array of attributes
  * @return