[clang] Add documentation for `__builtin_object_size`. (PR #96573)

[Aaron Ballman via cfe-commits]

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

Thank you for the additional docs, they LGTM!

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