[clang] Document the warn_unused attribute (PR #201881)

[Aaron Ballman via cfe-commits]

AaronBallman wrote:

Note, this "fixes" #160244 which is behaving by design but notes the lack of documentation for the attribute.

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