[Python-checkins] r61636 - peps/trunk/pep-3108.txt

[brett.cannon]

Author: brett.cannon
Date: Wed Mar 19 21:20:37 2008
New Revision: 61636

Modified:
   peps/trunk/pep-3108.txt
Log:
Add all Mac modules for deprecation along with everything from PEP 4.


Modified: peps/trunk/pep-3108.txt
==============================================================================
--- peps/trunk/pep-3108.txt	(original)
+++ peps/trunk/pep-3108.txt	Wed Mar 19 21:20:37 2008
@@ -92,6 +92,32 @@
 have already been removed from being imported but are kept in the
 distribution for Python for users that rely upon the code.
 
+* buildtools
+
+* cfmfile
+
+* cl
+
+* md5
+
+* mimetools
+
+* MimeWriter
+
+* mimify
+
+* multifile
+
+* posixfile
+
+* rfc822
+
+* sha
+
+* sv
+
+* timing
+
 
 Platform-specific with minimal use
 ----------------------------------
@@ -161,54 +187,6 @@
     - Access to the sound card on Sun machines.
     - Code not uniquely edited in over eight years.
 
-* Mac
-
-  + aetools/aepack/aetypes/MiniAEFrame
-
-    - OSA support is better through third-party modules.
-        
-        * Appscript [#appscript]_.
-
-    - Hard-coded endianness which breaks on Intel Macs.
-    - Might need to rename if Carbon package dependent.
-
-  + applesingle
-
-    - Undocumented.
-    - AppleSingle is a binary file format for A/UX.
-    - A/UX no longer distributed.
-
-  + autoGIL
-
-    - Very bad model for using Python with the CFRunLoop.
-    - Rename to _autogil if needed by Carbon package.
-
-  + Carbon.CF
-  
-    - Half-heared attempt.
-
-  + findertools
-
-    - No longer useful.
-
-  + FrameWork
-
-    - Poorly documented.
-    - Not updated to support Carbon Events.
-
-  + icopen
-
-     - Not needed on OS X.
-     - Meant to replace 'open' which is usually a bad thing to do.
-
-  + videoreader
-
-     - No longer used.
-
-  + W
-
-     - No longer distributed with Python.
-
 
 Hardly used
 ------------
@@ -385,6 +363,115 @@
 * UserList/UserString [done]
 
   + Not useful since types can be a superclass.
+  
+  
+Mac-specific modules
+////////////////////
+
+Thanks to both Apple including Python with OS X and PyObjC_,
+the included Mac modules in Python are obsolete.
+Apple's Cocoa API will always be more up-to-date than Python's own
+attempt at maintaining wrappers. Plus Apple can be expected to
+include useful Mac-only modules that third-parties do not provide.
+
+* aepack
+
+    - OSA support is better through third-party modules.
+
+        * Appscript [#appscript]_.
+
+    - Hard-coded endianness which breaks on Intel Macs.
+    - Might need to rename if Carbon package dependent.
+
+* aetools
+
+    - See aepack.
+
+* aetypes
+
+    - See aepack.
+
+* applesingle
+
+    - Undocumented.
+    - AppleSingle is a binary file format for A/UX.
+    - A/UX no longer distributed.
+
+* autoGIL
+
+    - Very bad model for using Python with the CFRunLoop.
+
+* Carbon
+
+    - Carbon development has stopped.
+    - Does not support 64-bit systems completely.
+    - Dependent on bgen which has never been updated to support UCS-4
+      Unicode builds of Python.
+
+* ColorPicker
+
+    - Better to use Cocoa for GUIs.
+
+* EasyDialogs
+
+    - Better to use Cocoa for GUIs.
+
+* findertools
+
+    - No longer useful.
+
+* FrameWork
+
+    - Poorly documented.
+    - Not updated to support Carbon Events.
+
+* gensuitemodule
+
+    - See aepack.
+
+* ic
+
+* icopen
+
+    - Not needed on OS X.
+    - Meant to replace 'open' which is usually a bad thing to do.
+
+* macerrors
+
+    - Undocumented.
+
+* MacOS
+
+    - Would also mean the removal of binhex.
+
+* macostools
+
+* macresource
+
+    - Undocumented.
+
+* MiniAEFrame
+
+    - See aepack.
+
+* Nav
+
+    - Undocumented.
+
+* PixMapWrapper
+
+    - Undocumented.
+
+* videoreader
+
+     - No longer used.
+
+* W
+
+     - No longer distributed with Python.
+
+
+.. _PyObjC: http://pyobjc.sourceforge.net/
 
 
 Modules to Rename