patch: improving comments in the Clang static analyzer

Hi Ted,

I've updated my patch at http://codereview.appspot.com/2920041 -- now
it only does one thing (improving comments in the Clang static
analyzer). I believe I've addressed all your comments. Would you
please take another look? Thanks,

Looks great!