incorrect docs for link_validate_url()

The docs for this function say:

 * @return mixed Returns boolean FALSE if the URL is not valid. On success, returns an object with
 * the following attributes: protocol, hostname, ip, and port.
 */
function link_validate_url($text) {

however further down it can be seen the function returns a constant or FALSE:

  if (strpos($text, '<front>') === 0) {
    return LINK_FRONT;
  }
// etc