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

This updates the pointer authentication documentation to include a
complete description of the existing functionaliy and behaviour, details
of the more complex aspects of the semantics and security properties,
and the Apple arm64e ABI design.

Co-authored-by: Ahmed Bougacha
Co-authored-by: Akira Hatanaka
Co-authored-by: John Mccall

---------

Co-authored-by: Ahmed Bougacha <[email protected]>
Co-authored-by: Akira Hatanaka <[email protected]>
Co-authored-by: John Mccall <[email protected]>
(cherry picked from commit 62d2a8e)

Author: 4 people