Fix some formatting problems

MySQLdb/README

@@ -9,89 +9,92 @@ Prerequisites
 
 + Python 2.3.4 or higher
 
-   * http://www.python.org/
+  * http://www.python.org/
 
-   * Versions lower than 2.2 WON'T WORK.
+  * Versions lower than 2.2 WON'T WORK.
 
-   * 2.2.x MIGHT work, or have partial functionality.
+  * 2.2.x MIGHT work, or have partial functionality.
 
-   * 2.4b2 seems to work fine.
+  * 2.4 is tested and works.
 
-   * Red Hat Linux:
+  * Red Hat Linux:
 
-     - Make sure you have the Python development headers and libraries
+    - Make sure you have the Python development headers and libraries
-       (python-devel).
+      (python-devel).
 
 + MySQL 3.23.32 or higher
 
-    * http://www.mysql.com/downloads/
+  * http://www.mysql.com/downloads/
 
-    * Versions lower than 3.22 definitely WON'T WORK.
+  * Versions lower than 3.22 definitely WON'T WORK.
 
-    * Versions lower than 3.22.19 might not work.
+  * Versions lower than 3.22.19 might not work.
 
-    * MySQL-3.22 is deprecated in favor of 3.23, but still supported.
+  * MySQL-3.22 is deprecated in favor of 3.23, but still supported.
 
-    * MySQL-3.23 is supported, but slightly deprecated.
+  * MySQL-3.23 is supported, but slightly deprecated.
 
-    * MySQL-4.0 is supported. Current version is 4.0.22.
+  * MySQL-4.0 is supported.
 
-    * There is partial support for MySQL-4.1; the new prepared
+  * MySQL-4.1 is mostly supported; the new prepared statements API
-      statements API is not yet supported, and probably won't be until
+    is not yet supported, and probably won't be until MySQLdb-1.3 or
-      MySQLdb-1.3 or 2.0.
+    2.0.
 
-    * MySQL-5.0 and newer are not currently supported, but might work.
+  * MySQL-5.0 and newer are not currently supported, but might work.
       
-    * MaxDB, formerly known as SAP DB (and maybe Adabas D?), is a
+  * MaxDB, formerly known as SAP DB (and maybe Adabas D?), is a
-      completely different animal. Use the sapdb.sql module that comes
+    completely different animal. Use the sapdb.sql module that comes
-      with MaxDB.
+    with MaxDB.
 
-    * Red Hat Linux packages:
+  * Red Hat Linux packages:
 
-      - mysql-devel to compile
+    - mysql-devel to compile
 
-      - mysql and/or mysql-devel to run
+    - mysql and/or mysql-devel to run
 
-    * MySQL.com RPM packages:
+  * MySQL.com RPM packages:
 
-      - MySQL-devel to compile
+    - MySQL-devel to compile
 
-      - MySQL-shared if you want to use their shared
+    - MySQL-shared if you want to use their shared
-        library. Otherwise you'll get a statically-linked module,
+      library. Otherwise you'll get a statically-linked module,
-        which may or may not be what you want.
+      which may or may not be what you want.
 
-      - MySQL-shared to run if you compiled with MySQL-shared installed
+    - MySQL-shared to run if you compiled with MySQL-shared installed
 
-    * Transactions (particularly InnoDB tables) are supported for
+  * Transactions (particularly InnoDB tables) are supported for
-      MySQL-3.23 and up. You may need a special package from your
+    MySQL-3.23 and up. You may need a special package from your vendor
-      vendor with this support turned on. If you have Gentoo Linux,
+    with this support turned on. If you have Gentoo Linux, set either
-      set either of the berkdb or innodb USE flags.
+    of the berkdb or innodb USE flags on your server, and comment out
+    "skip-innodb" in /etc/mysql/my.cnf for InnoDB table support.
       
 
 +  zlib
 
-    * Required for MySQL-3.23 and newer.
+   * Required for MySQL-3.23 and newer.
 
-    * Red Hat Linux
+   * Red Hat Linux
 
-      - zlib-devel to compile
+     - zlib-devel to compile
 
-      - zlib to run
+     - zlib to run
 
 + openssl
 
-    * May be needed for MySQL-4.0 or newer, depending on compilation
+  * May be needed for MySQL-4.0 or newer, depending on compilation
-      options.
+    options.
 
-+  C compiler
++ C compiler
 
-    * Most free software-based systems already have this, usually gcc.
+  * Most free software-based systems already have this, usually gcc.
 
-    * Most commercial UNIX platforms also come with a C compiler, or
+  * Most commercial UNIX platforms also come with a C compiler, or
-      you can also use gcc.
+    you can also use gcc.
 
-    * If you have some Windows flavor, you usually have to pay extra
+  * If you have some Windows flavor, you usually have to pay extra
-      for this, or you can use Cygwin.
+    for this, or you can use Cygwin_.
+
+.. _Cygwin: http://www.cygwin.com/
 
 
 
@@ -151,8 +154,8 @@ gcc.
 
 Finally, putting it together::
 
-  $ tar xfz MySQL-python-1.1.7.tar.gz
+  $ tar xfz MySQL-python-1.1.8.tar.gz
-  $ cd MySQL-python-1.1.7
+  $ cd MySQL-python-1.1.8
   $ export mysqlversion="4.0.20"
   $ export mysqlclient="mysqlclient_r"
   $ export mysqloptlibs="ssl crypto"
@@ -219,23 +222,23 @@ build your own RPM packages as described above.
 Debian GNU/Linux
 ................
 
-Packaged as `python-mysql`__::
+Packaged as `python-mysql`_::
 
 	# apt-get install python-mysql
 
-.. __: http://packages.debian.org/cgi-bin/search_packages.pl?keywords=python-mysql&searchon=names&subword=1&version=all&release=all
+.. _`python-mysql`: http://packages.debian.org/cgi-bin/search_packages.pl?keywords=python-mysql&searchon=names&subword=1&version=all&release=all
 
 
 Gentoo Linux
 ............
 
-Packaged as `mysql-python`__. Gentoo is also my development platform::
+Packaged as `mysql-python`_. Gentoo is also my development platform::
 
       # emerge sync
       # emerge mysql-python
       # emerge zmysqlda # if you use Zope
 
-.. __: http://packages.gentoo.org/search/?sstring=mysql-python
+.. _`mysql-python`: http://packages.gentoo.org/search/?sstring=mysql-python
 
 
 BSD