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

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

1 files changed, 9 insertions, 0 deletions

diff --git a/Lib/cgi.py b/Lib/cgi.py
index f3d2725..9c38359 100755
--- 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