Add a deprecation warning for `__int__()`

Do we want to give users a grace period, in case they need to support two cuda->bindings versions for a while?

Concretely:

In the next release, deprecate only in the documentation.

Only with the next minor release bump: actually raise DeprecationWarning.

@leofang WDYT about introducing a "Phased deprecations" section somewhere, so we don't forget in the future.

E.g. for this case:

__int__() method for type A, B, C were informally deprecated in cuda-bindings release vX.Y.Z. DeprecationWarning will be raised starting with release vX.Y+1.0.

Originally posted by @rwgk in https://github.com/NVIDIA/cuda-python/issues/773#issuecomment-3109349954

まず、int() の実装とプロジェクトのリリースまたは非推奨化に関するドキュメントを探します。この issue にはファイル名やテストの指定がありません。どの型が対象になるかを確認し、このリリースで非推奨化をドキュメント化するのか、それとも次の minor release の後にだけ DeprecationWarning を発生させるのかについて合意します。段階的な動作がドキュメント化され、一貫して実装されていれば完了です。