README.alpha

   1 GNU Libtool
   2 ***********
   3
   4 1. Introduction
   5 ===============
   6
   7 This is an alpha testing release of GNU Libtool, please try it on all
   8 the platforms you have access to.  Using it more or less implicitly
   9 signs you up to help us find whatever problems you report.
  10
  11 See the file INSTALL for generic instructions on how to build and install
  12 Libtool.  Please see the file doc/notes.txt for some platform-specific
  13 information.  Please note that you need GNU make to build Libtool.
  14
  15 If it builds and passes the test suite (`gmake check'), please send
  16 notification to the libtool mailing list <libtool@gnu.org> with a
  17 subject line including the string `[PLATFORM]'.
  18
  19
  20 2. Reporting Bugs
  21 =================
  22
  23 If this distribution doesn't work for you, before you report the
  24 problem, please try upgrading to the latest version from CVS first:
  25
  26   export CVS_RSH=ssh
  27   cvs -z3 -d :pserver:anonymous@cvs.sv.gnu.org:/sources/libtool co libtool
  28   cd libtool
  29   ./bootstrap
  30
  31 The `bootstrap' script sets up the source directory for you to hack,
  32 though it may take quite some time to run.  To use it, you need a recent
  33 (maybe yet to be released) version of both Autoconf and Automake.  If
  34 you don't intend to run the test suite, you can speed up the `bootstrap'
  35 step by an order of magnitude if you call it like this instead:
  36
  37   reconfdirs='. libltdl' ./bootstrap
  38
  39 If your bug is not fixed in the latest version, please send a full
  40 report to <bug-libtool@gnu.org>, including the information from the end
  41 of the help message given by `./libtool --help', and the verbose output
  42 of any failed test groups (as described below).
  43
  44
  45 3. The Test Suites
  46 ==================
  47
  48 Libtool comes with two integrated sets of tests to check that your build
  49 is sane.  You can run both test suites like this, assuming that `gmake'
  50 refers to GNU make:
  51
  52   gmake -k check
  53
  54 If you want to run the old testsuite only, do it like this:
  55
  56   gmake check TESTSUITEFLAGS=-V
  57
  58 If you want to run the new testsuite only, do it like this:
  59
  60   gmake check-local
  61
  62 The tests of the old test suite run in groups in the various demo
  63 subdirectories, so if one of the tests early in a group FAILs, the rest
  64 of the tests in that group will be SKIPped.  If you see a FAIL further
  65 into a group, even if a test with the same name PASSes in another test
  66 group, you need to take note of the name of the first test in the group
  67 if you want to rerun the group with FAILures to get verbose output.
  68
  69 To run a test group of the old test suite in isolation (say, you think
  70 you have fixed a bug, but don't want to rerun the entire suite), you can
  71 do it like this:
  72
  73   gmake check TESTS="tests/cdemo-static.test tests/cdemo-make.test \
  74                      tests/cdemo-exec.test" \
  75               TESTSUITEFLAGS=-V
  76
  77 Providing that you have a FAIL from the most recent group from a
  78 particular demo directory (like the cdemo-static.test group above), you
  79 can explore the state of the directory to help with debugging.
  80
  81 If you wish to report a test group failure to the libtool list, you need
  82 to send the verbose output of the FAILing group, along with the
  83 information from the end of `$(top_builddir)/libtool --help' to the bug
  84 report mailing list, <bug-libtool@gnu.org> with a subject line that
  85 includes the string `[TEST FAILURE]'.  From a Bourne compatible shell,
  86 you can generate verbose test output like this:
  87
  88   VERBOSE=yes gmake check \
  89   TESTS="tests/cdemo-static.test tests/cdemo-make.test tests/cdemo-exec.test" \
  90   TESTSUITEFLAGS=-V | tee cdemo-static-group.log
  91
  92 In order to enable debug shell tracing, use VERBOSE=debug instead of
  93 VERBOSE=yes.
  94
  95
  96 In the long run, Libtool will move to using only the new,
  97 Autotest-driven testsuite.  Its usage is documented in
  98
  99   info Autoconf 'testsuite Invocation'
 100
 101 but simple help may also be obtained through
 102
 103   gmake check-local TESTSUITEFLAGS='--help'
 104
 105 For verbose output, add the flag `-v', for running only a subset of the
 106 independent tests, merely specify them by number or by keyword, both of
 107 which are displayed with the `--list' flag.  For example, the `libtool'
 108 keyword is used for the tests that exercise only this script.  So it is
 109 possible to test an installed script, possibly from a different Libtool
 110 release, with
 111   gmake check-local TESTSUITEFLAGS="-k libtool LIBTOOL=/path/to/libtool"
 112
 113 If you wish to report test failures to the libtool list, you need to
 114 send the file `tests/testsuite.log' to the bug report mailing list,
 115 <bug-libtool@gnu.org>.
 116
 117 --
 118   Copyright (C) 2004, 2005, 2006, 2007, 2008  Free Software Foundation, Inc.
 119   Written by Gary V. Vaughan, 2004
 120
 121   This file is part of GNU Libtool.
 122
 123 GNU Libtool is free software; you can redistribute it and/or
 124 modify it under the terms of the GNU General Public License as
 125 published by the Free Software Foundation; either version 2
 126 of the License, or (at your option) any later version.
 127
 128 GNU Libtool is distributed in the hope that it will be useful,
 129 but WITHOUT ANY WARRANTY; without even the implied warranty of
 130 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 131 GNU General Public License for more details.
 132
 133 You should have received a copy of the GNU General Public License
 134 along with GNU Libtool; see the file COPYING.  If not, a copy
 135 can be downloaded from http://www.gnu.org/licenses/gpl.html, or
 136 obtained by writing to the Free Software Foundation, Inc.,
 137 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301  USA
 138
 139
 140 Local Variables:
 141 mode: text
 142 fill-column: 72
 143 End:
 144 vim:tw=72