====== run-tests.php command line options and environment variables options ======

===== Short Options =====


^ Cmd line ^ ENV var ^ Function ^ Required in the re-write? ^ implemented ^
| h |  | help | yes | yes |
| p | PHP_TEST_EXECUTABLE | Specifies PHP executable to be tested | yes | yes |
| v |                     | Writes the PHP command that's passed to proc_open(), and ... | yes | yes, see verbose-mode |
| q | NO_INTERACTION                  | Suppress option to send results to QA? Only ever relevant if run using 'make test' I think | yes | |
| x | SKIP_SLOW_TESTS                | Skip slow tests | NO | |
| w <file> |                | Write a list of all failed tests to <file>. | NO | |
| a <file> |                | Same as -w but append rather then truncating <file> | NO | |
| c |                         | Look for php.ini in directory <file> or use <file> as ini | Yes |  |
| n |                        | Pass -n option to the php binary (Do not use a php.ini) | Yes |  |
| d foo=bar | | Pass -d foo=bar option to the php binary | Yes | |
| m          |               | Test for memory leaks with Valgrind | Yes (See additional requirement from Nuno)| yes |
| s <file> |                 | Write output to <file> | yes | yes |
| l <file>|                         | Read lists of tests to be executed from <file>, write failed tests back to same file | yes | |
| r <file> | | Read lists of tests to be executed from <file> | yes | |

===== Long options =====

^ Cmd line ^ ENV var ^ Function ^ Required in the re-write? ^ implemented ^
| html <file> |  | Write HTML summary output to file | NO (replaced by output-type)| | 
|temp-source <sdir>  temp-target <tdir> [temp-urlbase <url>] | | Write temporary files to <tdir> by replacing <sdir> from the filenames to generate with <tdir>... | NO | |
| keep-(all,php...) | | Do not delete 'all' files, 'php' test file, 'skip' or 'clean' file. |Yes (all, Nuno for gcov etc) | |
| set-timeout n | | Set timeout for individual tests. n is seconds | NO | |
| show-(all, php...) | | Show 'all' files, 'php' test file ... etc | NO | |
| no-clean | | Don't execute the CLEAN section | yes | |  
| verbose | | Writes the PHP command that's passed to proc_open(), and... | yes | yes, see verbose-mode |

===== New options =====

^ Cmd line ^ ENV var ^ Function ^ implemented ^
| o <list,csv,xml,html> |  | Specifies the output-type | yes |
| z <nproc> |  | Run in parallel, forks <nproc> processes. | yes | 
| v |  | verbose-mode level 1 | yes | 
| vv |  | verbose-mode level 2 | yes | 
| vvv |  | verbose-mode level 3 | yes | 


===== Environment variables =====
^ var name ^ Cmd line ^ Meaning ^ Required in the re-write^
| TEST_PHP_EXECUTABLE | p | PHP executable to test | Yes |
| TEST_PHP_CGI_EXECUTABLE | | PHP CGI executable to test | Yes |
|TEST_PHP_LOG_FORMAT | | Sets log format, defaults to LEOD (log, out, exp diff files are created) | |
| TEST_PHP_DETAILED | v/verbose | Writes the PHP command that's passed to proc_open(), and ... | |
| TEST_PHP_USER | | List of directories to be run | |
| NO_INTERACTION | q | Suppress option to send results to QA? Only ever relevant if run using 'make test' I think | |
| PHP_AUTOCONF | | ? *ix only | |
| TEST_PHP_ERROR_STYLE | | Strange logic, this is only ever used on failure to write log file. I don't think it can ever work | |
| NO_PHPTEST_SUMMARY | | Suppress listing of failed tests | |
| CC | | | |
| TEST_PHP_ARGS | | Command line arguments to run-tests.php |Yes (Nuno - for make test) |