Python 3: Add caveats about Tcl/Tk

1 files changed, 17 insertions, 19 deletions

diff --git a/Library/Formula/python3.rb b/Library/Formula/python3.rb
index d05ef675a..2f923009e 100644
--- a/Library/Formula/python3.rb
+++ b/Library/Formula/python3.rb
@@ -1,14 +1,8 @@
 require 'formula'
 
-<<-COMMENTS
-Versions
---------
-This formula is currently tracking version 3.2.
-
-Python 2.x is available as a separate formula:
-  brew install python
-
-COMMENTS
+# This formula is for Python version 3.2.
+# Python 2.7.1 is available as a separate formula:
+# $ brew install python
 
 # Was a Framework build requested?
 def build_framework?; ARGV.include? '--framework'; end
@@ -37,8 +31,9 @@ class Python3 < Formula
 
   skip_clean ['bin', 'lib']
 
+  # The Cellar location of site-packages
+  # This location is different for Framework builds
   def site_packages
-    # The Cellar location of site-packages
     if as_framework?
       # If we're installed or installing as a Framework, then use that location.
       return prefix+"Frameworks/Python.framework/Versions/3.2/lib/python3.2/site-packages"
@@ -48,14 +43,15 @@ class Python3 < Formula
     end
   end
 
+  # The HOMEBREW_PREFIX location of site-packages
+  # We write a .pth file in the Cellar site-packages to here
   def prefix_site_packages
-    # The HOMEBREW_PREFIX location of site-packages
     HOMEBREW_PREFIX+"lib/python3.2/site-packages"
   end
 
   def install
-    # --with-computed-gotos requires addressable labels in C;
-    # both gcc and LLVM support this, so switch it on.
+    # --with-computed-gotos requires addressable labels in C.
+    # Both gcc and LLVM support this, so switch it on.
     args = ["--prefix=#{prefix}", "--with-computed-gotos"]
 
     if ARGV.include? '--universal'
@@ -78,13 +74,15 @@ class Python3 < Formula
     (site_packages+"homebrew.pth").write prefix_site_packages
   end
 
-  def caveats
-    <<-EOS.undent
-      The site-packages folder for this Python is:
-        #{site_packages}
+  def caveats; <<-EOS.undent
+    Apple's Tcl/Tk is not recommended for use with 64-bit Python.
+    For more information see: http://www.python.org/download/mac/tcltk/
+
+    The site-packages folder for this Python is:
+      #{site_packages}
 
-      We've added a "homebrew.pth" file to also include:
-        #{prefix_site_packages}
+    We've added a "homebrew.pth" file to also include:
+      #{prefix_site_packages}
     EOS
   end
 end