Keep PyLong_AsLongAndOverflow documentation and implementation in sync

between py3k and trunk;  merge new tests from trunk to py3k.
(See issue #7528.)