diff --git includes/theme.inc includes/theme.inc
index c8857f6..a21caff 100644
--- includes/theme.inc
+++ includes/theme.inc
@@ -1126,9 +1126,17 @@ function theme_status_messages($display = NULL) {
  * Return a themed set of links.
  *
  * @param $links
- *   A keyed array of links to be themed.
+ *   A keyed 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) set this to TRUE if 'title' is HTML so it
+ *     will be escaped.
+ *   Array items are passed on to the l() function's $options parameter when creating the link.
  * @param $attributes
- *   A keyed array of attributes
+ *   A keyed array of attributes.
+ * 
  * @return
  *   A string containing an unordered list of links.
  */