pydoc is installed as a script by Python. It should be documented under http://docs.python.org/dev/using/index.html.

Same goes for idle and 2to3. These may just be cross-references to the relevant module documentation rather than completely new text.

I second the motion for IDLE. There is no module doc for it.

Off the top of my head, there should be a general section that

• says what it is, and that it depends on tcl/tk and tkinter install;
• mentions the existent of the menu Help / IDLE help document;
• gives common startup methods from command line (I forget this) or inside interpreter ('from idlelib import idle') and that one may need to use one of these to see tracebacks if Idle crashes - even if one normally uses a system-specific method to directly run as gui app.
• gives other common info and trouble-shooting tips (some of this is on tracker - such as deleting user .cfg that prevents startup).
• points to system specific discussions, where ever they are put.

Then for each system,

• tcl/tk situation
• how to directly start up
• location of config files

Windows: (what I use)
tcl/tk comes with system.
...

*nix:
tcl/tk probably already on system
...

mac: (ned daily)
special tcl/tk issues, special page on site
...

http://docs.python.org/py3k/library/idle.html (duplicates much of the IDLE help file)

Hmm, how did I miss that?? Well better to reference that, and maybe revise it. I believe there may also be another .txt document in idlelib.

Anyway, perhaps there should first be a section on tkinter by itself, and how to get the tcl/tk it depends on. Mention that optional part of Windows install, so tkinter will likely not work if unselected from installer.

I'm assuming that this still applies to 3.4 and 2.7.

I am not sure where installed scripts are documented in Using Python. 'idle' and 'idle3' are not installed on Windows.

idle.html, derived from idle.rst, is now the IDLE help file.

pip also has pip3 command; perhaps ensurepip should be mentioned.