DOC: Add integer deprecations to release notes

(also minor spelling fix in comments)
MAINT: Use warnings context manager instead of doing it by hand
STY: Style fixes for integer deprecation changes

Also minor changes in the documentation.
MAINT: Minor style fix and integer conversion optimizations
MAINT: Disallow np.bool_ being used as integer