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 If it builds and passes the test suite (`make check'), please send
  12 notification to the libtool mailing list <libtool@gnu.org> with a
  13 subject line including the string `[PLATFORM]'.
  14
  15
  16 2. Reporting Bugs
  17 =================
  18
  19 If this distribution doesn't work for you, before you report the problem,
  20 please try upgrading to the latest version from CVS first:
  21
  22   export CVS_RSH=ssh
  23   cvs -z3 -d :ext:anoncvs@savannah.gnu.org:/cvsroot/libtool co libtool
  24   cd libtool
  25   ./bootstrap
  26
  27 The `bootstrap' script sets up the source directory for you to hack, though
  28 it may take quite some time to run.  To use it, you need a recent (maybe yet
  29 to be released) version of both Autoconf and Automake.  If you don't
  30 intend to run the test suite, you can speed up the `bootstrap' step by
  31 an order of magnitude if you call it like this instead:
  32
  33   reconfdirs=. ./bootstrap
  34
  35 If your bug is not fixed in the latest version, please send a full
  36 report to <bug-libtool@gnu.org>, including the information from the end
  37 of the help message given by `./libtool --help', and the verbose output
  38 of any failed test groups (as described below).
  39
  40
  41 3. The Test Suite
  42 =================
  43
  44 Libtool comes with an integrated set of tests to check that your build
  45 is sane.  You can run the entire suite like this:
  46
  47   make check
  48
  49 The tests run in groups in the various demo subdirectories, so if one
  50 of the tests early in a group FAILs, the rest of the tests in that
  51 group will be SKIPPED.  If you see a FAIL further into a group, even
  52 if a test with the same name PASSes in another test group, you need to
  53 take note of the name of the first test in the group if you want to
  54 rerun the group with FAILures to get verbose output.
  55
  56 To run a test group in isolation (say, you think you have fixed a bug,
  57 but don't want to rerun the entire suite), you can do it like this:
  58
  59   make check TESTS='cdemo-static.test cdemo-make.test cdemo-exec.test'
  60
  61 Providing that you have a FAIL from the most recent group from a
  62 particular demo directory (like the cdemo-static.test group above), you
  63 can explore the state of the directory to help with debugging.
  64
  65 If you wish to report a test group failure to the libtool list, you need
  66 to send the verbose output of the FAILing group, along with the
  67 information from the end of `$(top_builddir)/libtool --help' to the bug
  68 report mailing list, <bug-libtool@gnu.org> with a subject line that
  69 includes the string `[TEST FAILURE]'.  From a bourne compatible shell,
  70 you can generate verbose test output like this:
  71
  72   VERBOSE=yes make check \
  73   TESTS='cdemo-static.test cdemo-make.test cdemo-exec.test' \
  74   | tee cdemo-static-group.log
  75
  76 In order to enable debug shell tracing, use VERBOSE=debug
  77 instead of VERBOSE=yes.
  78
  79 --
  80 Copyright (C) 2004 Free Software Foundation, Inc.
  81
  82 The canonical source of this file is maintained with the
  83 GNU Libtool package.  Report bugs to bug-libtool@gnu.org.
  84
  85 GNU Libtool is free software; you can redistribute it and/or
  86 modify it under the terms of the GNU General Public License as
  87 published by the Free Software Foundation; either version 2
  88 of the License, or (at your option) any later version.
  89
  90 As a special exception to the GNU General Public License,
  91 if you distribute this file as part of a program or library that
  92 is built using GNU libtool, you may include it under the same
  93 distribution terms that you use for the rest of that program.
  94
  95 GNU Libtool is distributed in the hope that it will be useful,
  96 but WITHOUT ANY WARRANTY; without even the implied warranty of
  97 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  98 General Public License for more details.
  99
 100 You should have received a copy of the GNU General Public License
 101 along with GNU Libtool; if not, write to the Free Software
 102 Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 103 02110-1301  USA
 104
 105
 106 Local Variables:
 107 mode: text
 108 fill-column: 72
 109 End: