*** empty log message ***

svn path=/trunk/boinc/; revision=1909

doc/install_python_mysqldb.txt

@@ -7,65 +7,58 @@ http://sourceforge.net/projects/mysql-python
 
 INSTALLATION INSTRUCTIONS
 =========================
-=========================
 
 Lines beginning with "$" indicate example commands to execute the instructed
 step.
 
+The `shared module' options build a shared library for the Python-MySQLdb
+module that is loaded at Python run-time.  This requires that you have a
+shared version of the MySQL client library installed, i.e. libmysqlclient.so.
 
 Debian Linux: shared module
-===========================
+---------------------------
-1. Install
+    1. Install
        $ apt-get install python-mysqldb
     
-[ 2003/07: if you have both Python 2.1 and 2.2 installed and use python2.2, do
+    [ 2003/07: if you have both Python 2.1 and 2.2 installed and use python2.2, do
        $ apt-get install python2.2-mysqldb
-]
+    ]
 
-
+Red Hat Linux: shared module
-Other Unix/Linux: shared module
+----------------------------
-===============================
+    1. Download MySQL-python
-
-This option requires you have a shared MySQL client library installed.
-
-RPM
----
-1. Download MySQL-python
        $ wget http://easynews.dl.sourceforge.net/sourceforge/mysql-python/MySQL-python-0.9.2-1.i386.rpm
-2. Install
+    2. Install
        $ rpm (arguments?) 
 
-Source
+Other Unix/Linux: shared module
-------
+-------------------------------
-
+    1. Download MySQL-python
-1. Download MySQL-python
        $ wget http://easynews.dl.sourceforge.net/sourceforge/mysql-python/MySQL-python-0.9.2.tar.gz
-2. Unpack
+    2. Unpack
        $ gunzip -c MySQL-python-0.9.2.tar.gz | tar xf -
        $ cd MySQL-python-0.9.2
-3. Build
+    3. Build
        $ python setup.py build
-4. Install
+    4. Install
        $ python setup.py install
 
-
 Unix/Linux: compiled statically into Python
-===========================================
+-------------------------------------------
-
+    1. Download MySQL-python
-1. Download MySQL-python
        $ wget http://easynews.dl.sourceforge.net/sourceforge/mysql-python/MySQL-python-0.9.2.tar.gz
-2. Unpack
+    2. Unpack
        $ gunzip -c MySQL-python-0.9.2.tar.gz | tar xf -
-3. Download Python
+    3. Download Python
        $ wget http://python.org/ftp/python/2.3/Python-2.3.tgz   
-4. Unpack
+    4. Unpack
        $ gunzip -c Python-2.3.tgz | tar xf -
        $ cd Python-2.3
-5. Copy MySQL files
+    5. Copy MySQL files
        $ cp ../MySQL-python-0.9.2/{*c,*.h} Modules/
-6. Configure python
+    6. Configure python
        $ ./configure --prefix=/path/to/install/python
-7. Modify the Python module setup file.
+    7. Modify the Python module setup file.
        $ vi Modules/Setup
     
        Find 'sre _sre.c' and add below it:
@@ -73,24 +66,19 @@ Unix/Linux: compiled statically into Python
     
        If those -I and -L flags don't work you can find the correct ones using
        the program `mysql_config'
-8. Build
+    8. Build
        $ make
-9. Install
+    9. Install
        $ make install
 
-
 Windows: pre-packaged binary
-============================
+----------------------------
-
+    There is a built python executable available at the URL listed.
-There is a built python executable available at the URL listed.
-
-
 
 Does it work?
 =============
+    You can check if your MySQLdb was installed correctly like this:
     
-You can check if your MySQLdb was installed correctly like this:
+    $ python
-
+    >>> import MySQLdb
-$ python
+    >>> MySQLdb.connect(db='databasename', user='username')
->>> import MySQLdb
->>> MySQLdb.connect(db='databasename', user='username')