From: Terry Jan Reedy Date: Sun, 11 Nov 2018 04:26:31 +0000 (-0500) Subject: bpo-34864: Document two IDLE on MacOS issues. (GH-10456) X-Git-Tag: v3.8.0a1~526 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=50ff02b43145f33f8e28ffbfcc6a9d15c4749a64;p=python bpo-34864: Document two IDLE on MacOS issues. (GH-10456) The System Preferences Dock "prefer tabs always" setting disables some IDLE features. Menus are a bit different than as described for Windows and Linux. --- diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst index f353fbc861..d019bf42cd 100644 --- a/Doc/library/idle.rst +++ b/Doc/library/idle.rst @@ -40,13 +40,17 @@ Menus ----- IDLE has two main window types, the Shell window and the Editor window. It is -possible to have multiple editor windows simultaneously. Output windows, such -as used for Edit / Find in Files, are a subtype of edit window. They currently -have the same top menu as Editor windows but a different default title and -context menu. +possible to have multiple editor windows simultaneously. On Windows and +Linux, each has its own top menu. Each menu documented below indicates +which window type it is associated with. -IDLE's menus dynamically change based on which window is currently selected. -Each menu documented below indicates which window type it is associated with. +Output windows, such as used for Edit => Find in Files, are a subtype of editor +window. They currently have the same top menu but a different +default title and context menu. + +On MacOS, there is one application menu. It dynamically changes according +to the window currently selected. It has an IDLE menu, and some entries +described below are moved around to conform to Apple guidlines. File menu (Shell and Editor) ^^^^^^^^^^^^^^^^^^^^^^^^^^^^ @@ -792,6 +796,13 @@ changed via Configure IDLE on the Option menu. Keys can be user defined; IDLE ships with four built-in key sets. In addition, a user can create a custom key set in the Configure IDLE dialog under the keys tab. +IDLE on MacOS +^^^^^^^^^^^^^ + +Under System Preferences: Dock, one can set "Prefer tabs when opening +documents" to "Always". This setting is not compatible with the tk/tkinter +GUI framework used by IDLE, and it breaks a few IDLE features. + Extensions ^^^^^^^^^^ diff --git a/Lib/idlelib/help.html b/Lib/idlelib/help.html index f0b42151f3..a8afc75c31 100644 --- a/Lib/idlelib/help.html +++ b/Lib/idlelib/help.html @@ -122,12 +122,15 @@ of global and local namespaces