Name Date Size

..29-Nov-20194 KiB

.gitattributesH A D13-Aug-2017417

.gitignoreH A D13-Aug-20171.1 KiB

.prev-versionH A D13-Aug-20175

.x-update-copyrightH A D13-Aug-2017381

AUTHORSH A D02-Jan-20207.9 KiB

bin/H02-Jan-20204 KiB

BUGSH A D02-Jan-20201.6 KiB

build-aux/H17-Sep-20174 KiB

cfg.mkH A D02-Jan-20205.6 KiB

ChangeLog.0H A D17-Sep-201712.6 KiB

ChangeLog.1H A D17-Sep-201767.2 KiB

ChangeLog.2H A D17-Sep-2017420 KiB

ChangeLog.3H A D23-Sep-2017835.1 KiB

configure.acH A D02-Jan-20206.5 KiB

COPYINGH A D13-Aug-201717.6 KiB

COPYING.EXCEPTIONH A D17-Sep-20171.8 KiB

COPYINGv3H A D13-Aug-201734.3 KiB

doc/H02-Jan-20204 KiB

GNUmakefileH A D17-Sep-20174.5 KiB

HACKINGH A D02-Jan-20206.2 KiB

lib/H02-Jan-20204 KiB

m4/H02-Jan-20204 KiB

maint.mkH A D02-Jan-202062.4 KiB

Makefile.amH A D02-Jan-20205.9 KiB

man/H02-Jan-20204 KiB

NEWSH A D02-Jan-202085.4 KiB

READMEH A D02-Jan-20202.7 KiB

README-alphaH A D02-Jan-20201.1 KiB

README-hackingH A D02-Jan-20205.2 KiB

tests/H02-Jan-20204 KiB

THANKSH A D02-Jan-202021.2 KiB

TODOH A D02-Jan-202022.6 KiB

README

