diff --git a/includes/pager.inc b/includes/pager.inc
index 8d51439..ebeb2c0 100644
--- a/includes/pager.inc
+++ b/includes/pager.inc
@@ -359,6 +359,12 @@ function theme_pager_last($text, $limit, $element = 0, $parameters = array()) {
 /**
  * Format a link to a specific query result page.
  *
+ * @param $text
+ *   The link text. Also used to figure out the title attribute of the link,
+ *   if it is not provided in $variables['attributes']['title']; in this case,
+ *   $variables['text'] must be one of the standard pager link text strings
+ *   that would be generated by the pager theme functions, such as a number or
+ *   t('« first').
  * @param $page_new
  *   The first result to display on the linked page.
  * @param $element
@@ -366,7 +372,7 @@ function theme_pager_last($text, $limit, $element = 0, $parameters = array()) {
  * @param $parameters
  *   An associative array of query string parameters to append to the pager link.
  * @param $attributes
- *   An associative array of HTML attributes to apply to a pager anchor tag.
+ *   An associative array of HTML attributes to apply to the pager link.
  * @return
  *   An HTML string that generates the link.
  *