* NEWS: Update wording to say merely "should" for AS_DIRNAME
[autoconf.git] / README
bloba5db711388f0548c2f801d538b56bc16e28a76c5
1 -*- text -*-
3 Autoconf
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.
13 Producing configuration scripts using Autoconf requires GNU M4 and
14 Perl.  You must install GNU M4 (version 1.4.3 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.).
20 You can get GNU M4 1.4.3 here:
22 ftp://ftp.gnu.org/gnu/m4/m4-1.4.3.tar.gz
24 The file INSTALL should be distributed with packages that use
25 Autoconf-generated configure scripts and Makefiles that conform to the
26 GNU coding standards.  The package's README can just give an overview
27 of the package, where to report bugs, and a pointer to INSTALL for
28 instructions on compilation and installation.  This removes the need
29 to maintain many similar sets of installation instructions.
31 Be sure to read BUGS (especially if this version is not an official
32 release) and INSTALL.
34 Mail suggestions to autoconf@gnu.org, report bugs to
35 bug-autoconf@gnu.org, and submit patches to autoconf-patches@gnu.org.
36 Always include the Autoconf version number, which you can get by
37 running `autoconf --version'.  Archives of bug-autoconf@gnu.org can be
38 found in <http://lists.gnu.org/archive/html/bug-autoconf/>, and
39 similarly for the other mailing lists.
41 -----
43 Copyright (C) 1992, 1993, 1994, 1998, 2000, 2001, 2002, 2003, 2004,
44 2005 Free Software Foundation, Inc.
46 This file is part of GNU Autoconf.
48 GNU Autoconf is free software; you can redistribute it and/or modify
49 it under the terms of the GNU General Public License as published by
50 the Free Software Foundation; either version 2, or (at your option)
51 any later version.
53 GNU Autoconf is distributed in the hope that it will be useful,
54 but WITHOUT ANY WARRANTY; without even the implied warranty of
55 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
56 GNU General Public License for more details.
58 You should have received a copy of the GNU General Public License
59 along with GNU Autoconf; see the file COPYING.  If not, write to
60 the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
61 Boston, MA 02110-1301, USA.