We're having a Drupal API documentation cleanup sprint, to bring the function and file documentation headers up our Drupal 7 documentation standards. If you want to participate, see issue http://drupal.org/node/1310084 for instructions -- new contributors welcome!