Added a comment explaining why this file must really have #!

/usr/local/bin/python and not #! /usr/bin/env python.

diff --git a/Lib/cgi.py b/Lib/cgi.py
index f3d27255cb0fdca8a545262ae4c871548216b9f8..9c38359d4bfc07824a66f4b3e2b9f4d9a30359c2 100755 (executable)
--- a/Lib/cgi.py
+++ b/Lib/cgi.py
@@ -1,5 +1,14 @@
 #! /usr/local/bin/python
 
+# NOTE: the above "/usr/local/bin/python" is NOT a mistake.  It is
+# intentionally NOT "/usr/bin/env python".  On many systems
+# (e.g. Solaris), /usr/local/bin is not in $PATH as passed to CGI
+# scripts, and /usr/local/bin is the default directory where Python is
+# installed, so /usr/bin/env would be unable to find python.  Granted,
+# binary installations by Linux vendors often install Python in
+# /usr/bin.  So let those vendors patch cgi.py to match their choice
+# of installation.
+
 """Support module for CGI (Common Gateway Interface) scripts.
 
 This module defines a number of utilities for use by CGI scripts