python: have docs reflect current return value behavior