A critique of cgi.escape

[Jon Ribbens]

In article <mailman.580.1159199466.10491.python-list at python.org>, Filip Salomonsson wrote:
>> Here's a point for you - the documentation for cgi.escape says that
>> the characters "&", "<" and ">" are converted, but not what they are
>> converted to.
> 
> If the documentation isn't clear enough, that means the documentation
> should be fixed.

Incorrect - documentation can and frequently does leave certain
behaviours undefined. This is deliberate and (among other things)
is to allow for the behaviour to change in future versions without
breaking backwards-compatibility.