1-*- text -*-
2
3Autoconf
4
5Autoconf is an extensible package of M4 macros that produce shell
6scripts to automatically configure software source code packages.
7These scripts can adapt the packages to many kinds of UNIX-like
8systems without manual user intervention.  Autoconf creates a
9configuration script for a package from a template file that lists the
10operating system features that the package can use, in the form of M4
11macro calls.
12
13Producing configuration scripts using Autoconf requires GNU M4 and
14Perl.  You should install GNU M4 (version 1.4.6 or later is required;
151.4.14 or later is recommended) and Perl (5.006 or later) before
16configuring Autoconf, so that Autoconf's configure script can find
17them.  The configuration scripts produced by Autoconf are
18self-contained, so their users do not need to have Autoconf (or GNU
19M4, Perl, etc.).
20
21You can get GNU M4 here:
22
23https://ftp.gnu.org/gnu/m4/
24
25The file INSTALL should be distributed with packages that use
26Autoconf-generated configure scripts and Makefiles that conform to the
27GNU coding standards.  The package's README can just give an overview
28of the package, where to report bugs, and a pointer to INSTALL for
29instructions on compilation and installation.  This removes the need
30to maintain many similar sets of installation instructions.
31
32Be sure to read BUGS and INSTALL.
33
34Mail suggestions to autoconf@gnu.org, report bugs to
35bug-autoconf@gnu.org, and submit patches to autoconf-patches@gnu.org.
36All changes can be tracked at the read-only autoconf-commit@gnu.org.
37Always include the Autoconf version number, which you can get by
38running `autoconf --version'.  Archives of bug-autoconf@gnu.org can be
39found in <https://lists.gnu.org/archive/html/bug-autoconf/>, and
40similarly for the other mailing lists.
41
42Licensing
43
44Autoconf is released under the General Public License version 3 (GPLv3+).
45Additionally, Autoconf includes a licensing exception in some of its
46source files; see the respective copyright notices for how your
47project is impacted by including scripts generated by Autoconf, and the
48COPYING.EXCEPTION file for the exception in terms of the Additional
49Permissions as described in section 7 of GPLv3.
50
51For more licensing information, see
52<https://www.gnu.org/licenses/gpl-faq.html> and
53<https://www.gnu.org/licenses/exceptions.html>.
54
55For any copyright year range specified as YYYY-ZZZZ in this package
56note that the range specifies every single year in that closed interval.
57
58-----
59
60Copyright (C) 1992-1994, 1998, 2000-2017, 2020 Free Software Foundation,
61Inc.
62
63Copying and distribution of this file, with or without modification,
64are permitted in any medium without royalty provided the copyright
65notice and this notice are preserved.  This file is offered as-is,
66without warranty of any kind.
67

README-alpha

1-*- text -*-
2
3This is a test release of this package.  Using it more or less
4implicitly signs you up to help us find whatever problems you report.
5
6You need up-to-date build tools.  To avoid some bootstrapping issues
7you may need to run the command "autoreconf -fvim" first, before
8running "configure".
9
10The documentation still needs more work.  Suggestions welcome.
11Patches even more welcome.
12
13Please send comments and problem reports about this test release to
14bug-autoconf@gnu.org.  This program will get better only if you report
15the problems you encounter.
16
17Please, *do not package this*, *do not distribute it* widely, it is
18not ready for full scale use.  Because it is not fully functional, if
19you distribute this package, we will be buried under bug reports from
20panicked users.  We don't have time to spend on this, and nor do the
21users.
22
23-----
24
25Copyright (C) 2000-2003, 2009-2017, 2020 Free Software Foundation, Inc.
26
27Copying and distribution of this file, with or without modification,
28are permitted in any medium without royalty provided the copyright
29notice and this notice are preserved.  This file is offered as-is,
30without warranty of any kind.
31

README-hacking

1-*- outline -*-
2
3These notes intend to help people working on the checked-out sources.
4These requirements do not apply when building from a distribution
5tarball.  Don't put this file into the distribution.  Don't mention it
6in the ChangeLog.  You may want to also see HACKING for
7maintainer-specific rules.
8
9* Requirements
10
11We've opted to keep only the highest-level sources in the GIT repository.
12This eases our maintenance burden, (fewer merges etc.), but imposes more
13requirements on anyone wishing to build from the just-checked-out sources.
14For example, you have to use recent stable versions of the maintainer
15tools we depend upon, including:
16
17- Autoconf 2.60+ <https://www.gnu.org/software/autoconf/>
18- Automake 1.10+ <https://www.gnu.org/software/automake/>
19- Help2man 1.29+ <https://www.gnu.org/software/help2man/>
20- M4 1.4.6+ <https://www.gnu.org/software/m4/>
21- Perl 5.006+ <https://www.cpan.org/>
22- Texinfo 4.8+ <https://www.gnu.org/software/texinfo/>
23
24The following are useful as well, if you want to be able to run commands
25like "make dist-lzma" or "make distcheck":
26
27- Gzip <https://www.gnu.org/software/gzip/>
28- Tar <https://www.gnu.org/software/tar/>
29- LZMA Utils 4.32+ <https://tukaani.org/lzma/>
30
31Although we try to keep the CVS mirror of the git repository usable,
32some of the tests in the testsuite will fail if git was not used to
33generate the version string.  Therefore, we recommend:
34
35- Git 1.4.4+ <https://git-scm.com/>
36
37You may find it useful to install the git-merge-changelog merge driver:
38https://git.sv.gnu.org/gitweb/?p=gnulib.git;a=blob;f=lib/git-merge-changelog.c
39
40then add the following to .git/config or ~/.gitconfig:
41[merge "merge-changelog"]
42	name = GNU ChangeLog merge driver
43	driver = git-merge-changelog %O %A %B
44[diff "texinfo"]
45	funcname = ^@node[\t ][\t ]*\\([^,][^,]*\\)
46
47Only building the initial full source tree will be a bit painful.
48Later, a plain `git pull && make' should be sufficient.
49
50If you want to test Autoconf on a machine without git, it may be
51easier to first bootstrap Autoconf on a different machine with git,
52run `make dist', and copy the tarball to the machine under test.  It
53should always be possible to create a self-contained tarball which
54does not rely on the bootstrap-only tools.
55
56* First GIT checkout
57
58You can get an anonymous copy of the source repository using any one
59of these three methods, although the CVS mirror is less tested:
60
61  $ git clone git://git.sv.gnu.org/autoconf
62  $ git clone https://git.sv.gnu.org/r/autoconf.git
63  $ cvs -d:pserver:anonymous@pserver.git.sv.gnu.org:/srv/git/autoconf.git \
64      co -d autoconf HEAD
65
66If you have a Savannah user name and commit rights to the Autoconf
67project, you should use this instead:
68
69  $ git clone <username>@git.sv.gnu.org:/srv/git/autoconf.git
70
71The next step is to generate files like configure and Makefile.in:
72
73  $ cd autoconf
74  $ autoreconf -vi
75
76Since we're building autoconf itself, and its tests are picky, the
77following procedure includes an extra step to ensure that some
78generated files are regenerated using the tools just built by "make"
79(if you use GNU make, the file GNUmakefile sets PATH for you):
80
81  $ ./configure
82  $ make
83  $ ( PATH=`pwd`/tests:$PATH; autoreconf -vi )
84  $ make check
85
86At this point, there should be no difference between your local copy,
87and the GIT master copy:
88
89  $ git diff
90
91should output no difference.
92
93The testsuite is run by 'make check'.  You may find it useful to run a
94subset of the testsuite; for example, all tests with the 'm4sugar'
95keyword as well as test 10:
96
97  $ make check TESTSUITEFLAGS='10 -k m4sugar'
98
99You can pass options to configure scripts invoked by the testsuite by
100setting the configure_options variable:
101
102  $ make check TESTSUITEFLAGS='configure_options="CC=gcc-2.95"'
103
104* Submitting patches
105
106All patches should be submitted to <autoconf-patches@gnu.org> for
107review, in context or unified diff format against the latest sources.
108In most cases, a patch should include a test case, to ensure that
109regressions do not creep back in.  Remember to add documentation and a
110NEWS entry for anything that is visible to the user.
111
112If your change is significant (i.e., if it adds more than ~10 lines),
113then you'll have to have a copyright assignment on file with the FSF.
114Since that involves first an email exchange between you and the FSF,
115and then the exchange (FSF to you, then back) of an actual sheet of paper
116with your signature on it, and finally, some administrative processing
117in Boston, the process can take a few weeks.
118
119The forms to choose from are in gnulib's doc/Copyright/ directory.
120If you want to assign a single change, you should use the file,
121doc/Copyright/request-assign.changes:
122
123    https://git.sv.gnu.org/gitweb/?p=gnulib.git;a=blob;f=doc/Copyright/request-assign.changes;hb=HEAD
124
125If you would like to assign past and future autoconf work,
126you'd use doc/Copyright/request-assign.future:
127
128    https://git.sv.gnu.org/gitweb/?p=gnulib.git;a=blob;f=doc/Copyright/request-assign.future;hb=HEAD
129
130Enjoy!
131
132-----
133
134Copyright (C) 2002-2017, 2020 Free Software Foundation, Inc.
135
136Copying and distribution of this file, with or without modification,
137are permitted in any medium without royalty provided the copyright
138notice and this notice are preserved.  This file is offered as-is,
139without warranty of any kind.
140