fix docs about open's return value #5539

(how annoying to have the same docs in two places)

(three if you count the docstring...)