Misc documentation improvements in CRM/Utils/System.php

I've tried to make some modest improvements to CRM/Utils/System.php, attempting to move toward better compliance with the Drupal comment standards.