changeset: 98215:97f3d7749d3f branch: 3.4 parent: 98211:e7f5ecfd86fc user: Terry Jan Reedy date: Wed Sep 23 03:52:23 2015 -0400 files: Doc/library/idle.rst Lib/idlelib/help.html description: Issue #25219: Update doc for Idle command line options. Some were missing and notes were not correct. diff -r e7f5ecfd86fc -r 97f3d7749d3f Doc/library/idle.rst --- a/Doc/library/idle.rst Wed Sep 23 03:45:13 2015 -0400 +++ b/Doc/library/idle.rst Wed Sep 23 03:52:23 2015 -0400 @@ -504,27 +504,28 @@ :: - idle.py [-c command] [-d] [-e] [-s] [-t title] [arg] ... + idle.py [-c command] [-d] [-e] [-h] [-i] [-r file] [-s] [-t title] [-] [arg] ... - -c command run this command - -d enable debugger - -e edit mode; arguments are files to be edited - -s run $IDLESTARTUP or $PYTHONSTARTUP first + -c command run command in the shell window + -d enable debugger and open shell window + -e open editor window + -h print help message with legal combinatios and exit + -i open shell window + -r file run file in shell window + -s run $IDLESTARTUP or $PYTHONSTARTUP first, in shell window -t title set title of shell window + - run stdin in shell (- must be last option before args) If there are arguments: -#. If ``-e`` is used, arguments are files opened for editing and - ``sys.argv`` reflects the arguments passed to IDLE itself. - -#. Otherwise, if ``-c`` is used, all arguments are placed in - ``sys.argv[1:...]``, with ``sys.argv[0]`` set to ``'-c'``. +* If ``-``, ``-c``, or ``r`` is used, all arguments are placed in + ``sys.argv[1:...]`` and ``sys.argv[0]`` is set to ``''``, ``'-c'``, + or ``'-r'``. No editor window is opened, even if that is the default + set in the Options dialog. -#. Otherwise, if neither ``-e`` nor ``-c`` is used, the first - argument is a script which is executed with the remaining arguments in - ``sys.argv[1:...]`` and ``sys.argv[0]`` set to the script name. If the - script name is '-', no script is executed but an interactive Python session - is started; the arguments are still available in ``sys.argv``. +* Otherwise, arguments are files opened for editing and + ``sys.argv`` reflects the arguments passed to IDLE itself. + Running without a subprocess ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ diff -r e7f5ecfd86fc -r 97f3d7749d3f Lib/idlelib/help.html --- a/Lib/idlelib/help.html Wed Sep 23 03:45:13 2015 -0400 +++ b/Lib/idlelib/help.html Wed Sep 23 03:52:23 2015 -0400 @@ -478,27 +478,28 @@ functions to be used from IDLE’s Python shell.

25.5.4.1. Command line usage¶

-

idle.py [-c command] [-d] [-e] [-s] [-t title] [arg] ...
+idle.py [-c command] [-d] [-e] [-h] [-i] [-r file] [-s] [-t title] [-] [arg] ...
 
--c command  run this command
--d          enable debugger
--e          edit mode; arguments are files to be edited
--s          run $IDLESTARTUP or $PYTHONSTARTUP first
+-c command  run command in the shell window
+-d          enable debugger and open shell window
+-e          open editor window
+-h          print help message with legal combinatios and exit
+-i          open shell window
+-r file     run file in shell window
+-s          run $IDLESTARTUP or $PYTHONSTARTUP first, in shell window
 -t title    set title of shell window
+-           run stdin in shell (- must be last option before args)
 
 
 If there are arguments:
-
-If -e is used, arguments are files opened for editing and
+
+If -, -c, or r is used, all arguments are placed in
+sys.argv[1:...] and sys.argv[0] is set to '', '-c',
+or '-r'.  No editor window is opened, even if that is the default
+set in the Options dialog.
+Otherwise, arguments are files opened for editing and
 sys.argv reflects the arguments passed to IDLE itself.
-Otherwise, if -c is used, all arguments are placed in
-sys.argv[1:...], with sys.argv[0] set to '-c'.
-Otherwise, if neither -e nor -c is used, the first
-argument is a script which is executed with the remaining arguments in
-sys.argv[1:...]  and sys.argv[0] set to the script name.  If the
-script name is ‘-‘, no script is executed but an interactive Python session
-is started;    the arguments are still available in sys.argv.
-
+

25.5.4.2. Running without a subprocess¶

@@ -661,7 +662,7 @@ The Python Software Foundation is a non-profit corporation. Please donate.
- Last updated on Sep 12, 2015. + Last updated on Sep 23, 2015. Found a bug?
Created using Sphinx 1.2.3.