Expand documentation section on comment parsing

Patch by Jonathan Sauer, with a little editing by me.


git-svn-id: http://llvm.org/svn/llvm-project/cfe/trunk@203128 91177308-0d34-0410-b5e6-96231b3b80d8