diff --git a/includes/theme.inc b/includes/theme.inc
index 23aa1f7..cdaa0fb 100644
--- a/includes/theme.inc
+++ b/includes/theme.inc
@@ -1194,9 +1194,21 @@ 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 containing:
+ *   - links: 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 elements:
+ *     - title: The link text.
+ *     - href: The link URL. If omitted, the 'title' is shown as a plain text
+ *     - html: (optional) Whether or not 'title' is HTML. If set, the title
+ *       will not be passed through check_plain().
+ *     - attributes: (optional) Attributes for the anchor, or for the <span> tag
+ *       used in its place if no 'href' is supplied.
+ *     If the 'href' element is supplied, the entire link array is passed to l()
+ *     as its $options parameter.
  * @param $attributes
- *   A keyed array of attributes
+ *   A keyed array of attributes for the UL containing the
+ *   list of links.
  * @return
  *   A string containing an unordered list of links.
  */