when deprecating an API, document the replacement

[psifertex]

We should generally go check and ensure that functions marked as deprecated are not replaced with functions less documented.

Case in point:

https://dev-api.binary.ninja/binaryninja.binaryview-module.html#binaryninja.binaryview.BinaryView.clear_user_global_pointer_value