Changes between Version 7 and Version 8 of PythonGuidelines

Timestamp:

Mar 31, 2010, 9:22:46 AM (15 years ago)

Author:

Chris Jerdonek

Comment:

Wording improvements to upgrade section.

PythonGuidelines

@@ -34 +34 @@
  This should usually not be necessary, but it ensures that you are not mistakenly using a wrong file since *.pyc files without a *.py file can still get executed.  Incidentally, we try to use fully-qualified import statements throughout our code so that the location of modules in webkitpy/ is never be ambiguous.
 
-== Installing a new version of Python ==
+== Upgrading from Python 2.3 or Python 2.4 ==
 
-[Most of these instructions are Mac-specific.]
+[Much of these instructions are Mac-specific.]
+
+If you are upgrading from Python 2.3 or 2.4, you should upgrade to Python 2.6 rather than 2.5.
 
 You can tell what version of Python you are currently using by typing--
@@ -47 +49 @@
 man python
 }}}
-On Snow Leopard you will find that your machine comes with Python 2.5, 2.6, and 3.0.  The man page also provides instructions on how to switch your system between these system-installed versions.
+For example, Snow Leopard comes with Python 2.5, 2.6, and 3.0.  The man page provides instructions on how to switch your system between these system-installed versions.
 
 If you need to install a new version not on your machine, you can use [http://guide.macports.org/ MacPorts] to do this.  MacPorts allows you to install Python versions alongside your system versions without interfering with them.  After installing MacPorts, simply type (for example)--
@@ -53 +55 @@
 sudo port install python26
 }}}
-We recommend that Tiger users with 2.3 install Python 2.6 for starters.
 
 You should probably also install python_select using MacPorts--