Why did we squash this down to one line? Doesn't that break the 80 character rule? 

I believe according to the coding standards:
http://drupal.org/coding-standards/docs#file

We could use the first sentence as the summary, and then have the rest of the text as the additional documentation.