From 26069f75f02e7635ac537c7987ec0605cbba56a5 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?=C5=81ukasz=20Nowak?= <luke@nexedi.com>
Date: Mon, 30 Aug 2010 03:04:00 +0000
Subject: [PATCH]  - running python with -E does not help, so revert it  -
 explain issues related to python environment in Troubleshooting section

git-svn-id: https://svn.erp5.org/repos/public/erp5/trunk@38056 20353a03-c40f-0410-a6d1-a30d3c3de9de
---
 buildout/Makefile        |  4 ++--
 buildout/README-2.12.txt | 20 ++++++++++++++++++++
 buildout/README.txt      | 20 ++++++++++++++++++++
 3 files changed, 42 insertions(+), 2 deletions(-)

diff --git a/buildout/Makefile b/buildout/Makefile
index 2dba8a3c4c..a4e8a7fe83 100644
--- a/buildout/Makefile
+++ b/buildout/Makefile
@@ -13,10 +13,10 @@ PACKAGE_APPLICATION_RELEASE=001
 endif
 
 software: bin/buildout
-	$(PYTHON) -SE bin/buildout $(BUILDOUT_OPT)
+	$(PYTHON) -S bin/buildout $(BUILDOUT_OPT)
 
 bin/buildout:
-	$(PYTHON) -SE bootstrap/bootstrap.py -d
+	$(PYTHON) -S bootstrap/bootstrap.py -d
 
 # run make assert to check that all is working
 assert: bin/python2.4
diff --git a/buildout/README-2.12.txt b/buildout/README-2.12.txt
index 7d5dfe3e02..c8b7066910 100644
--- a/buildout/README-2.12.txt
+++ b/buildout/README-2.12.txt
@@ -165,6 +165,26 @@ The '127.0.0.1:10002' coordinate above refers to the address of the configured
 mysql instance, according to the settings 'configuration:mysql_host' and
 'configuration:mysql_port' in 'instance-profiles/mysql.cfg'.
 
+Troubleshooting
+===============
+
+In various Linux distributions python is heavily patched and user related
+environment variables are set system wide. This affects behaviour of python
+and introduces various problem with running buildout.
+
+In case of such issues consider resetting some python environment variables
+before running buildout:
+
+ * PYTHONPATH
+ * PYTHONSTARTUP
+ * PYTHONDONTWRITEBYTECODE
+
+Example:
+
+$ unset PYTHONPATH PYTHONSTARTUP PYTHONDONTWRITEBYTECODE
+$ make
+$ # other buildout related commands
+
 TODO
 ====
 
diff --git a/buildout/README.txt b/buildout/README.txt
index 6a5cf8364e..96c8def2ee 100644
--- a/buildout/README.txt
+++ b/buildout/README.txt
@@ -129,3 +129,23 @@ doubt, unset it before invoking that command.
 After some time everything shall be locally available.
 
 Disclaimer: That way is still in early stage of development.
+
+Troubleshooting
+===============
+
+In various Linux distributions python is heavily patched and user related
+environment variables are set system wide. This affects behaviour of python
+and introduces various problem with running buildout.
+
+In case of such issues consider resetting some python environment variables
+before running buildout:
+
+ * PYTHONPATH
+ * PYTHONSTARTUP
+ * PYTHONDONTWRITEBYTECODE
+
+Example:
+
+$ unset PYTHONPATH PYTHONSTARTUP PYTHONDONTWRITEBYTECODE
+$ make
+$ # other buildout related commands
-- 
2.30.9