This is alpha release 0.4.7 (August 18, 1997) of the GNU make test
suite.  See the file NEWS for some of the changes since the last
release.

This release is made by psmith@baynetworks.com to correspond to GNU make
3.76.  It won't work correctly for GNU make 3.75 and before.  In
addition to some changes I've added a few new tests.

Some bugs reported for previous releases have been fixed; I am getting
this out now as is rather than letting it wait any longer.  It is by no
means complete, but it is better than nothing, and so I am making it
available.  I don't really have time to work on this, but I sort of try
to keep up with changes in make.  If you would like to contribute tests
or help out in other ways, send email (address below).

Any bugs, failures, problems, etc., that seem to be the result of
faults in the test suite rather than in make itself should be reported
to csa@csatech.com or csa@gnu.ai.mit.edu, along with miscellaneous
suggestions, etc.

The test suite thus far has been written by Steve McGee and Chris
Arthur.  It is covered by the GNU General Public License (Version 2),
described in the file COPYING.

The test suite is known to work with perl 4.036 and perl 5.004
(available from prep.ai.mit.edu, and portable to many machines).
Earlier or later versions may work; I don't know.  It assumes that the
first "diff" it finds is GNU diff, but that only matters if a test
fails.

To run the make test suite, use "perl run_make_tests" (or just
"run_make_tests" if you have a /usr/local/bin/perl, or you change the
first line in the file run_make_tests to point to your friendly
neighborhood perl).

By default, it picks up the first executable called "make" that it
finds in your path.  You may use the -make_path option (ie,
"perl run_make_tests -make_path /usr/local/gnu/make-3.82.647/make")
if you want to run a particular copy.  This now works correctly
with relative paths and when make is called something other than
"make" (like "gmake").

Tests cannot end with a "~" character, as the test suite will ignore any
that do (I was tired of having it run my Emacs backup files as test :)

The options/dash-l test will not really test anything if the copy of
make you are using can't read /dev/kmem (ie, if you didn't install it
or weren't running as root when you did).  If you don't want to
install it just to test it, make it setgid to kmem or whatever group
/dev/kmem is (ie, "chgrp kmem make;chmod g+s make" as root).  In any
case, the options/dash-l test should no longer *fail* because make
can't read /dev/kmem.

A directory named "work" will be created when the tests are run which
will contain any makefiles and "diff" files of tests that fail so that
you may look at them afterward to see the output of make and the
expected result.

There is a -help option which will give you more information about the
other possible options for the test suite.

As stated above, complaints/suggestions/bugs/etc. should be sent to
csa@csatech.com or csa@gnu.ai.mit.edu (same person).  Enjoy!

						Chris Arthur
