Autoconf

Autoconf

Original author(s)	David Mackenzie
Developer(s)	The GNU Project
Initial release	1991

Stable release	2.69 / 24 April 2012 (2012-04-24)

Repository	ftp.gnu.org/gnu/autoconf/
Operating system	Cross-platform
Type	Programming tool
License	GNU GPL
Website	www.gnu.org/software/autoconf/

GNU Autoconf is a tool for producing configure scripts for building, installing and packaging software on computer systems where a Bourne shell is available.

Autoconf is agnostic about the programming languages used, but it is often used for projects using C, C++, Fortran, Fortran 77, Erlang or Objective-C.

A configure script configures a software package for installation on a particular target system. After running a series of tests on the target system, the configure script generates header files and a makefile from templates, thus customizing the software package for the target system. Together with Automake and Libtool, Autoconf forms the GNU Build System, which comprises several other tools, notably Autoheader.

Usage overview

Flow diagram of autoconf and automake. Note that "configure.ac" was named "configure.in" in early versions of autoconf.

The developer specifies the desired behaviour of the configure script by writing a list of instructions in the GNU m4 language in a file called "configure.ac". A library of pre-defined m4 macros is available to describe common configure script instructions. Autoconf transforms the instructions in "configure.ac" into a portable configure script. The system that will be doing the building need not have autoconf installed: autoconf is needed only to build the configure script, that is usually shipped with the software.

configure.ac format

The GNU Autoconf manual suggests the following format for the configure.ac file:

AC_PREREQ(version): The AC_PREREQ(version) macro can be used to ensure that a recent enough version of the autoconf program is available to process the configure.ac file
AC_INIT(package, version, bug-report-address): This macro is required in every configure.ac file. It specifies the name and version of the software package for which to generate a configure script and the email address of the developer.
information on the package
checks for programs
checks for libraries
checks for header files
checks for types
checks for structures
checks for compiler characteristics
checks for library functions
checks for system services
AC_CONFIG_FILES([file...])
AC_OUTPUT

History

Autoconf was begun in the summer of 1991 by David Mackenzie to support his work at the Free Software Foundation. In the subsequent years it grew to include enhancements from a variety of authors and became the most widely used build configuration system for writing portable free or open-source software.

Approach

Autoconf is similar to the Metaconfig package used by Perl. The imake system formerly used by the X Window System (up to X11R6.9) is closely related, but has a different philosophy.

The Autoconf approach to portability is to test for features, not for versions. For example, the native C compiler on SunOS 4 did not support ISO C. However, it is possible for the user or administrator to have installed an ISO C-compliant compiler. A pure version-based approach would not detect the presence of the ISO C compiler, but a feature-testing approach would be able to discover the ISO C compiler the user had installed. The rationale of this approach is to gain the following advantages:

the configure script can get reasonable results on newer or unknown systems
it allows administrators to customize their machines and have the configure script take advantage of the customizations
there is no need to keep track of minute details of versions, patch numbers, etc., to figure out whether a particular feature is supported or not

Criticism

There is some criticism that states that Autoconf uses dated technologies, has a lot of legacy restrictions, and complicates simple scenarios unnecessarily for the author of configure.ac scripts. In particular, often cited weak points of Autoconf are:

General complexity of used architecture, most projects use multiple repetitions.^[1]
Generated 'configure' is written in Bourne shell and thus Makefile generation is slow.
Some people think that 'configure' scripts generated by autoconf provide only manual-driven command-line interface without any standardization.^[2] While it is true that some developers do not respect common conventions, such conventions do exist and are widely used.^[3]
M4 is unusual and unknown to many developers. Developers will need to learn it to extend autoconf with non-standard checks.^[2]
Weak backward and forward compatibility requires a wrapper script.^[4]
Autoconf-generated scripts are usually large and rather complex. Although they produce extensive logging, debugging them can still be difficult.

Due to these limitations, several projects that used GNU Build System switched to different build systems, such as CMake and SCons.^[1]^[5]

References

1 2 Neundorf, Alexander (2006-06-21). "Why the KDE project switched to CMake -- and how".
1 2 McCall, Andrew (2003-06-21). "Stop the autoconf insanity! Why we need a new build system".
↑ "GNU Coding Standards".
↑ Dickey, Thomas. "why i still use autoconf 2.13".
↑ http://www.blender.org/development/release-logs/blender-233/build-systems/

External links

GNU Project
History	GNU Manifesto Free Software Foundation Europe India Latin America History of free software
Licenses	GNU General Public License GNU Lesser General Public License GNU Affero General Public License GNU Free Documentation License GPL linking exception
Software	GNU (variants) Hurd Linux-libre glibc Bash coreutils findutils Build System GCC binutils GDB GRUB GNOME GNUstep GIMP GNU Emacs GNU TeXmacs GNU Octave GNU R GSL GMP GNU Electric GNU Archimedes GNUnet GNU Privacy Guard Gnuzilla (IceCat) GNU Health GNUmed GNU LilyPond GNU Go GNU Chess Gnash Guix Guix System Distribution more...
Public speakers	Alexandre Oliva Benjamin Mako Hill Bradley M. Kuhn Eben Moglen Federico Heinz Georg C. F. Greve John Sullivan Loïc Dachary Matt Lee Nagarjuna G. Ricardo Galli Richard Stallman Robert J. Chassell
Other topics	GNU/Linux naming controversy Revolution OS Free Software Foundation anti-Windows campaigns Defective by Design

This article is issued from Wikipedia. The text is licensed under Creative Commons - Attribution - Sharealike. Additional terms may apply for the media files.