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

[Aaron Ballman via cfe-commits]

https://github.com/AaronBallman approved this pull request.

LGTM aside from a nit, thank you for improving the documentation here!

https://github.com/llvm/llvm-project/pull/78095