[clang] [NFC][Clang][Docs] Update Pointer Authentication documentation (PR #152596)

[Kristof Beyls via cfe-commits]

https://github.com/kbeyls commented:

Thank you for providing such well-written, detailed, and necessary documentation!

I left a few minor comments inline.

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