Fix a couple of failures in mysql backend unit tests.

Fix the mysql backend docs

Note requirement of MySQL version 4.0+ with InnoDB or BDB mysql backend

Author: Richard Jones

CHANGES.txt

@@ -4,6 +4,10 @@ are given with the most recent entry first.
 200?-??-?? 0.7.0
 Feature:
 - support confirming registration by replying to the email (sf bug 763668)
+- support setgid and running on port < 1024 (sf patch 777528)
+
+Fixed:
+- mysql documentation fixed to note requirement of 4.0+ and InnoDB
 
 
 2003-10-?? 0.6.3

doc/Makefile

@@ -2,7 +2,7 @@ PYTHON = /usr/bin/python2
 STXTOHTML = rst2html
 
 SOURCE = announcement.txt customizing.txt developers.txt FAQ.txt features.txt \
-    glossary.txt implementation.txt index.txt design.txt \
+    glossary.txt implementation.txt index.txt design.txt mysql.txt \
     installation.txt upgrading.txt user_guide.txt maintenance.txt
 
 COMPILED := $(SOURCE:.txt=.html)

doc/installation.txt

@@ -2,7 +2,7 @@
 Installing Roundup
 ==================
 
-:Version: $Revision: 1.58 $
+:Version: $Revision: 1.59 $
 
 .. contents::
 
@@ -244,8 +244,9 @@ There's several to choose from, each with benefits and limitations:
 **mysql**
   Backend for popular RDBMS MySQL. According to benchmarks, this backend works
   much faster than any of \*dbm ones, but slightly slower than metakit and
-  sqlite. A good scalability is not a property of this backend for now,
-  though. For more info on backend installation see doc/mysql.txt. 
+  sqlite. Scalability is unknown at present. Roundup requires InnoDB or BDB
+  support in MySQL. For more info on requirements and installation see
+  `additional mysql documentation`_ (doc/mysql.txt)
 **metakit**
   This backend is implemented over the metakit_ storage system, using Mk4Py as
   the interface. It scales much better than the dbm backends.
@@ -584,4 +585,5 @@ Next: `User Guide`_
 .. _`maintenance documentation`: maintenance.html
 .. _sqlite: http://www.hwaci.com/sw/sqlite/
 .. _metakit: http://www.equi4.com/metakit/
+.. _`additional mysql documentation`: doc/mysql.html
 

doc/mysql.txt

@@ -2,7 +2,9 @@
 MySQL Backend
 =============
 
-This notes detail the MySQL backend for the roundup issue tracker.
+:version: $Revision: 1.5 $
+
+This notes detail the MySQL backend for the Roundup issue tracker.
 
 
 Prerequisites
@@ -11,10 +13,10 @@ Prerequisites
 To use MySQL as the backend for storing roundup data, you also need 
 to install:
 
-    1. MySQL RDBMS 3.23.34 or higher - http://www.mysql.com. Your MySQL
-       installation should support Berkeley DB (BDB) tables for transaction
-       support.
-    2. Python MySQL interface - http://sourceforge.net/projects/mysql-python
+1. MySQL RDBMS 4.0 or higher - http://www.mysql.com. Your MySQL
+   installation MUST support InnoDB tables (or Berkeley DB (BDB) tables
+   if you have no other choice)
+2. Python MySQL interface - http://sourceforge.net/projects/mysql-python
 
 
 Running the MySQL tests
@@ -23,16 +25,19 @@ Running the MySQL tests
 Roundup tests expect an empty MySQL database. Two alternate ways to provide 
 this:
 
-    1. If you have root permissions on the MySQL server, you can create 
-       the necessary database entries using this SQL sequence:
+1. If you have root permissions on the MySQL server, you can create 
+   the necessary database entries using the follwing SQL sequence. Use
+   ``mysql`` on the command line to enter::
 
-       CREATE DATABASE rounduptest
-       GRANT ALL PRIVILEGES ON rounduptest TO rounduptest@localhost IDENTIFIED BY 'rounduptest'
-       FLUSH PRIVILEGES
+       CREATE DATABASE rounduptest;
+       USE rounduptest;
+       GRANT ALL PRIVILEGES ON rounduptest.* TO rounduptest@localhost
+            IDENTIFIED BY 'rounduptest';
+       FLUSH PRIVILEGES;
 
-    2. If your administrator has provided you with database connection info, 
-       you can modify MYSQL_* constants in the file test/test_db.py with 
-       the correct values.
+2. If your administrator has provided you with database connection info, 
+   you can modify MYSQL_* constants in the file test/test_db.py with 
+   the correct values.
 
 Note that the MySQL database should not contain any tables. Tests will not 
 drop the database with existing data.
@@ -43,19 +48,17 @@ Additional configuration
 
 To initialise and use the MySQL database backend, roundup's configuration 
 file (config.py in the tracker's home directory) should have the following
-entries:
+entries::
 
     MYSQL_DBHOST = 'localhost'
     MYSQL_DBUSER = 'rounduptest'
     MYSQL_DBPASSWORD = 'rounduptest'
     MYSQL_DBNAME = 'rounduptest'
-    MYSQL_DATABASE = ( MYSQL_DBHOST, MYSQL_DBUSER, MYSQL_DBPASSWORD, MYSQL_DBNAME )
+    MYSQL_DATABASE = ( MYSQL_DBHOST, MYSQL_DBUSER, MYSQL_DBPASSWORD,
+        MYSQL_DBNAME )
 
 Fill in the first four entries with values for your local MySQL installation 
-before running "roundup-admin initialise". 
-
-
-    Andrey Lebedev <[email protected]>
-
+before running "roundup-admin initialise".  Use the commands in the `Running the
+MySQL tests` to set up a database if you have privilege, or ask your local
+administrator if not.
 
- vim: et tw=80