Help missing for exec and print

[bkabrda]

BPO	19680
Nosy	@birkenfeld, @ezio-melotti, @merwok, @sandrotosi
Files	issue19680.diff

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = 'https://github.com/ezio-melotti'
closed_at = <Date 2014-02-14.05:05:02.477>
created_at = <Date 2013-11-21.12:29:45.963>
labels = ['type-bug', 'docs']
title = 'Help missing for exec and print'
updated_at = <Date 2014-02-14.05:05:02.476>
user = 'https://bugs.python.org/bkabrda'

bugs.python.org fields:

activity = <Date 2014-02-14.05:05:02.476>
actor = 'ezio.melotti'
assignee = 'ezio.melotti'
closed = True
closed_date = <Date 2014-02-14.05:05:02.477>
closer = 'ezio.melotti'
components = ['Documentation']
creation = <Date 2013-11-21.12:29:45.963>
creator = 'bkabrda'
dependencies = []
files = ['32826']
hgrepos = []
issue_num = 19680
keywords = ['patch']
message_count = 6.0
messages = ['203625', '203867', '204291', '204306', '211199', '211200']
nosy_count = 7.0
nosy_names = ['georg.brandl', 'ezio.melotti', 'eric.araujo', 'sandro.tosi', 'docs@python', 'python-dev', 'bkabrda']
pr_nums = []
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue19680'
versions = ['Python 2.7']

[bkabrda]

Steps to reproduce:

[bkabrda@zizalka python]$ python
>>> help()
help> keywords
<snip>
# prints lots of keywords including "print" and "exec"
</snip>
help> print
no documentation found for 'print'

So either keywords should not list "print" and "exec" or the documentation for them should be built. IIUC, the help for these should be part of pydoc_data/topics.py, which gets generated by Doc/tools/sphinxext/pyspecific.py. However, in revision [1] some topics got removed ("print" and "exec" amongst them) without the commit message saying anything helpful. Either way, this is inconsistent and should be fixed (assuming that Python 2.7 is still supposed to get this sort of fixes).

Thanks.

[1] http://hg.python.org/cpython/rev/76aa98f69251

[merwok]

The changeset you refer to may be a backport of a Python 3 changeset, where print and exec are not keywords but functions (adding Sandro to nosy so that he may confirm).

Would you like to make a patch to fix this in 2.7? http://docs.python.org/devguide contains more info about that.

[ezio-melotti]

Attached patch seems to fix the issue.

[bkabrda]

Seems that Ezio was faster :)
Yep, the attached patch does seem to solve the issue.

[python-dev]

New changeset cc62d856fc5f by Ezio Melotti in branch '2.7':
bpo-19680: add back documentation for print and exec in the interactive help.
http://hg.python.org/cpython/rev/cc62d856fc5f

[ezio-melotti]

Fixed, thanks for the report!