home *** CD-ROM | disk | FTP | other *** search
/ Fresh Fish 8 / FreshFishVol8-CD1.bin / gnu / info / autoconf.info-1 (.txt) < prev    next >
GNU Info File  |  1994-12-22  |  51KB  |  895 lines
  1. This is Info file /gnu/src/amiga/autoconf-2.1/autoconf.info, produced
  2. by Makeinfo-1.55 from the input file
  3. /gnu/src/amiga/autoconf-2.1/autoconf.texi.
  4. START-INFO-DIR-ENTRY
  5. * Autoconf: (autoconf).         Create source code configuration scripts.
  6. END-INFO-DIR-ENTRY
  7.    This file documents the GNU Autoconf package for creating scripts to
  8. configure source code packages using templates and an `m4' macro
  9. package.
  10.    Copyright (C) 1992, 1993, 1994 Free Software Foundation, Inc.
  11.    Permission is granted to make and distribute verbatim copies of this
  12. manual provided the copyright notice and this permission notice are
  13. preserved on all copies.
  14.    Permission is granted to copy and distribute modified versions of
  15. this manual under the conditions for verbatim copying, provided that
  16. the entire resulting derived work is distributed under the terms of a
  17. permission notice identical to this one.
  18.    Permission is granted to copy and distribute translations of this
  19. manual into another language, under the above conditions for modified
  20. versions, except that this permission notice may be stated in a
  21. translation approved by the Foundation.
  22. File: autoconf.info,  Node: Top,  Next: Introduction,  Up: (dir)
  23.    This file documents the GNU Autoconf package for creating scripts to
  24. configure source code packages using templates and an `m4' macro
  25. package.  This is edition 2.1, for Autoconf version 2.1.
  26. * Menu:
  27. * Introduction::                Autoconf's purpose, strengths, and weaknesses.
  28. * Making configure Scripts::    How to organize and produce Autoconf scripts.
  29. * Setup::                       Initialization and output.
  30. * Existing Tests::              Macros that check for particular features.
  31. * Writing Tests::               How to write new feature checks.
  32. * Results::                     What to do with results from feature checks.
  33. * Writing Macros::              Adding new macros to Autoconf.
  34. * Manual Configuration::        Selecting features that can't be guessed.
  35. * Site Configuration::          Local defaults for `configure'.
  36. * Invoking configure::          How to use the Autoconf output.
  37. * Invoking config.status::      Recreating a configuration.
  38. * Questions::                   Questions about Autoconf, with answers.
  39. * Upgrading::                   Tips for upgrading from version 1.
  40. * History::                     History of Autoconf.
  41. * Old Macro Names::        Backward compatibility macros.
  42. * Environment Variable Index::  Index of environment variables used.
  43. * Output Variable Index::       Index of variables set in output files.
  44. * Preprocessor Symbol Index::   Index of C preprocessor symbols defined.
  45. * Macro Index::                 Index of Autoconf macros.
  46.  -- The Detailed Node Listing --
  47. Making `configure' Scripts
  48. * Writing configure.in::    What to put in an Autoconf input file.
  49. * Invoking autoscan::           Semi-automatic `configure.in' writing.
  50. * Invoking ifnames::            Listing the conditionals in source code.
  51. * Invoking autoconf::        How to create configuration scripts.
  52. * Invoking autoreconf::         Remaking multiple `configure' scripts.
  53. Initialization and Output Files
  54. * Input::                       Where Autoconf should find files.
  55. * Output::            Creating output files.
  56. * Makefile Substitutions::      Using output variables in `Makefile's.
  57. * Configuration Headers::       Creating a configuration header file.
  58. * Subdirectories::              Configuring independent packages together.
  59. * Default Prefix::              Changing the default installation prefix.
  60. * Versions::                    Version numbers in `configure'.
  61. Substitutions in Makefiles
  62. * Preset Output Variables::    Output variables that are always set.
  63. * Build Directories::        Compiling in a different directory.
  64. * Automatic Remaking::        Makefile rules for configuring.
  65. Configuration Header Files
  66. * Header Templates::            Input for the configuration headers.
  67. * Invoking autoheader::        How to create configuration templates.
  68. Existing Tests
  69. * Alternative Programs::    Selecting between alternative programs.
  70. * Libraries::                   Library archives that might be missing.
  71. * Library Functions::        C library functions that might be missing.
  72. * Header Files::        Header files that might be missing.
  73. * Structures::            Structures or members that might be missing.
  74. * Typedefs::            `typedef's that might be missing.
  75. * Compiler Characteristics::    C compiler or machine architecture features.
  76. * System Services::        Operating system services.
  77. * UNIX Variants::        Special kludges for specific UNIX variants.
  78. Alternative Programs
  79. * Particular Programs::         Special handling to find certain programs.
  80. * Generic Programs::            How to find other programs.
  81. Library Functions
  82. * Particular Functions::        Special handling to find certain functions.
  83. * Generic Functions::           How to find other functions.
  84. Header Files
  85. * Particular Headers::          Special handling to find certain headers.
  86. * Generic Headers::             How to find other headers.
  87. Typedefs
  88. * Particular Typedefs::         Special handling to find certain types.
  89. * Generic Typedefs::            How to find other types.
  90. Writing Tests
  91. * Examining Declarations::    Detecting header files and declarations.
  92. * Examining Syntax::            Detecting language syntax features.
  93. * Examining Libraries::         Detecting functions and global variables.
  94. * Run Time::                Testing for run-time features.
  95. * Portable Shell::              Shell script portability pitfalls.
  96. * Testing Values and Files::    Checking strings and files.
  97. * Multiple Cases::        Tests for several possible values.
  98. * Language Choice::             Selecting which language to use for testing.
  99. Checking Run Time Behavior
  100. * Test Programs::               Running test programs.
  101. * Guidelines::            General rules for writing test programs.
  102. * Test Functions::        Avoiding pitfalls in test programs.
  103. Results of Tests
  104. * Defining Symbols::            Defining C preprocessor symbols.
  105. * Setting Output Variables::    Replacing variables in output files.
  106. * Caching Results::             Speeding up subsequent `configure' runs.
  107. * Printing Messages::           Notifying users of progress or problems.
  108. Caching Results
  109. * Cache Variable Names::        Shell variables used in caches.
  110. * Cache Files::                Files `configure' uses for caching.
  111. Writing Macros
  112. * Macro Definitions::        Basic format of an Autoconf macro.
  113. * Macro Names::                 What to call your new macros.
  114. * Quoting::            Protecting macros from unwanted expansion.
  115. * Dependencies Between Macros::    What to do when macros depend on other macros.
  116. Dependencies Between Macros
  117. * Prerequisite Macros::        Ensuring required information.
  118. * Suggested Ordering::        Warning about possible ordering problems.
  119. * Obsolete Macros::             Warning about old ways of doing things.
  120. Manual Configuration
  121. * Specifying Names::            Specifying the system type.
  122. * Canonicalizing::              Getting the canonical system type.
  123. * System Type Variables::       Variables containing the system type.
  124. * Using System Type::           What to do with the system type.
  125. Site Configuration
  126. * External Software::           Working with other optional software.
  127. * Package Options::             Selecting optional features.
  128. * Site Details::                Configuring site details.
  129. * Transforming Names::          Changing program names when installing.
  130. * Site Defaults::               Giving `configure' local defaults.
  131. Transforming Program Names When Installing
  132. * Transformation Options::      `configure' options to transforme names.
  133. * Transformation Examples::     Sample uses of transforming names.
  134. * Transformation Rules::        `Makefile' uses of transforming names.
  135. Running `configure' Scripts
  136. * Basic Installation::          Instructions for typical cases.
  137. * Compilers and Options::       Selecting compilers and optimization.
  138. * Build Directory::             Configuring in a different directory.
  139. * Installation Names::          Installing in different directories.
  140. * Optional Features::           Selecting optional features.
  141. * System Type::                 Specifying the system type.
  142. * Sharing Defaults::            Setting site-wide defaults for `configure'.
  143. * Operation Controls::          Changing how `configure' ru