[New-bugs-announce] [issue12299] Stop documenting functions added by site as builtins

Éric Araujo report at bugs.python.org
Thu Jun 9 18:17:50 CEST 2011


New submission from Éric Araujo <merwok at netwok.org>:

I find it harmful that exit, quit and help are documented in library/functions instead of library/constants (under the section “constants added by the site module”).  It leads people to use unqualified help or exit instead of pydoc.help or sys.exit, and that would break under -S.  I’d like to move the doc for these functions (and add a link from l/functions to l/constants).

----------
assignee: eric.araujo
components: Documentation
messages: 138001
nosy: eric.araujo
priority: normal
severity: normal
status: open
title: Stop documenting functions added by site as builtins
versions: Python 2.7, Python 3.2, Python 3.3

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


More information about the New-bugs-announce mailing list