Tried to clean up comments a bit, following Drupal comment standards
more phpdoc comment cleanup
Merge pull request #2548 from rcsheets/doc_improvements

Misc documentation improvements in CRM/Utils/System.php