summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorTerry Jan Reedy <tjreedy@udel.edu>2018-11-11 04:26:31 (GMT)
committerGitHub <noreply@github.com>2018-11-11 04:26:31 (GMT)
commit50ff02b43145f33f8e28ffbfcc6a9d15c4749a64 (patch)
tree72c338dfd048b4ba4eefc58bb704f305607a7924 /Doc
parentb9498e2367f21205ed2b9c172665ea6f0a218d27 (diff)
downloadcpython-50ff02b43145f33f8e28ffbfcc6a9d15c4749a64.zip
cpython-50ff02b43145f33f8e28ffbfcc6a9d15c4749a64.tar.gz
cpython-50ff02b43145f33f8e28ffbfcc6a9d15c4749a64.tar.bz2
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.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/idle.rst23
1 files changed, 17 insertions, 6 deletions
diff --git a/Doc/library/idle.rst b/Doc/library/idle.rst
index f353fbc..d019bf4 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
^^^^^^^^^^