7a5573f
Improve the documentation that will be installed in the mysql-test RPM.
7a5573f
7a5573f
7a5573f
diff -Naur mysql-5.5.20.orig/mysql-test/README mysql-5.5.20/mysql-test/README
7a5573f
--- mysql-5.5.20.orig/mysql-test/README	2011-12-16 14:52:05.000000000 -0500
7a5573f
+++ mysql-5.5.20/mysql-test/README	2012-02-10 17:06:19.531082253 -0500
7a5573f
@@ -1,14 +1,26 @@
7a5573f
 This directory contains a test suite for the MySQL daemon. To run
7a5573f
-the currently existing test cases, simply execute ./mysql-test-run in
7a5573f
-this directory. It will fire up the newly built mysqld and test it.
7a5573f
+the currently existing test cases, execute ./mysql-test-run in
7a5573f
+this directory.
7a5573f
 
7a5573f
-Note that you do not have to have to do "make install", and you could
7a5573f
-actually have a co-existing MySQL installation. The tests will not
7a5573f
-conflict with it.
7a5573f
-
7a5573f
-All tests must pass. If one or more of them fail on your system, please
7a5573f
-read the following manual section for instructions on how to report the
7a5573f
-problem:
7a5573f
+For use in Red Hat distributions, you should run the script as user mysql,
7a5573f
+so the best bet is something like
7a5573f
+	cd /usr/share/mysql-test
Bjorn Munch 5f2a76b
+	sudo -u mysql ./mysql-test-run --skip-test-list=platform-specific-tests.list
7a5573f
+This will use the installed mysql executables, but will run a private copy
7a5573f
+of the server process (using data files within /usr/share/mysql-test),
7a5573f
+so you need not start the mysqld service beforehand.
7a5573f
+
Bjorn Munch 5f2a76b
+The "--skip-test-list=platform-specific-tests.list" option excludes tests that are
7a5573f
+known to fail on one or more Red-Hat-supported platforms.  You can omit it
7a5573f
+if you want to check whether such failures occur for you.  Documentation
7a5573f
+about the reasons for omitting such tests can be found in the file
Bjorn Munch 5f2a76b
+platform-specific-tests.list.
7a5573f
+
7a5573f
+To clean up afterwards, remove the created "var" subdirectory, eg
7a5573f
+	sudo -u mysql rm -rf /usr/share/mysql-test/var
7a5573f
+
7a5573f
+If one or more tests fail on your system, please read the following manual
7a5573f
+section for instructions on how to report the problem:
7a5573f
 
7a5573f
 http://dev.mysql.com/doc/mysql/en/mysql-test-suite.html
7a5573f
 
7a5573f
@@ -25,7 +37,8 @@
7a5573f
 
7a5573f
 With no test cases named on the command line, mysql-test-run falls back
7a5573f
 to the normal "non-extern" behavior. The reason for this is that some
7a5573f
-tests cannot run with an external server.
7a5573f
+tests cannot run with an external server (because they need to control the
7a5573f
+options with which the server is started).
7a5573f
 
7a5573f
 
7a5573f
 You can create your own test cases. To create a test case, create a new