mirror of
git://git.savannah.gnu.org/libtool.git
synced 2024-11-27 06:09:57 +08:00
97a1358f43
`TESTSUITEFLAGS' rather than `TESTSUITE_FLAGS', like Autoconf. * HACKING, README, README.alpha: All uses changed.
132 lines
4.7 KiB
Plaintext
132 lines
4.7 KiB
Plaintext
GNU Libtool
|
|
***********
|
|
|
|
1. Introduction
|
|
===============
|
|
|
|
This is an alpha testing release of GNU Libtool, please try it on all
|
|
the platforms you have access to. Using it more or less implicitly
|
|
signs you up to help us find whatever problems you report.
|
|
|
|
If it builds and passes the test suite (`make check'), please send
|
|
notification to the libtool mailing list <libtool@gnu.org> with a
|
|
subject line including the string `[PLATFORM]'.
|
|
|
|
|
|
2. Reporting Bugs
|
|
=================
|
|
|
|
If this distribution doesn't work for you, before you report the
|
|
problem, please try upgrading to the latest version from CVS first:
|
|
|
|
export CVS_RSH=ssh
|
|
cvs -z3 -d :pserver:anonymous@cvs.sv.gnu.org:/sources/libtool co libtool
|
|
cd libtool
|
|
./bootstrap
|
|
|
|
The `bootstrap' script sets up the source directory for you to hack,
|
|
though it may take quite some time to run. To use it, you need a recent
|
|
(maybe yet to be released) version of both Autoconf and Automake. If
|
|
you don't intend to run the test suite, you can speed up the `bootstrap'
|
|
step by an order of magnitude if you call it like this instead:
|
|
|
|
reconfdirs='. libltdl' ./bootstrap
|
|
|
|
If your bug is not fixed in the latest version, please send a full
|
|
report to <bug-libtool@gnu.org>, including the information from the end
|
|
of the help message given by `./libtool --help', and the verbose output
|
|
of any failed test groups (as described below).
|
|
|
|
|
|
3. The Test Suites
|
|
==================
|
|
|
|
Libtool comes with two integrated sets of tests to check that your build
|
|
is sane. You can run both test suites like this:
|
|
|
|
make check TESTSUITEFLAGS=-V
|
|
make check-local
|
|
|
|
The tests of the old test suite run in groups in the various demo
|
|
subdirectories, so if one of the tests early in a group FAILs, the rest
|
|
of the tests in that group will be SKIPped. If you see a FAIL further
|
|
into a group, even if a test with the same name PASSes in another test
|
|
group, you need to take note of the name of the first test in the group
|
|
if you want to rerun the group with FAILures to get verbose output.
|
|
|
|
To run a test group of the old test suite in isolation (say, you think
|
|
you have fixed a bug, but don't want to rerun the entire suite), you can
|
|
do it like this:
|
|
|
|
make check TESTS='cdemo-static.test cdemo-make.test cdemo-exec.test' \
|
|
TESTSUITEFLAGS=-V
|
|
|
|
Providing that you have a FAIL from the most recent group from a
|
|
particular demo directory (like the cdemo-static.test group above), you
|
|
can explore the state of the directory to help with debugging.
|
|
|
|
If you wish to report a test group failure to the libtool list, you need
|
|
to send the verbose output of the FAILing group, along with the
|
|
information from the end of `$(top_builddir)/libtool --help' to the bug
|
|
report mailing list, <bug-libtool@gnu.org> with a subject line that
|
|
includes the string `[TEST FAILURE]'. From a Bourne compatible shell,
|
|
you can generate verbose test output like this:
|
|
|
|
VERBOSE=yes make check \
|
|
TESTS='cdemo-static.test cdemo-make.test cdemo-exec.test' \
|
|
TESTSUITEFLAGS=-V | tee cdemo-static-group.log
|
|
|
|
In order to enable debug shell tracing, use VERBOSE=debug instead of
|
|
VERBOSE=yes.
|
|
|
|
|
|
In the long run, Libtool will move to using only the new,
|
|
Autotest-driven testsuite. Its usage is documented in
|
|
|
|
info Autoconf 'testsuite Invocation'
|
|
|
|
but simple help may also be obtained through
|
|
|
|
make check-local TESTSUITEFLAGS='--help'
|
|
|
|
For verbose output, add the flag `-v', for running only a subset of the
|
|
independent tests, merely specify them by number or by keyword, both of
|
|
which are displayed with the `--list' flag.
|
|
|
|
If you wish to report test failures to the libtool list, you need to
|
|
send the file `tests/testsuite.log' to the bug report mailing list,
|
|
<bug-libtool@gnu.org>.
|
|
|
|
--
|
|
Copyright (C) 2004, 2005 Free Software Foundation, Inc.
|
|
|
|
The canonical source of this file is maintained with the
|
|
GNU Libtool package. Report bugs to bug-libtool@gnu.org.
|
|
|
|
GNU Libtool 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 2
|
|
of the License, or (at your option) any later version.
|
|
|
|
As a special exception to the GNU General Public License,
|
|
if you distribute this file as part of a program or library that
|
|
is built using GNU libtool, you may include it under the same
|
|
distribution terms that you use for the rest of that program.
|
|
|
|
GNU Libtool 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 GNU Libtool; if not, write to the Free Software
|
|
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
|
|
02110-1301 USA
|
|
|
|
|
|
Local Variables:
|
|
mode: text
|
|
fill-column: 72
|
|
End:
|
|
vim:tw=72
|