Issue 1015021: Docs claim that coerce can return None (original) (raw)

The coerce builtin can't return None, but its docstring says otherwise. As far back as I bothered to look (rev 2.98 of bltnmodule.c in 1997), the implementation hasn't been able to return None, so it's the docs that should be fixed.

Attached patch fixes the docstring and improves the library reference to document what really happens if coercion fails.