[Python-checkins] cpython (2.7): Issue #25199: Idle: add synchronization comments for future maintainers.

[terry.reedy]

https://hg.python.org/cpython/rev/884f15dc26f0
changeset:   98100:884f15dc26f0
branch:      2.7
user:        Terry Jan Reedy <tjreedy at udel.edu>
date:        Sun Sep 20 22:55:17 2015 -0400
summary:
  Issue #25199: Idle: add synchronization comments for future maintainers.

files:
  Lib/idlelib/EditorWindow.py  |  10 ++++++++--
  Lib/idlelib/macosxSupport.py |   6 ++++++
  2 files changed, 14 insertions(+), 2 deletions(-)


diff --git a/Lib/idlelib/EditorWindow.py b/Lib/idlelib/EditorWindow.py
--- a/Lib/idlelib/EditorWindow.py
+++ b/Lib/idlelib/EditorWindow.py
@@ -564,16 +564,22 @@
             return 'normal'
 
     def about_dialog(self, event=None):
+        "Handle Help 'About IDLE' event."
+        # Synchronize with macosxSupport.overrideRootMenu.about_dialog.
         aboutDialog.AboutDialog(self.top,'About IDLE')
 
     def config_dialog(self, event=None):
+        "Handle Options 'Configure IDLE' event."
+        # Synchronize with macosxSupport.overrideRootMenu.config_dialog.
         configDialog.ConfigDialog(self.top,'Settings')
+
     def config_extensions_dialog(self, event=None):
+        "Handle Options 'Configure Extensions' event."
         configDialog.ConfigExtensionsDialog(self.top)
 
     def help_dialog(self, event=None):
-        "Handle help doc event."
-        # edit maxosxSupport.overrideRootMenu.help_dialog to match
+        "Handle Help 'IDLE Help' event."
+        # Synchronize with macosxSupport.overrideRootMenu.help_dialog.
         if self.root:
             parent = self.root
         else:
diff --git a/Lib/idlelib/macosxSupport.py b/Lib/idlelib/macosxSupport.py
--- a/Lib/idlelib/macosxSupport.py
+++ b/Lib/idlelib/macosxSupport.py
@@ -161,15 +161,21 @@
     WindowList.register_callback(postwindowsmenu)
 
     def about_dialog(event=None):
+        "Handle Help 'About IDLE' event."
+        # Synchronize with EditorWindow.EditorWindow.about_dialog.
         from idlelib import aboutDialog
         aboutDialog.AboutDialog(root, 'About IDLE')
 
     def config_dialog(event=None):
+        "Handle Options 'Configure IDLE' event."
+        # Synchronize with EditorWindow.EditorWindow.config_dialog.
         from idlelib import configDialog
         root.instance_dict = flist.inversedict
         configDialog.ConfigDialog(root, 'Settings')
 
     def help_dialog(event=None):
+        "Handle Help 'IDLE Help' event."
+        # Synchronize with EditorWindow.EditorWindow.help_dialog.
         from idlelib import help
         help.show_idlehelp(root)
 

-- 
Repository URL: https://hg.python.org/cpython