README

   1 This is Automake, a Makefile generator.  It was inspired by the 4.4BSD
   2 make and include files, but aims to be portable and to conform to the
   3 GNU Coding Standards for Makefile variables and targets.
   4
   5 Automake is a Perl script.  The input files are called Makefile.am.
   6 The output files are called Makefile.in; they are intended for use
   7 with Autoconf.  Automake requires certain things to be done in your
   8 configure.ac.
   9
  10 Variable assignment lines in Makefile.am pull in defaults from various
  11 little *.am files.
  12
  13 To use Automake, replace your Makefile.in files with Makefile.am
  14 files.  Read the documentation to see what to do.
  15
  16 This package also includes the "aclocal" program.  aclocal is a
  17 program to generate an `aclocal.m4' based on the contents of
  18 `configure.ac'.  It is useful as an extensible, maintainable mechanism
  19 for augmenting autoconf.  It is intended that other package authors
  20 will write m4 macros which can be automatically used by aclocal.
  21
  22 Automake has a test suite.  Use
  23
  24         make check
  25
  26 to run it.  Capture its output in case of failing tests.  For more
  27 information, you can influence testing with the variables VERBOSE,
  28 MAKE, TESTS, keep_testdirs.  So for example, to run tests/check.test
  29 verbosely using gmake and to inspect the test directory afterwards,
  30 enter the tests directory and use
  31
  32         env VERBOSE=yes TESTS=check.test keep_testdirs=yes MAKE=gmake \
  33           gmake -e check
  34
  35 Automake has a page on the web.  See:
  36
  37         http://sources.redhat.com/automake/
  38
  39 The mailing list automake@gnu.org is for discussion of Automake and
  40 its interactions with other configuration/portability tools like
  41 Autoconf or Libtool.  Write to automake-request@gnu.org if you want to
  42 join.
  43
  44 Mail suggestions and bug reports to bug-automake@gnu.org, patches
  45 to automake-patches@gnu.org.
  46
  47 New releases are announced to autotools-announce@gnu.org.  Write to
  48 autotools-announce-request@gnu.org if you want to receive them.
  49
  50 -----
  51
  52 Copyright (C) 1994, 1995, 1996, 1997, 1998, 2001, 2003
  53   Free Software Foundation, Inc.
  54
  55 This program is free software; you can redistribute it and/or modify
  56 it under the terms of the GNU General Public License as published by
  57 the Free Software Foundation; either version 3, or (at your option)
  58 any later version.
  59
  60 This program is distributed in the hope that it will be useful,
  61 but WITHOUT ANY WARRANTY; without even the implied warranty of
  62 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  63 GNU General Public License for more details.
  64
  65 You should have received a copy of the GNU General Public License
  66 along with this program.  If not, see <http://www.gnu.org/licenses/>.