[issue12299] Stop documenting functions added by site as builtins

Terry J. Reedy report at bugs.python.org
Sat Jun 11 04:37:33 CEST 2011


Terry J. Reedy <tjreedy at udel.edu> added the comment:

In the 3.2.0 doc, quit and exit (which are unnecessary and nearly useless) are already in the site-variables section (where I think they should be), not in builtin funcs. Did someone move them since? If so, you should discuss rather than just revert. 

The extremely useful help() is documented with builtin funcs, where beginners can it easily. It is used (frequently) in interactive mode. It is documented as being added by site. It could *also* be listed with quit and exit in the site additions section. Anyone sophisticated (foolish) enough to start interactive mode with -S (a bit hard on Windows) should know the consequences. I am opposed to removing the current entry.

----------
nosy: +terry.reedy

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue12299>
_______________________________________


More information about the Python-bugs-list mailing list