README

   1 -*- text -*-
   2
   3 Autoconf
   4
   5 Autoconf is an extensible package of M4 macros that produce shell
   6 scripts to automatically configure software source code packages.
   7 These scripts can adapt the packages to many kinds of UNIX-like
   8 systems without manual user intervention.  Autoconf creates a
   9 configuration script for a package from a template file that lists the
  10 operating system features that the package can use, in the form of M4
  11 macro calls.
  12
  13 Producing configuration scripts using Autoconf requires GNU M4 and
  14 Perl.  You must install GNU M4 (version 1.4 or later) and Perl (5.005_03
  15 or later) before configuring Autoconf, so that Autoconf's configure
  16 script can find them.  The configuration scripts produced by Autoconf
  17 are self-contained, so their users do not need to have Autoconf (or
  18 GNU M4, Perl etc.).
  19
  20 Vanilla GNU m4 1.4 has some serious bugs, so we recommend using m4 1.4
  21 as patched by the standard GNU/Linux distributions.  If you're
  22 building GNU m4 1.4 from scratch we suggest using 1.4.2 or later.
  23 You can get 1.4.2 here:
  24
  25 ftp://ftp.gnu.org/gnu/m4/m4-1.4.2.tar.gz
  26
  27 The file INSTALL should be distributed with packages that use
  28 Autoconf-generated configure scripts and Makefiles that conform to the
  29 GNU coding standards.  The package's README can just give an overview
  30 of the package, where to report bugs, and a pointer to INSTALL for
  31 instructions on compilation and installation.  This removes the need
  32 to maintain many similar sets of installation instructions.
  33
  34 Be sure to read BUGS (especially if this version is not an official
  35 release) and INSTALL.
  36
  37 Mail suggestions to autoconf@gnu.org, report bugs to
  38 bug-autoconf@gnu.org, and submit patches to autoconf-patches@gnu.org.
  39 Always include the Autoconf version number, which you can get by
  40 running `autoconf --version'.  Archives of bug-autoconf@gnu.org can be
  41 found in <http://lists.gnu.org/archive/html/bug-autoconf/>, and
  42 similarly for the other mailing lists.
  43
  44 -----
  45
  46 Copyright (C) 1992, 1993, 1994, 1998, 2000, 2001, 2002, 2003, 2004
  47 Free Software Foundation, Inc.
  48
  49 This file is part of GNU Autoconf.
  50
  51 GNU Autoconf is free software; you can redistribute it and/or modify
  52 it under the terms of the GNU General Public License as published by
  53 the Free Software Foundation; either version 2, or (at your option)
  54 any later version.
  55
  56 GNU Autoconf is distributed in the hope that it will be useful,
  57 but WITHOUT ANY WARRANTY; without even the implied warranty of
  58 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  59 GNU General Public License for more details.
  60
  61 You should have received a copy of the GNU General Public License
  62 along with GNU Autoconf; see the file COPYING.  If not, write to
  63 the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  64 Boston, MA 02111-1307, USA.