--- includes/common.inc	2010-02-22 13:21:34.000000000 -0600
+++ includes/common.inc.edit	2010-02-23 20:20:40.000000000 -0600
@@ -2154,24 +2154,21 @@ function drupal_attributes(array $attrib
  *       used as is.
  * @param $options
  *   An associative array of additional options, with the following keys:
- *     - 'attributes'
- *       An associative array of HTML attributes to apply to the anchor tag.
- *     - 'query'
- *       A query string to append to the link, or an array of query key/value
- *       properties.
- *     - 'fragment'
- *       A fragment identifier (named anchor) to append to the link.
+ *     - attributes: An associative array of HTML attributes to apply to the
+ *       anchor tag.
+ *     - query: A query string to append to the link, or an array of query
+ *       key/value properties.
+ *     - fragment: A fragment identifier (named anchor) to append to the link.
  *       Do not include the '#' character.
- *     - 'absolute' (default FALSE)
- *       Whether to force the output to be an absolute link (beginning with
- *       http:). Useful for links that will be displayed outside the site, such
- *       as in an RSS feed.
- *     - 'html' (default FALSE)
- *       Whether $text is HTML, or just plain-text. For example for making
- *       an image a link, this must be set to TRUE, or else you will see the
- *       escaped HTML.
- *     - 'alias' (default FALSE)
- *       Whether the given path is an alias already.
+ *     - absolute: (default FALSE) Whether to force the output to be an absolute
+ *       link (beginning with http:). Useful for links that will be displayed
+ *       outside the site, such as in an RSS feed.
+ *     - html: (default FALSE) Whether $text is HTML, or just plain-text. For
+ *       example for making an image a link, this must be set to TRUE, or else
+ *       you will see the escaped HTML.
+ *     - alias: (default FALSE) Whether the given path is an alias already.
+ *     - language: An optional language object. Used to build the URL to link
+ *       to and look up the proper alias for the link.
  * @return
  *   an HTML string containing a link to the given path.
  */