Autoconf

Creating Automatic Configuration Scripts

Edition 2.52, for Autoconf version 2.52

17 July 2001

• Introduction
• The GNU build system
  • Automake
  • Libtool
  • Pointers
• Making configure Scripts
  • Writing `configure.ac'
    • A Shell Script Compiler
    • The Autoconf Language
    • Standard `configure.ac' Layout
  • Using autoscan to Create `configure.ac'
  • Using ifnames to List Conditionals
  • Using autoconf to Create configure
  • Using autoreconf to Update configure Scripts
• Initialization and Output Files
  • Notices in configure
  • Finding configure Input
  • Outputting Files
  • Taking Configuration Actions
  • Creating Configuration Files
  • Substitutions in Makefiles
    • Preset Output Variables
    • Installation Directory Variables
    • Build Directories
    • Automatic Remaking
  • Configuration Header Files
    • Configuration Header Templates
    • Using autoheader to Create `config.h.in'
    • Autoheader Macros
  • Running Arbitrary Configuration Commands
  • Creating Configuration Links
  • Configuring Other Packages in Subdirectories
  • Default Prefix
• Existing Tests
  • Common Behavior
    • Standard Symbols
    • Default Includes
  • Alternative Programs
    • Particular Program Checks
    • Generic Program and File Checks
  • Files
  • Library Files
  • Library Functions
    • Portability of Classical Functions
    • Particular Function Checks
    • Generic Function Checks
  • Header Files
    • Particular Header Checks
    • Generic Header Checks
  • Declarations
    • Particular Declaration Checks
    • Generic Declaration Checks
  • Structures
    • Particular Structure Checks
    • Generic Structure Checks
  • Types
    • Particular Type Checks
    • Generic Type Checks
  • Compilers and Preprocessors
    • Generic Compiler Characteristics
    • C Compiler Characteristics
    • C++ Compiler Characteristics
    • Fortran 77 Compiler Characteristics
  • System Services
  • UNIX Variants
• Writing Tests
  • Examining Declarations
  • Examining Syntax
  • Examining Libraries
  • Checking Run Time Behavior
    • Running Test Programs
    • Guidelines for Test Programs
    • Test Functions
  • Systemology
  • Multiple Cases
  • Language Choice
• Results of Tests
  • Defining C Preprocessor Symbols
  • Setting Output Variables
  • Caching Results
    • Cache Variable Names
    • Cache Files
    • Cache Checkpointing
  • Printing Messages
• Programming in M4
  • M4 Quotation
    • Active Characters
    • One Macro Call
    • Quotation and Nested Macros
    • Quadrigraphs
    • Quotation Rule Of Thumb
  • Programming in M4sugar
    • Redefined M4 Macros
    • Forbidden Patterns
• Writing Autoconf Macros
  • Macro Definitions
  • Macro Names
  • Reporting Messages
  • Dependencies Between Macros
    • Prerequisite Macros
    • Suggested Ordering
  • Obsoleting Macros
  • Coding Style
• Portable Shell Programming
  • Shellology
  • Here-Documents
  • File Descriptors
  • File System Conventions
  • Shell Substitutions
  • Assignments
  • Special Shell Variables
  • Limitations of Shell Builtins
  • Limitations of Usual Tools
  • Limitations of Make
• Manual Configuration
  • Specifying the System Type
  • Getting the Canonical System Type
  • Using the System Type
• Site Configuration
  • Working With External Software
  • Choosing Package Options
  • Making Your Help Strings Look Pretty
  • Configuring Site Details
  • Transforming Program Names When Installing
    • Transformation Options
    • Transformation Examples
    • Transformation Rules
  • Setting Site Defaults
• Running configure Scripts
  • Basic Installation
  • Compilers and Options
  • Compiling For Multiple Architectures
  • Installation Names
  • Optional Features
  • Specifying the System Type
  • Sharing Defaults
  • Environment Variables
  • configure Invocation
• Recreating a Configuration
• Obsolete Constructs
  • Obsolete `config.status' Invocation
  • `acconfig.h'
  • Using autoupdate to Modernize `configure.ac'
  • Obsolete Macros
  • Upgrading From Version 1
    • Changed File Names
    • Changed Makefiles
    • Changed Macros
    • Changed Results
    • Changed Macro Writing
  • Upgrading From Version 2.13
    • Changed Quotation
    • New Macros
• Questions About Autoconf
  • Distributing configure Scripts
  • Why Require GNU M4?
  • How Can I Bootstrap?
  • Why Not Imake?
• History of Autoconf
  • Genesis
  • Exodus
  • Leviticus
  • Numbers
  • Deuteronomy
• Environment Variable Index
• Output Variable Index
• Preprocessor Symbol Index
• Autoconf Macro Index
• M4 Macro Index
• Concept Index

This document was generated on 24 September 2001 using the texi2html translator version 1.54.