Simplify the tracking of when to issue a fixit hint, making the helper

function more clear and obvious in behavior.

Add some comments documenting the behavior of the primary diagnostic helper.

llvm-svn: 128901