[clang] Update documentation for `#pragma diagnostic` (#78095)

GCC has changed over the past decade, and we're not implementing
everything they do.
Fixes #51472

---------

Co-authored-by: Aaron Ballman <aaron@aaronballman.com>