[Top] | [Contents] | [Index] | [ ? ] |
このファイルは、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 | typedef s 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. | |