diff --git includes/theme.inc includes/theme.inc
index fb70383..af5fe3c 100644
--- includes/theme.inc
+++ includes/theme.inc
@@ -1375,16 +1375,17 @@ function theme_link($variables) {
  *
  * @param $variables
  *   An associative array containing:
- *   - links: A keyed array of links to be themed. The key for each link is used
+ *   - 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
- *     keys:
- *     - title: the link text
- *     - href: the link URL. If omitted, the 'title' is shown as a plain text
+ *     elements:
+ *     - 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.
+ *     - html: (optional) Whether or not 'title' is HTML. If set, the title
+ *       will not be escaped.
+ *     - 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.
  *   - attributes: A keyed array of attributes.
  *   - heading: An optional keyed array or a string for a heading to precede the
  *     links. When using an array the following keys can be used: