Name Date Size

..05-Sep-20204 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/H31-Aug-20204 KiB

BUGSH A D28-Aug-20201.4 KiB

build-aux/H11-Sep-20204 KiB

cfg.mkH A D11-Sep-20203.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 D26-Aug-20207.2 KiB

COPYINGH A D10-Jul-202017.6 KiB

COPYING.EXCEPTIONH A D10-Jul-20201.8 KiB

COPYINGv3H A D10-Jul-202034.3 KiB

doc/H18-Sep-20204 KiB

GNUmakefileH A D04-Aug-20204.5 KiB

HACKINGH A D30-Jun-20206.1 KiB

lib/H18-Aug-20204 KiB

m4/H03-Sep-20204 KiB

maint.mkH A D30-Jun-202064.8 KiB

Makefile.amH A D21-Aug-20206.3 KiB

man/H21-Aug-20204 KiB

NEWSH A D18-Aug-202089.2 KiB

READMEH A D02-Jan-20202.7 KiB

README-alphaH A D02-Jan-20201.1 KiB

README-hackingH A D13-Jul-20205.2 KiB

tests/H28-Aug-20204 KiB

THANKSH A D02-Jan-202021.2 KiB

TODOH A D06-Aug-202023 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.62+ <https://www.gnu.org/software/autoconf/>
18- Automake 1.11+ <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.11+ <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-xz" or "make distcheck":
26
27- Gzip <https://www.gnu.org/software/gzip/>
28- Tar <https://www.gnu.org/software/tar/>
29- XZ Utils <https://tukaani.org/xz/>
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 distclean
85  $ ./configure
86  $ make check
87
88At this point, there should be no difference between your local copy,
89and the GIT master copy:
90
91  $ git diff
92
93should output no difference.
94
95The testsuite is run by 'make check'.  You may find it useful to run a
96subset of the testsuite; for example, all tests with the 'm4sugar'
97keyword as well as test 10:
98
99  $ make check TESTSUITEFLAGS='10 -k m4sugar'
100
101You can pass options to configure scripts invoked by the testsuite by
102setting the configure_options variable:
103
104  $ make check TESTSUITEFLAGS='configure_options="CC=gcc-2.95"'
105
106* Submitting patches
107
108All patches should be submitted to <autoconf-patches@gnu.org> for
109review, in context or unified diff format against the latest sources.
110In most cases, a patch should include a test case, to ensure that
111regressions do not creep back in.  Remember to add documentation and a
112NEWS entry for anything that is visible to the user.
113
114If your change is significant (i.e., if it adds more than ~10 lines),
115then you'll have to have a copyright assignment on file with the FSF.
116Since that involves first an email exchange between you and the FSF,
117and then the exchange (FSF to you, then back) of an actual sheet of paper
118with your signature on it, and finally, some administrative processing
119in Boston, the process can take a few weeks.
120
121The forms to choose from are in gnulib's doc/Copyright/ directory.
122If you want to assign a single change, you should use the file,
123doc/Copyright/request-assign.changes:
124
125    https://git.sv.gnu.org/gitweb/?p=gnulib.git;a=blob;f=doc/Copyright/request-assign.changes;hb=HEAD
126
127If you would like to assign past and future autoconf work,
128you'd use doc/Copyright/request-assign.future:
129
130    https://git.sv.gnu.org/gitweb/?p=gnulib.git;a=blob;f=doc/Copyright/request-assign.future;hb=HEAD
131
132Enjoy!
133
134-----
135
136Copyright (C) 2002-2017, 2020 Free Software Foundation, Inc.
137
138Copying and distribution of this file, with or without modification,
139are permitted in any medium without royalty provided the copyright
140notice and this notice are preserved.  This file is offered as-is,
141without warranty of any kind.
142