autoconf/BUGS
Eric Blake d46e5d6844 For now, skip parallel tests under less-tested shells.
* tests/autotest.at (AT_CHECK_AT): Add pre-test argument.
(Tested programs, Startup error messages, AT_CHECK_AT_TITLE)
(Fallacy, Skip, errexit, Long test source lines)
(Debugging a successful test, Debugging script and environment)
(Debugging a failed test, Using atlocal)
(Choosing where testsuite is run): Adjust callers.
(AT_SKIP_PARALLEL_TESTS): New macro, to skip parallel tests except
under zsh, bash, or when TEST_PARALLEL_AUTOTEST is defined.  Makes
it easier to avoid testsuite hangs for users with dash or other
less-tested shell.
(parallel test execution, parallel truth, parallel fallacy)
(parallel skip, parallel errexit)
(parallel autotest and signal handling): Use it.
* BUGS: Mention this.

Signed-off-by: Eric Blake <ebb9@byu.net>
2009-03-30 08:11:09 -06:00

46 lines
2.0 KiB
Plaintext

-*- outline -*-
This file lists the bugs you must be aware of. Be sure to check this
file before using Autoconf, and especially git versions of Autoconf.
Copyright (C) 2000-2002, 2006-2009 Free Software Foundation, Inc.
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.
Autoconf must not be used in production if there are ``Serious'' bugs,
and use with caution an Autoconf with ``Important bugs''.
* Status
/*------------------------------------.
| New features need further testing. |
`------------------------------------*/
* Now that configure depends on shell functions, it is possible that
configure scripts may fail to run on old platforms that lack a shell
with proper function support.
* Autotest parallel testsuite support is still a work in progress.
There are known issues in job handling under dash and some ksh
variants, where a parallel testsuite can hang or cause a 100%
processor load. In the current release, the overall autoconf
testsuite only exercises parallel autotest under bash and zsh, or if
you have defined TEST_PARALLEL_AUTOTEST in the environment.
Meanwhile, Cygwin has known problems with named fifos that cause
failures when attempting parallel tests in an autotest suite. It is
possible that other difficulties will be encountered, whether with
shell or platform limitations; help is appreciated in improving
parallel testsuite support.