Autoconf

このファイルは、GNU Autoconfパッケージの説明書です。 GNU Autoconfパッケージは、テンプレートとm4マクロパッケージを 用いて、ソースコードパッケージを自動設定するスクリプトを生成します。 説明書の版は2.13で、Autoconfバージョン2.13用のものです。

1. Introduction		Autoconfの目的、利点と欠点。
2. Making configure Scripts		Autoconfスクリプトの準備・作成方法。
3. Initialization and Output Files		Initialization and output.
4. Existing Tests		Macros that check for particular features.
5. Writing Tests		How to write new feature checks.
6. Results of Tests		What to do with results from feature checks.
7. Writing Macros		Adding new macros to Autoconf.
8. Manual Configuration		Selecting features that can't be guessed.
9. Site Configuration		Local defaults for configure.
10. Running configure Scripts		How to use the Autoconf output.
11. Recreating a Configuration		Recreating a configuration.
12. Questions About Autoconf		Questions about Autoconf, with answers.
13. Upgrading From Version 1		Tips for upgrading from version 1.
14. History of Autoconf
15. 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

2.1 Writing `configure.in'		What to put in an Autoconf input file.
2.2 Using autoscan to Create `configure.in'		Semi-automatic `configure.in' writing.
2.3 Using ifnames to List Conditionals		Listing the conditionals in source code.
2.4 Using autoconf to Create configure		How to create configuration scripts.
2.5 Using autoreconf to Update configure Scripts		Remaking multiple configure scripts.

Initialization and Output Files

3.1 Finding configure Input		Where Autoconf should find files.
3.2 Creating Output Files		Creating output files.
3.3 Substitutions in Makefiles		Using output variables in `Makefile's.
3.4 Configuration Header Files		Creating a configuration header file.
3.5 Configuring Other Packages in Subdirectories		Configuring independent packages together.
3.6 Default Prefix		Changing the default installation prefix.
3.7 Version Numbers in configure		Version numbers in configure.

Substitutions in Makefiles

3.3.1 Preset Output Variables		Output variables that are always set.
3.3.2 Build Directories		Supporting multiple concurrent compiles.
3.3.3 Automatic Remaking		Makefile rules for configuring.

Configuration Header Files

3.4.1 Configuration Header Templates		Input for the configuration headers.
3.4.2 Using autoheader to Create `config.h.in'		How to create configuration templates.

Existing Tests

4.1 Alternative Programs		Selecting between alternative programs.
4.2 Library Files		Library archives that might be missing.
4.3 Library Functions		C library functions that might be missing.
4.4 Header Files		Header files that might be missing.
4.5 Structures		Structures or members that might be missing.
4.6 Typedefs		typedefs that might be missing.
4.7 C Compiler Characteristics
4.8 Fortran 77 Compiler Characteristics
4.9 System Services		Operating system services.
4.10 UNIX Variants		Special kludges for specific UNIX variants.

Alternative Programs

4.1.1 Particular Program Checks		Special handling to find certain programs.
4.1.2 Generic Program and File Checks		How to find other programs.

Library Functions

4.3.1 Particular Function Checks		Special handling to find certain functions.
4.3.2 Generic Function Checks		How to find other functions.

Header Files

4.4.1 Particular Header Checks		Special handling to find certain headers.
4.4.2 Generic Header Checks		How to find other headers.

Typedefs

4.6.1 Particular Typedef Checks		Special handling to find certain types.
4.6.2 Generic Typedef Checks		How to find other types.

Writing Tests

5.1 Examining Declarations		Detecting header files and declarations.
5.2 Examining Syntax		Detecting language syntax features.
5.3 Examining Libraries		Detecting functions and global variables.
5.4 Checking Run Time Behavior		Testing for run-time features.
5.5 Portable Shell Programming		Shell script portability pitfalls.
5.6 Testing Values and Files		Checking strings and files.
5.7 Multiple Cases		Tests for several possible values.
5.8 Language Choice		Selecting which language to use for testing.

Checking Run Time Behavior

5.4.1 Running Test Programs		Running test programs.
5.4.2 Guidelines for Test Programs		General rules for writing test programs.
5.4.3 Test Functions		Avoiding pitfalls in test programs.

Results of Tests

6.1 Defining C Preprocessor Symbols		Defining C preprocessor symbols.
6.2 Setting Output Variables		Replacing variables in output files.
6.3 Caching Results		Speeding up subsequent configure runs.
6.4 Printing Messages		Notifying users of progress or problems.

Caching Results

6.3.1 Cache Variable Names		Shell variables used in caches.
6.3.2 Cache Files		Files configure uses for caching.

Writing Macros

7.1 Macro Definitions		Basic format of an Autoconf macro.
7.2 Macro Names		What to call your new macros.
7.3 Quoting		Protecting macros from unwanted expansion.
7.4 Dependencies Between Macros		What to do when macros depend on other macros.

Dependencies Between Macros

7.4.1 Prerequisite Macros		Ensuring required information.
7.4.2 Suggested Ordering		Warning about possible ordering problems.
7.4.3 Obsolete Macros		Warning about old ways of doing things.

Manual Configuration

8.1 Specifying the System Type		Specifying the system type.
8.2 Getting the Canonical System Type		Getting the canonical system type.
8.3 System Type Variables		Variables containing the system type.
8.4 Using the System Type		What to do with the system type.

Site Configuration

9.1 Working With External Software		Working with other optional software.
9.2 Choosing Package Options		Selecting optional features.
9.3 Configuring Site Details		Configuring site details.
9.4 Transforming Program Names When Installing		Changing program names when installing.
9.5 Setting Site Defaults		Giving configure local defaults.

Transforming Program Names When Installing

9.4.1 Transformation Options		configure options to transform names.
9.4.2 Transformation Examples		Sample uses of transforming names.
9.4.3 Transformation Rules		`Makefile' uses of transforming names.

Running configure Scripts

10.1 基本インストール		Instructions for typical cases.
10.2 コンパイラとオプション		Selecting compilers and optimization.
10.3 複数のアーキテクチャに対するコンパイル		Compiling for multiple architectures at once.
10.4 インストール名		Installing in different directories.
10.5 オプションの特徴		Selecting optional features.
10.6 システムタイプの指定		Specifying the system type.
10.7 デフォルトの共有		Setting site-wide defaults for configure.
10.8 オペレーションの制御		Changing how configure runs.

Questions About Autoconf

12.1 Distributing configure Scripts		Distributing configure scripts.
12.2 Why Require GNU m4?		Why not use the standard m4?
12.3 How Can I Bootstrap?		Autoconf and GNU m4 require each other?
12.4 Why Not Imake?		Why GNU uses configure instead of Imake.

Upgrading From Version 1

13.1 Changed File Names		Files you might rename.
13.2 Changed Makefiles		New things to put in `Makefile.in'.
13.3 Changed Macros		Macro calls you might replace.
13.4 Using autoupdate to Modernize configure		Replacing old macro names in configure.in.
13.5 Changed Results		Changes in how to check test results.
13.6 Changed Macro Writing		Better ways to write your own macros.

History of Autoconf

14.1 Genesis		Prehistory and naming of configure.
14.2 Exodus		The plagues of m4 and Perl.
14.3 Leviticus		The priestly code of portability arrives.
14.4 Numbers		Growth and contributors.
14.5 Deuteronomy		Approaching the promises of easy configuration.