Modernize doc comments for SourceMgr.

No functionality change.
Add an overload for SourceMgr::PrintMessage that takes an existing diagnostic.