[Python-checkins] cpython (3.4): Issue #16893: For Idle doc, move index entries, copy no-subprocess section

Thu Dec 4 06:56:11 CET 2014

https://hg.python.org/cpython/rev/6db65ff985b6
changeset: 93715:6db65ff985b6
branch: 3.4
parent: 93713:9f03572690d2
user: Terry Jan Reedy <tjreedy at udel.edu>
date: Thu Dec 04 00:54:59 2014 -0500
summary:
 Issue #16893: For Idle doc, move index entries, copy no-subprocess section
from idlelib/help.txt, add 'C' comment, and remove obsolete ^Z comment
Original patch by Zach Ware.
files:
 Doc/library/idle.rst | 58 ++++++++++++++++++++-----------
 1 files changed, 38 insertions(+), 20 deletions(-)

diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
--- a/Doc/library/idle.rst
+++ b/Doc/library/idle.rst
@@ -1,15 +1,15 @@
 .. _idle:
 
+.. index::
+ single: IDLE
+ single: Python Editor
+ single: Integrated Development Environment
+
 IDLE
 ====
 
 .. moduleauthor:: Guido van Rossum <guido at Python.org>
 
-.. index::
- single: IDLE
- single: Python Editor
- single: Integrated Development Environment
-
 IDLE is the Python IDE built with the :mod:`tkinter` GUI toolkit.
 
 IDLE has the following features:
@@ -51,16 +51,16 @@
 Recent Files
 Open a list of recent files
 
+.. index::
+ single: Class browser
+ single: Path browser
+
 Class browser
 Show classes and methods in current file
 
 Path browser
 Show sys.path directories, modules, classes and methods
 
-.. index::
- single: Class browser
- single: Path browser
-
 Save
 Save current window to the associated file (unsaved windows have a
 \* before and after the window title)
@@ -137,7 +137,7 @@
 
 
 Format menu (Editor window only)
-^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 Indent region
 Shift selected lines right by the indent width (default 4 spaces)
@@ -263,6 +263,14 @@
 Additional help sources may be added here with the Configure IDLE dialog under
 the General tab.
 
+.. index::
+ single: Cut
+ single: Copy
+ single: Paste
+ single: Set Breakpoint
+ single: Clear Breakpoint
+ single: breakpoints
+
 Editor Window context menu
 ^^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -283,15 +291,6 @@
 Clear Breakpoint
 Clears the breakpoint on that line.
 
-.. index::
- single: Cut
- single: Copy
- single: Paste
- single: Set Breakpoint
- single: Clear Breakpoint
- single: breakpoints
-
-
 Shell Window context menu
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
@@ -313,6 +312,9 @@
 Editing and navigation
 ----------------------
 
+In this section, 'C' refers to the Control key on Windows and Unix and
+the Command key on Mac OSX.
+
 * :kbd:`Backspace` deletes to the left; :kbd:`Del` deletes to the right
 
 * :kbd:`C-Backspace` delete word left; :kbd:`C-Del` delete word to the right
@@ -414,7 +416,6 @@
 * :kbd:`C-c` interrupts executing command
 
 * :kbd:`C-d` sends end-of-file; closes window if typed at a ``>>>`` prompt
- (this is :kbd:`C-z` on Windows).
 
 * :kbd:`Alt-/` (Expand word) is also useful to reduce typing
 
@@ -507,6 +508,22 @@
 name is '-', no script is executed but an interactive Python session is started;
 the arguments are still available in ``sys.argv``.
 
+Running without a subprocess
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+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
+the subprocess or the RPC socket interface on your platform. However,
+in this mode user code is not isolated from IDLE itself. Also, the
+environment is not restarted when Run/Run Module (F5) is selected. If
+your code has been modified, you must reload() the affected modules and
+re-import any specific items (e.g. from foo import baz) if the changes
+are to take effect. For these reasons, it is preferable to run IDLE
+with the default subprocess if at all possible.
+
+.. deprecated:: 3.4
+
 
 Additional help sources
 -----------------------
@@ -527,6 +544,7 @@
 addition a user can create a custom key set in the Configure IDLE dialog
 under the keys tab.
 
+
 Extensions
 ----------
 
-- 
Repository URL: https://hg.python.org/cpython
