1.1 --- a/tests/README	Sat May 29 23:48:42 2010 +0200
     1.2 +++ b/tests/README	Sun May 30 16:05:49 2010 +0200
     1.3 @@ -1,37 +1,29 @@
     1.4 -Here a two test programs: local.sh and smtpout.sh. They both send
     1.5 -three mails, using different options. Run them from within this
     1.6 -directory, preferably NOT as root, but you got to have write
     1.7 -permission for this directory.
     1.8 +This directory contains test cases for masqmail, one in each directory.
     1.9  
    1.10 -local.sh sends mail accepted from stdin and sends them to a fake local
    1.11 -mailbox, using your login name. If it works, there should be a file
    1.12 -named with your login name with the mails. You can look at it with cat
    1.13 -or less, or with an ordinary mail program.
    1.14 +Build the test scripts be running
    1.15 +	make
    1.16 +in the directory. You can build all of them by running
    1.17 +	make
    1.18 +in the tests directory.
    1.19  
    1.20 -smtpout.sh sends mail accepted from stdin and sends them to your local
    1.21 -MTA, so use it only if you have an MTA running on your box (sendmail,
    1.22 -exim, qmail or whatever, or masqmail when you have it already
    1.23 -installed). If it works, you should get three mails.
    1.24 +Run the test by executing
    1.25 +	./test
    1.26 +in its directory, preferably NOT as root, but you got to have write
    1.27 +permission for the directory.
    1.28  
    1.29 -The scripts assume that your login name corresponds to your mailbox
    1.30 -(quite probable) and that your MTA listens on port 25 with the
    1.31 -interface which corresponds to the hostname as returned by the shell
    1.32 -command "hostname" (without quotes...), also very probable. They are
    1.33 -created with make from test.templ. They use a special configuration
    1.34 -(test.conf) for masqmail, which is also created with make from
    1.35 -conf.templ.
    1.36  
    1.37 -Two log files, masqmail.log and debug.log will also be created within
    1.38 -this directory. They may give some information if anything went wrong.
    1.39 +Usually, two log files, masqmail.log and debug.log, will be created.
    1.40 +They may give some information if anything went wrong.
    1.41  
    1.42 -If the log files reveal that your MTA is not willing to relay, you may
    1.43 -have to qualify the hostname: Say
    1.44 +The README files in the test case directories explain the tests in
    1.45 +more detail.
    1.46  
    1.47 -sed s/RECV_HOST/foo.bar.com/ test.templ > smtpout.sh
    1.48  
    1.49 -where you set your fully qualified host name for foo.bar.com.
    1.50 +FIXME: Currently, the return values of the test scripts don't express
    1.51 +       if the test was successful or not.
    1.52  
    1.53 -If they do not work, there could be some problem with either the test
    1.54 +
    1.55 +If tests do not work, there could be some problem with either the test
    1.56  programs, the configuration file or masqmail itself. If you have
    1.57  installed masqmail successfully and these scripts do not work, do not
    1.58  worry too much :-).