From 6e10ec5367f890a0bf4a66157bee93570a99d21b Mon Sep 17 00:00:00 2001 From: Terry Jan Reedy Date: Wed, 23 Sep 2015 20:00:33 -0400 Subject: [PATCH] Issue 25224: Augment Idle doc feature list and no-subprocess section to finish making current README.txt obsolete. --- Doc/library/idle.rst | 25 +++++++++++++++++++++---- Lib/idlelib/help.html | 20 +++++++++++++++++--- 2 files changed, 38 insertions(+), 7 deletions(-) diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index 24914e46975..bbbeaa2e2f7 100644 --- a/Doc/library/idle.rst +++ b/Doc/library/idle.rst @@ -8,7 +8,7 @@ IDLE single: Python Editor single: Integrated Development Environment -.. moduleauthor:: Guido van Rossum +.. moduleauthor:: Guido van Rossum IDLE is the Python IDE built with the :mod:`tkinter` GUI toolkit. @@ -18,13 +18,19 @@ IDLE has the following features: * cross-platform: works on Windows, Unix, and Mac OS X +* Python shell window (interactive interpreter) with colorizing + of code input, output, and error messages + * multi-window text editor with multiple undo, Python colorizing, - smart indent, call tips, and many other features + smart indent, call tips, auto completion, and other features -* Python shell window (a.k.a. interactive interpreter) +* search within any window, replace within editor windows, and search + through multiple files (grep) -* debugger (not complete, but you can set breakpoints, view and step) +* debugger with persistent breakpoints, stepping, and viewing + of global and local namespaces +* configuration, browsers, and other dialogs Menus ----- @@ -530,6 +536,17 @@ If there are arguments: Running without a subprocess ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +By default, Idle executes user code in a separate subprocess via a socket, +which uses the internal loopback interface. This connection is not +externally visible and no data is sent to or received from the Internet. +If firewall software complains anyway, you can ignore it. + +If the attempt to make the socket connection fails, Idle will notify you. +Such failures are sometimes transient, but if persistent, the problem +may be either a firewall blocking the connecton or misconfiguration of +a particular system. Until the problem is fixed, one can run Idle with +the -n command line switch. + If IDLE is started with the -n command line switch it will run in a single process and will not create the subprocess which runs the RPC Python execution server. This can be useful if Python cannot create diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html index bb762755f6b..83d2a23f9d3 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -80,10 +80,15 @@
  • coded in 100% pure Python, using the tkinter GUI toolkit
  • cross-platform: works on Windows, Unix, and Mac OS X
    • +
  • Python shell window (interactive interpreter) with colorizing +of code input, output, and error messages
  • multi-window text editor with multiple undo, Python colorizing, -smart indent, call tips, and many other features
    • -
  • Python shell window (a.k.a. interactive interpreter)
    • -
  • debugger (not complete, but you can set breakpoints, view and step)
    • +smart indent, call tips, auto completion, and other features +
  • search within any window, replace within editor windows, and search +through multiple files (grep)
    • +
  • debugger with persistent breakpoints, stepping, and viewing +of global and local namespaces
    • +
  • configuration, browsers, and other dialogs

25.5.4.2. Running without a subprocess

+

By default, Idle executes user code in a separate subprocess via a socket, +which uses the internal loopback interface. This connection is not +externally visible and no data is sent to or received from the Internet. +If firewall software complains anyway, you can ignore it.

+

If the attempt to make the socket connection fails, Idle will notify you. +Such failures are sometimes transient, but if persistent, the problem +may be either a firewall blocking the connecton or misconfiguration of +a particular system. Until the problem is fixed, one can run Idle with +the -n command line switch.

If IDLE is started with the -n command line switch it will run in a single process and will not create the subprocess which runs the RPC Python execution server. This can be useful if Python cannot create