[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