Autoconf

Creating Automatic Configuration Scripts

Edition 2.13, for Autoconf version 2.13

December 1998

• 1 Introduction
• 2 Making configure Scripts
  • 2.1 Writing `configure.in'
  • 2.2 Using autoscan to Create `configure.in'
  • 2.3 Using ifnames to List Conditionals
  • 2.4 Using autoconf to Create configure
  • 2.5 Using autoreconf to Update configure Scripts
• 3 Initialization and Output Files
  • 3.1 Finding configure Input
  • 3.2 Creating Output Files
  • 3.3 Substitutions in Makefiles
    • 3.3.1 Preset Output Variables
    • 3.3.2 Build Directories
    • 3.3.3 Automatic Remaking
  • 3.4 Configuration Header Files
    • 3.4.1 Configuration Header Templates
    • 3.4.2 Using autoheader to Create `config.h.in'
  • 3.5 Configuring Other Packages in Subdirectories
  • 3.6 Default Prefix
  • 3.7 Version Numbers in configure
• 4 Existing Tests
  • 4.1 Alternative Programs
    • 4.1.1 Particular Program Checks
    • 4.1.2 Generic Program and File Checks
  • 4.2 Library Files
  • 4.3 Library Functions
    • 4.3.1 Particular Function Checks
    • 4.3.2 Generic Function Checks
  • 4.4 Header Files
    • 4.4.1 Particular Header Checks
    • 4.4.2 Generic Header Checks
  • 4.5 Structures
  • 4.6 Typedefs
    • 4.6.1 Particular Typedef Checks
    • 4.6.2 Generic Typedef Checks
  • 4.7 C Compiler Characteristics
  • 4.8 Fortran 77 Compiler Characteristics
  • 4.9 System Services
  • 4.10 UNIX Variants
• 5 Writing Tests
  • 5.1 Examining Declarations
  • 5.2 Examining Syntax
  • 5.3 Examining Libraries
  • 5.4 Checking Run Time Behavior
    • 5.4.1 Running Test Programs
    • 5.4.2 Guidelines for Test Programs
    • 5.4.3 Test Functions
  • 5.5 Portable Shell Programming
  • 5.6 Testing Values and Files
  • 5.7 Multiple Cases
  • 5.8 Language Choice
• 6 Results of Tests
  • 6.1 Defining C Preprocessor Symbols
  • 6.2 Setting Output Variables
  • 6.3 Caching Results
    • 6.3.1 Cache Variable Names
    • 6.3.2 Cache Files
  • 6.4 Printing Messages
• 7 Writing Macros
  • 7.1 Macro Definitions
  • 7.2 Macro Names
  • 7.3 Quoting
  • 7.4 Dependencies Between Macros
    • 7.4.1 Prerequisite Macros
    • 7.4.2 Suggested Ordering
    • 7.4.3 Obsolete Macros
• 8 Manual Configuration
  • 8.1 Specifying the System Type
  • 8.2 Getting the Canonical System Type
  • 8.3 System Type Variables
  • 8.4 Using the System Type
• 9 Site Configuration
  • 9.1 Working With External Software
  • 9.2 Choosing Package Options
  • 9.3 Configuring Site Details
  • 9.4 Transforming Program Names When Installing
    • 9.4.1 Transformation Options
    • 9.4.2 Transformation Examples
    • 9.4.3 Transformation Rules
  • 9.5 Setting Site Defaults
• 10 Running configure Scripts
  • 10.1 Basic Installation
  • 10.2 Compilers and Options
  • 10.3 Compiling For Multiple Architectures
  • 10.4 Installation Names
  • 10.5 Optional Features
  • 10.6 Specifying the System Type
  • 10.7 Sharing Defaults
  • 10.8 Operation Controls
• 11 Recreating a Configuration
• 12 Questions About Autoconf
  • 12.1 Distributing configure Scripts
  • 12.2 Why Require GNU m4?
  • 12.3 How Can I Bootstrap?
  • 12.4 Why Not Imake?
• 13 Upgrading From Version 1
  • 13.1 Changed File Names
  • 13.2 Changed Makefiles
  • 13.3 Changed Macros
  • 13.4 Using autoupdate to Modernize configure
  • 13.5 Changed Results
  • 13.6 Changed Macro Writing
• 14 History of Autoconf
  • 14.1 Genesis
  • 14.2 Exodus
  • 14.3 Leviticus
  • 14.4 Numbers
  • 14.5 Deuteronomy
• 15 Old Macro Names
• Environment Variable Index
• Output Variable Index
• Preprocessor Symbol Index
• Macro Index

This document was generated on 21 May 2000 using the texi2html translator version 1.51a.