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

Beginne damit, die Implementierungen von int() und die Release- oder Deprecation-Dokumentation des Projekts zu lokalisieren; das Issue nennt keine Dateien oder Tests. Bestätige, welche Typen abgedeckt sind, und kläre, ob dieses Release die Deprecation dokumentieren oder DeprecationWarning erst nach dem nächsten Minor-Release ausgeben soll. Als erledigt gilt die Aufgabe, wenn das phasenweise Verhalten dokumentiert und konsistent implementiert ist.