[Top] [Contents] [Index] [ ? ]

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.



This document was generated by Akihiro Sagawa on January, 21 2003 using texi2html