Add idlelib module entry to doc

[terryjreedy]

BPO	31329
Nosy	@rhettinger, @terryjreedy

^{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/terryjreedy'
closed_at = None
created_at = <Date 2017-09-01.19:24:07.937>
labels = ['3.8', 'expert-IDLE', 'type-feature', '3.7']
title = 'Add idlelib module entry to doc'
updated_at = <Date 2020-10-08.00:07:34.577>
user = 'https://github.com/terryjreedy'

bugs.python.org fields:

activity = <Date 2020-10-08.00:07:34.577>
actor = 'terry.reedy'
assignee = 'terry.reedy'
closed = False
closed_date = None
closer = None
components = ['IDLE']
creation = <Date 2017-09-01.19:24:07.937>
creator = 'terry.reedy'
dependencies = []
files = []
hgrepos = []
issue_num = 31329
keywords = []
message_count = 5.0
messages = ['301145', '301153', '301171', '338497', '378203']
nosy_count = 2.0
nosy_names = ['rhettinger', 'terry.reedy']
pr_nums = []
priority = 'normal'
resolution = None
stage = 'needs patch'
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue31329'
versions = ['Python 3.7', 'Python 3.8']

[terryjreedy]

If this were a new section in idle.rst, it would appear with the IDLE doc displayed by Help IDLE. Being present there has its +s and -s. Would have to see how it works here as well as online.

In any case, it would be good to have something indexed under I in Modules index.

Content: Document python -m idlelib as command line start up. List other entry points. Otherwise describe as 'private implementation modules', as in idlelib.__init__.

[rhettinger]

See also #75500.

A cleaner command-line startup would be: python -m idle

[terryjreedy]

Also document in idle doc that 'import idlelib.idle' is the programmatic API, and that icons and context menus may be available. In any case, add more information on 'How to start IDLE'.

[terryjreedy]

See also #59149 (comment). The issue is otherwise about the Using doc.

[terryjreedy]

I closed #86134 as a duplicate of this.

[terryjreedy]

Leaving open for the IDLE start doc comments.

[terryjreedy]

idlelib/help.html was updated to match by #96523 and backports