DOC HOME SITE MAP MAN PAGES GNU INFO SEARCH PRINT BOOK
 

(autocf21.info.gz) Top

Info Catalog (dir) Top (dir) Top (autocf21.info.gz) Introduction
 
    This file documents the GNU Autoconf package for creating scripts to
 configure source code packages using templates and an `m4' macro
 package.  This is edition 2.13, for Autoconf version 2.13.
 

Menu

 
* Introduction                Autoconf's purpose, strengths, and weaknesses.
* Making configure Scripts    How to organize and produce Autoconf scripts.
* Setup                       Initialization and output.
* Existing Tests              Macros that check for particular features.
* Writing Tests               How to write new feature checks.
* Results                     What to do with results from feature checks.
* Writing Macros              Adding new macros to Autoconf.
* Manual Configuration        Selecting features that can't be guessed.
* Site Configuration          Local defaults for `configure'.
* Invoking configure          How to use the Autoconf output.
* Invoking config.status      Recreating a configuration.
* Questions                   Questions about Autoconf, with answers.
* Upgrading                   Tips for upgrading from version 1.
* History                     History of Autoconf.
* Old Macro Names             Backward compatibility macros.
* Environment Variable Index  Index of environment variables used.
* Output Variable Index       Index of variables set in output files.
* Preprocessor Symbol Index   Index of C preprocessor symbols defined.
* Macro Index                 Index of Autoconf macros.
 
  --- The Detailed Node Listing ---
 
 Making `configure' Scripts
 
* Writing configure.in        What to put in an Autoconf input file.
* Invoking autoscan           Semi-automatic `configure.in' writing.
* Invoking ifnames            Listing the conditionals in source code.
* Invoking autoconf           How to create configuration scripts.
* Invoking autoreconf         Remaking multiple `configure' scripts.
 
 Initialization and Output Files
 
* Input                       Where Autoconf should find files.
* Output                      Creating output files.
* Makefile Substitutions      Using output variables in `Makefile's.
* Configuration Headers       Creating a configuration header file.
* Subdirectories              Configuring independent packages together.
* Default Prefix              Changing the default installation prefix.
* Versions                    Version numbers in `configure'.
 
 Substitutions in Makefiles
 
* Preset Output Variables     Output variables that are always set.
* Build Directories           Supporting multiple concurrent compiles.
* Automatic Remaking          Makefile rules for configuring.
 
 Configuration Header Files
 
* Header Templates            Input for the configuration headers.
* Invoking autoheader         How to create configuration templates.
 
 Existing Tests
 
* Alternative Programs        Selecting between alternative programs.
* Libraries                   Library archives that might be missing.
* Library Functions           C library functions that might be missing.
* Header Files                Header files that might be missing.
* Structures                  Structures or members that might be missing.
* Typedefs                    `typedef's that might be missing.
* C Compiler Characteristics
* Fortran 77 Compiler Characteristics
* System Services             Operating system services.
* UNIX Variants               Special kludges for specific UNIX variants.
 
 Alternative Programs
 
* Particular Programs         Special handling to find certain programs.
* Generic Programs            How to find other programs.
 
 Library Functions
 
* Particular Functions        Special handling to find certain functions.
* Generic Functions           How to find other functions.
 
 Header Files
 
* Particular Headers          Special handling to find certain headers.
* Generic Headers             How to find other headers.
 
 Typedefs
 
* Particular Typedefs         Special handling to find certain types.
* Generic Typedefs            How to find other types.
 
 Writing Tests
 
* Examining Declarations      Detecting header files and declarations.
* Examining Syntax            Detecting language syntax features.
* Examining Libraries         Detecting functions and global variables.
* Run Time                    Testing for run-time features.
* Portable Shell              Shell script portability pitfalls.
* Testing Values and Files    Checking strings and files.
* Multiple Cases              Tests for several possible values.
* Language Choice             Selecting which language to use for testing.
 
 Checking Run Time Behavior
 
* Test Programs               Running test programs.
* Guidelines                  General rules for writing test programs.
* Test Functions              Avoiding pitfalls in test programs.
 
 Results of Tests
 
* Defining Symbols            Defining C preprocessor symbols.
* Setting Output Variables    Replacing variables in output files.
* Caching Results             Speeding up subsequent `configure' runs.
* Printing Messages           Notifying users of progress or problems.
 
 Caching Results
 
* Cache Variable Names        Shell variables used in caches.
* Cache Files                 Files `configure' uses for caching.
 
 Writing Macros
 
* Macro Definitions           Basic format of an Autoconf macro.
* Macro Names                 What to call your new macros.
* Quoting                     Protecting macros from unwanted expansion.
* Dependencies Between Macros  What to do when macros depend on other macros.
 
 Dependencies Between Macros
 
* Prerequisite Macros         Ensuring required information.
* Suggested Ordering          Warning about possible ordering problems.
* Obsolete Macros             Warning about old ways of doing things.
 
 Manual Configuration
 
* Specifying Names            Specifying the system type.
* Canonicalizing              Getting the canonical system type.
* System Type Variables       Variables containing the system type.
* Using System Type           What to do with the system type.
 
 Site Configuration
 
* External Software           Working with other optional software.
* Package Options             Selecting optional features.
* Site Details                Configuring site details.
* Transforming Names          Changing program names when installing.
* Site Defaults               Giving `configure' local defaults.
 
 Transforming Program Names When Installing
 
* Transformation Options      `configure' options to transform names.
* Transformation Examples     Sample uses of transforming names.
* Transformation Rules        `Makefile' uses of transforming names.
 
 Running `configure' Scripts
 
* Basic Installation          Instructions for typical cases.
* Compilers and Options       Selecting compilers and optimization.
* Multiple Architectures      Compiling for multiple architectures at once.
* Installation Names          Installing in different directories.
* Optional Features           Selecting optional features.
* System Type                 Specifying the system type.
* Sharing Defaults            Setting site-wide defaults for `configure'.
* Operation Controls          Changing how `configure' runs.
 
 Questions About Autoconf
 
* Distributing                Distributing `configure' scripts.
* Why GNU m4                  Why not use the standard `m4'?
* Bootstrapping               Autoconf and GNU `m4' require each other?
* Why Not Imake               Why GNU uses `configure' instead of Imake.
 
 Upgrading From Version 1
 
* Changed File Names          Files you might rename.
* Changed Makefiles           New things to put in `Makefile.in'.
* Changed Macros              Macro calls you might replace.
* Invoking autoupdate         Replacing old macro names in `configure.in'.
* Changed Results             Changes in how to check test results.
* Changed Macro Writing       Better ways to write your own macros.
 
 History of Autoconf
 
* Genesis                     Prehistory and naming of `configure'.
* Exodus                      The plagues of `m4' and Perl.
* Leviticus                   The priestly code of portability arrives.
* Numbers                     Growth and contributors.
* Deuteronomy                 Approaching the promises of easy configuration.
 
Info Catalog (dir) Top (dir) Top (autocf21.info.gz) Introduction
automatically generated byinfo2html