tidy up inline documentation and clarify $ variable

Capitalized the inline documentation and expanded $! into its more readable synonym. Not sure if this is useful but I'm always forgetting what those Perl-like dollar variables mean. I don't think $0 has a synonym.