Fixed up the comments in the headerdoc to match the current implementation

of how ConstString objects work, and removed the duplicate and out of date
comments that were in the cpp file.

llvm-svn: 139487