/[autoconf]/autoconf/doc/autoconf.texi
ViewVC logotype

Diff of /autoconf/doc/autoconf.texi

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.726 by akim, Fri Mar 28 14:51:31 2003 UTC revision 1.727 by akim, Tue Apr 1 07:28:08 2003 UTC
# Line 8  Line 8 
8  @setcontentsaftertitlepage  @setcontentsaftertitlepage
9  @finalout  @finalout
10    
11  @c A simple macro for optional variables.  @c @ovar(ARG, DEFAULT)
12    @c -------------------
13    @c The ARG is an optional argument.  To be used for macro arguments in
14    @c their documentation (@defmac).
15  @macro ovar{varname}  @macro ovar{varname}
16  @r{[}@var{\varname\}@r{]}  @r{[}@var{\varname\}@r{]}
17  @end macro  @end macro
18    
19  @c A simple macro for optional variables with a default value.  @c @dvar(ARG, DEFAULT)
20    @c -------------------
21    @c The ARG is an optional argument, defaulting to DEFAULT.  To be used
22    @c for macro arguments in their documentation (@defmac).
23  @macro dvar{varname, default}  @macro dvar{varname, default}
24  @r{[}@var{\varname\} = @samp{\default\}@r{]}  @r{[}@var{\varname\} = @samp{\default\}@r{]}
25  @end macro  @end macro
26    
27  @c I don't like the way URL are displayed in TeX with @uref.  @c @href(URL, TITLE)
28    @c -----------------
29    @c A replacement for @uref that puts the URL in the footnotes when
30    @c not in HTML.
31  @ifhtml  @ifhtml
32  @macro href{url, title}  @macro href{url, title}
33  @uref{\url\, \title\}  @uref{\url\, \title\}
# Line 30  Line 39 
39  @end macro  @end macro
40  @end ifnothtml  @end ifnothtml
41    
42    @c Handling the indexes with Texinfo yields several different problems.
43    @c
44    @c Because we want to drop out the AC_ part of the macro names in the
45    @c printed manual, but not in the other outputs, we need a layer above
46    @c the usual @acindex etc.  That's why we first define indexes such as
47    @c acx meant to become the macro @acindex.  First of all, using ``ac_''
48    @c does not work with makeinfo, and using ``ac1'' doesn't work with TeX.
49    @c So use something more regular ``acx''.  Then you finish with a printed
50    @c index saying ``index is not existent''.  Of course: you ought to use
51    @c two letters :(  So you use capitals.
52    @c
53    @c Second, when defining a macro in the TeX world, following spaces are
54    @c eaten.  But then, since we embed @acxindex commands that use the end
55    @c of line as an end marker, the whole things wrecks itself.  So make
56    @c sure you do *force* an additional end of line, add a ``@c''.
57    @c
58    @c Finally, you might want to get rid of TeX expansion, using --expand
59    @c with texi2dvi.  But then you wake up an old problem: we use macros
60    @c in @defmac etc. where TeX does perform the expansion, but not makeinfo.
61    
62  @c Define an environment variable index.  @c Define an environment variable index.
63  @defcodeindex ev  @defcodeindex ev
64  @c Define an output variable index.  @c Define an output variable index.
# Line 37  Line 66 
66  @c Define a CPP variable index.  @c Define a CPP variable index.
67  @defcodeindex cv  @defcodeindex cv
68  @c Define an Autoconf macro index that @defmac doesn't write to.  @c Define an Autoconf macro index that @defmac doesn't write to.
69  @defcodeindex ac  @defcodeindex AC
70  @c Define an Autotest macro index that @defmac doesn't write to.  @c Define an Autotest macro index that @defmac doesn't write to.
71  @defcodeindex at  @defcodeindex AT
72  @c Define an M4sugar macro index that @defmac doesn't write to.  @c Define an M4sugar macro index that @defmac doesn't write to.
73  @defcodeindex ms  @defcodeindex MS
74  @c Define an index for *foreign* programs: `mv' etc.  Used for the  @c Define an index for *foreign* programs: `mv' etc.  Used for the
75  @c portability sections and so on.  @c portability sections and so on.
76  @defindex pr  @defindex pr
77    
78    @c shortindexflag
79    @c --------------
80    @c Shall we factor AC_ out of the Autoconf macro index etc.?
81    @iftex
82    @set shortindexflag
83    @end iftex
84    
85    @c @acindex{MACRO}
86    @c ---------------
87    @c Registering an AC_\MACRO\.
88    @ifset shortindexflag
89    @macro acindex{macro}
90    @ACindex \macro\
91    @c
92    @end macro
93    @end ifset
94    @ifclear shortindexflag
95    @macro acindex{macro}
96    @ACindex AC_\macro\
97    @end macro
98    @end ifclear
99    
100    @c @ahindex{MACRO}
101    @c ---------------
102    @c Registering an AH_\MACRO\.
103    @macro ahindex{macro}
104    @ACindex AH_\macro\
105    @c
106    @end macro
107    
108    @c @asindex{MACRO}
109    @c ---------------
110    @c Registering an AS_\MACRO\.
111    @ifset shortindexflag
112    @macro asindex{macro}
113    @MSindex \macro\
114    @c
115    @end macro
116    @end ifset
117    @ifclear shortindexflag
118    @macro asindex{macro}
119    @MSindex AS_\macro\
120    @end macro
121    @end ifclear
122    
123    @c @atindex{MACRO}
124    @c ---------------
125    @c Registering an AT_\MACRO\.
126    @ifset shortindexflag
127    @macro atindex{macro}
128    @ATindex \macro\
129    @c
130    @end macro
131    @end ifset
132    @ifclear shortindexflag
133    @macro atindex{macro}
134    @ATindex AT_\macro\
135    @end macro
136    @end ifclear
137    
138    @c @msindex{MACRO}
139    @c ---------------
140    @c Registering an m4_\MACRO\.
141    @ifset shortindexflag
142    @macro msindex{macro}
143    @MSindex \macro\
144    @c
145    @end macro
146    @end ifset
147    @ifclear shortindexflag
148    @macro msindex{macro}
149    @MSindex m4_\macro\
150    @end macro
151    @end ifclear
152    
153    
154  @c Define an index for functions: `alloca' etc.  Used for the  @c Define an index for functions: `alloca' etc.  Used for the
155  @c portability sections and so on.  We can't use `fn' (aka `fnindex),  @c portability sections and so on.  We can't use `fn' (aka `fnindex),
156  @c since `@defmac' goes into it => we'd get all the macros too.  @c since `@defmac' goes into it => we'd get all the macros too.
# Line 454  History of Autoconf Line 559  History of Autoconf
559    
560  Copying This Manual  Copying This Manual
561    
562    * GNU Free Documentation License::  License for copying this manual
563    
564  Indices  Indices
565    
# Line 1470  anything else.  The only other required Line 1576  anything else.  The only other required
1576  (@pxref{Output}).  (@pxref{Output}).
1577    
1578  @defmac AC_INIT (@var{package}, @var{version}, @ovar{bug-report}, @ovar{tarname})  @defmac AC_INIT (@var{package}, @var{version}, @ovar{bug-report}, @ovar{tarname})
1579  @acindex INIT  @acindex{INIT}
1580  Process any command-line arguments and perform various initializations  Process any command-line arguments and perform various initializations
1581  and verifications.  and verifications.
1582    
# Line 1494  The following M4 macros (e.g., @code{AC_ Line 1600  The following M4 macros (e.g., @code{AC_
1600    
1601  @table @asis  @table @asis
1602  @item @code{AC_PACKAGE_NAME}, @code{PACKAGE_NAME}  @item @code{AC_PACKAGE_NAME}, @code{PACKAGE_NAME}
1603  @acindex PACKAGE_NAME  @acindex{PACKAGE_NAME}
1604  @ovindex PACKAGE_NAME  @ovindex PACKAGE_NAME
1605  @cvindex PACKAGE_NAME  @cvindex PACKAGE_NAME
1606  Exactly @var{package}.  Exactly @var{package}.
1607    
1608  @item @code{AC_PACKAGE_TARNAME}, @code{PACKAGE_TARNAME}  @item @code{AC_PACKAGE_TARNAME}, @code{PACKAGE_TARNAME}
1609  @acindex PACKAGE_TARNAME  @acindex{PACKAGE_TARNAME}
1610  @ovindex PACKAGE_TARNAME  @ovindex PACKAGE_TARNAME
1611  @cvindex PACKAGE_TARNAME  @cvindex PACKAGE_TARNAME
1612  Exactly @var{tarname}.  Exactly @var{tarname}.
1613    
1614  @item @code{AC_PACKAGE_VERSION}, @code{PACKAGE_VERSION}  @item @code{AC_PACKAGE_VERSION}, @code{PACKAGE_VERSION}
1615  @acindex PACKAGE_VERSION  @acindex{PACKAGE_VERSION}
1616  @ovindex PACKAGE_VERSION  @ovindex PACKAGE_VERSION
1617  @cvindex PACKAGE_VERSION  @cvindex PACKAGE_VERSION
1618  Exactly @var{version}.  Exactly @var{version}.
1619    
1620  @item @code{AC_PACKAGE_STRING}, @code{PACKAGE_STRING}  @item @code{AC_PACKAGE_STRING}, @code{PACKAGE_STRING}
1621  @acindex PACKAGE_STRING  @acindex{PACKAGE_STRING}
1622  @ovindex PACKAGE_STRING  @ovindex PACKAGE_STRING
1623  @cvindex PACKAGE_STRING  @cvindex PACKAGE_STRING
1624  Exactly @samp{@var{package} @var{version}}.  Exactly @samp{@var{package} @var{version}}.
1625    
1626  @item @code{AC_PACKAGE_BUGREPORT}, @code{PACKAGE_BUGREPORT}  @item @code{AC_PACKAGE_BUGREPORT}, @code{PACKAGE_BUGREPORT}
1627  @acindex PACKAGE_BUGREPORT  @acindex{PACKAGE_BUGREPORT}
1628  @ovindex PACKAGE_BUGREPORT  @ovindex PACKAGE_BUGREPORT
1629  @cvindex PACKAGE_BUGREPORT  @cvindex PACKAGE_BUGREPORT
1630  Exactly @var{bug-report}.  Exactly @var{bug-report}.
# Line 1534  scripts.  Using them is optional. Line 1640  scripts.  Using them is optional.
1640    
1641  @c FIXME: AC_PREREQ should not be here  @c FIXME: AC_PREREQ should not be here
1642  @defmac AC_PREREQ (@var{version})  @defmac AC_PREREQ (@var{version})
1643  @acindex PREREQ  @acindex{PREREQ}
1644  @cindex Version  @cindex Version
1645  Ensure that a recent enough version of Autoconf is being used.  If the  Ensure that a recent enough version of Autoconf is being used.  If the
1646  version of Autoconf being used to create @command{configure} is earlier  version of Autoconf being used to create @command{configure} is earlier
# Line 1550  for consistency, you are invited not to Line 1656  for consistency, you are invited not to
1656  @end defmac  @end defmac
1657    
1658  @defmac AC_COPYRIGHT (@var{copyright-notice})  @defmac AC_COPYRIGHT (@var{copyright-notice})
1659  @acindex COPYRIGHT  @acindex{COPYRIGHT}
1660  @cindex Copyright Notice  @cindex Copyright Notice
1661  State that, in addition to the Free Software Foundation's copyright on  State that, in addition to the Free Software Foundation's copyright on
1662  the Autoconf macros, parts of your @command{configure} are covered by the  the Autoconf macros, parts of your @command{configure} are covered by the
# Line 1562  The @var{copyright-notice} will show up Line 1668  The @var{copyright-notice} will show up
1668    
1669    
1670  @defmac AC_REVISION (@var{revision-info})  @defmac AC_REVISION (@var{revision-info})
1671  @acindex REVISION  @acindex{REVISION}
1672  @cindex Revision  @cindex Revision
1673  Copy revision stamp @var{revision-info} into the @command{configure}  Copy revision stamp @var{revision-info} into the @command{configure}
1674  script, with any dollar signs or double-quotes removed.  This macro lets  script, with any dollar signs or double-quotes removed.  This macro lets
# Line 1593  produces this in @command{configure}: Line 1699  produces this in @command{configure}:
1699    
1700    
1701  @defmac AC_CONFIG_SRCDIR (@var{unique-file-in-source-dir})  @defmac AC_CONFIG_SRCDIR (@var{unique-file-in-source-dir})
1702  @acindex CONFIG_SRCDIR  @acindex{CONFIG_SRCDIR}
1703  @var{unique-file-in-source-dir} is some file that is in the package's  @var{unique-file-in-source-dir} is some file that is in the package's
1704  source directory; @command{configure} checks for this file's existence to  source directory; @command{configure} checks for this file's existence to
1705  make sure that the directory that it is told contains the source code in  make sure that the directory that it is told contains the source code in
# Line 1611  Invocation}, for more information. Line 1717  Invocation}, for more information.
1717  @c told which files to load, and in which order.  @c told which files to load, and in which order.
1718  @c  @c
1719  @c @defmac AC_INCLUDE (@var{file}@dots{})  @c @defmac AC_INCLUDE (@var{file}@dots{})
1720  @c @acindex INCLUDE  @c @acindex{INCLUDE}
1721  @c @c FIXME: There is no longer shell globbing.  @c @c FIXME: There is no longer shell globbing.
1722  @c Read the macro definitions that appear in the listed files.  A list of  @c Read the macro definitions that appear in the listed files.  A list of
1723  @c space-separated filenames or shell globbing patterns is expected.  The  @c space-separated filenames or shell globbing patterns is expected.  The
# Line 1633  scripts by calling @code{AC_CONFIG_AUX_D Line 1739  scripts by calling @code{AC_CONFIG_AUX_D
1739  it looks are correct for most cases.  it looks are correct for most cases.
1740    
1741  @defmac AC_CONFIG_AUX_DIR (@var{dir})  @defmac AC_CONFIG_AUX_DIR (@var{dir})
1742  @acindex CONFIG_AUX_DIR  @acindex{CONFIG_AUX_DIR}
1743  Use the auxiliary build tools (e.g., @file{install-sh},  Use the auxiliary build tools (e.g., @file{install-sh},
1744  @file{config.sub}, @file{config.guess}, Cygnus @command{configure},  @file{config.sub}, @file{config.guess}, Cygnus @command{configure},
1745  Automake and Libtool scripts etc.) that are in directory @var{dir}.  Automake and Libtool scripts etc.) that are in directory @var{dir}.
# Line 1659  other files resulting from configuration Line 1765  other files resulting from configuration
1765  macro besides @code{AC_INIT} (@pxref{Input}).  macro besides @code{AC_INIT} (@pxref{Input}).
1766    
1767  @defmac AC_OUTPUT  @defmac AC_OUTPUT
1768  @acindex OUTPUT  @acindex{OUTPUT}
1769  @cindex Instantiation  @cindex Instantiation
1770  Generate @file{config.status} and launch it.  Call this macro once, at  Generate @file{config.status} and launch it.  Call this macro once, at
1771  the end of @file{configure.ac}.  the end of @file{configure.ac}.
# Line 1688  Some old versions of @command{make} do n Line 1794  Some old versions of @command{make} do n
1794  following macro allows you to use it even with those versions.  following macro allows you to use it even with those versions.
1795    
1796  @defmac AC_PROG_MAKE_SET  @defmac AC_PROG_MAKE_SET
1797  @acindex PROG_MAKE_SET  @acindex{PROG_MAKE_SET}
1798  @ovindex SET_MAKE  @ovindex SET_MAKE
1799  If @command{make} predefines the Make variable @code{MAKE}, define  If @command{make} predefines the Make variable @code{MAKE}, define
1800  output variable @code{SET_MAKE} to be empty.  Otherwise, define  output variable @code{SET_MAKE} to be empty.  Otherwise, define
# Line 1852  All these macros can be called multiple Line 1958  All these macros can be called multiple
1958  Be sure to read the previous section, @ref{Configuration Actions}.  Be sure to read the previous section, @ref{Configuration Actions}.
1959    
1960  @defmac AC_CONFIG_FILES (@var{file}@dots{}, @ovar{cmds}, @ovar{init-cmds})  @defmac AC_CONFIG_FILES (@var{file}@dots{}, @ovar{cmds}, @ovar{init-cmds})
1961  @acindex CONFIG_FILES  @acindex{CONFIG_FILES}
1962  Make @code{AC_OUTPUT} create each @file{@var{file}} by copying an input  Make @code{AC_OUTPUT} create each @file{@var{file}} by copying an input
1963  file (by default @file{@var{file}.in}), substituting the output variable  file (by default @file{@var{file}.in}), substituting the output variable
1964  values.  values.
# Line 2410  also be configured without finding the @ Line 2516  also be configured without finding the @
2516  directory.  directory.
2517    
2518  @defmac AC_CONFIG_HEADERS (@var{header} @dots{}, @ovar{cmds}, @ovar{init-cmds})  @defmac AC_CONFIG_HEADERS (@var{header} @dots{}, @ovar{cmds}, @ovar{init-cmds})
2519  @acindex CONFIG_HEADERS  @acindex{CONFIG_HEADERS}
2520  @cvindex HAVE_CONFIG_H  @cvindex HAVE_CONFIG_H
2521  This macro is one of the instantiating macros; see @ref{Configuration  This macro is one of the instantiating macros; see @ref{Configuration
2522  Actions}.  Make @code{AC_OUTPUT} create the file(s) in the  Actions}.  Make @code{AC_OUTPUT} create the file(s) in the
# Line 2615  the @var{description} argument to an @sa Line 2721  the @var{description} argument to an @sa
2721  @ref{Defining Symbols}.  You may also use one of the following macros.  @ref{Defining Symbols}.  You may also use one of the following macros.
2722    
2723  @defmac AH_VERBATIM (@var{key}, @var{template})  @defmac AH_VERBATIM (@var{key}, @var{template})
2724  @acindex AH_VERBATIM  @ahindex{VERBATIM}
 @acindex VERBATIM  
2725  Tell @command{autoheader} to include the @var{template} as-is in the header  Tell @command{autoheader} to include the @var{template} as-is in the header
2726  template file.  This @var{template} is associated with the @var{key},  template file.  This @var{template} is associated with the @var{key},
2727  which is used to sort all the different templates and guarantee their  which is used to sort all the different templates and guarantee their
# Line 2635  AH_VERBATIM([_GNU_SOURCE], Line 2740  AH_VERBATIM([_GNU_SOURCE],
2740    
2741    
2742  @defmac AH_TEMPLATE (@var{key}, @var{description})  @defmac AH_TEMPLATE (@var{key}, @var{description})
2743  @acindex AH_TEMPLATE  @ahindex{TEMPLATE}
 @acindex TEMPLATE  
2744  Tell @command{autoheader} to generate a template for @var{key}.  This macro  Tell @command{autoheader} to generate a template for @var{key}.  This macro
2745  generates standard templates just like @code{AC_DEFINE} when a  generates standard templates just like @code{AC_DEFINE} when a
2746  @var{description} is given.  @var{description} is given.
# Line 2665  justified. Line 2769  justified.
2769    
2770    
2771  @defmac AH_TOP (@var{text})  @defmac AH_TOP (@var{text})
2772  @acindex AH_TOP  @ahindex{TOP}
 @acindex TOP  
2773  Include @var{text} at the top of the header template file.  Include @var{text} at the top of the header template file.
2774  @end defmac  @end defmac
2775    
2776    
2777  @defmac AH_BOTTOM (@var{text})  @defmac AH_BOTTOM (@var{text})
2778  @acindex AH_BOTTOM  @ahindex{BOTTOM}
 @acindex BOTTOM  
2779  Include @var{text} at the bottom of the header template file.  Include @var{text} at the bottom of the header template file.
2780  @end defmac  @end defmac
2781    
# Line 2688  commands to run when they are called mul Line 2790  commands to run when they are called mul
2790  @code{AC_OUTPUT_COMMANDS}; see @ref{Obsolete Macros}, for details.  @code{AC_OUTPUT_COMMANDS}; see @ref{Obsolete Macros}, for details.
2791    
2792  @defmac AC_CONFIG_COMMANDS (@var{tag}@dots{}, @ovar{cmds}, @ovar{init-cmds})  @defmac AC_CONFIG_COMMANDS (@var{tag}@dots{}, @ovar{cmds}, @ovar{init-cmds})
2793  @acindex CONFIG_COMMANDS  @acindex{CONFIG_COMMANDS}
2794  Specify additional shell commands to run at the end of  Specify additional shell commands to run at the end of
2795  @file{config.status}, and shell commands to initialize any variables  @file{config.status}, and shell commands to initialize any variables
2796  from @command{configure}.  Associate the commands with @var{tag}.  Since  from @command{configure}.  Associate the commands with @var{tag}.  Since
# Line 2711  AC_CONFIG_COMMANDS([time-stamp], [date > Line 2813  AC_CONFIG_COMMANDS([time-stamp], [date >
2813  @end defmac  @end defmac
2814    
2815  @defmac AC_CONFIG_COMMANDS_PRE (@var{cmds})  @defmac AC_CONFIG_COMMANDS_PRE (@var{cmds})
2816  @acindex OUTPUT_COMMANDS_PRE  @acindex{OUTPUT_COMMANDS_PRE}
2817  Execute the @var{cmds} right before creating @file{config.status}.  Execute the @var{cmds} right before creating @file{config.status}.
2818  @end defmac  @end defmac
2819    
2820  @defmac AC_CONFIG_COMMANDS_POST (@var{cmds})  @defmac AC_CONFIG_COMMANDS_POST (@var{cmds})
2821  @acindex OUTPUT_COMMANDS_POST  @acindex{OUTPUT_COMMANDS_POST}
2822  Execute the @var{cmds} right after creating @file{config.status}.  Execute the @var{cmds} right after creating @file{config.status}.
2823  @end defmac  @end defmac
2824    
# Line 2732  creation of relative symbolic links can Line 2834  creation of relative symbolic links can
2834  built in a directory different from the source directory.  built in a directory different from the source directory.
2835    
2836  @defmac AC_CONFIG_LINKS (@var{dest}:@var{source}@dots{}, @ovar{cmds}, @ovar{init-cmds})  @defmac AC_CONFIG_LINKS (@var{dest}:@var{source}@dots{}, @ovar{cmds}, @ovar{init-cmds})
2837  @acindex CONFIG_LINKS  @acindex{CONFIG_LINKS}
2838  @cindex Links  @cindex Links
2839  Make @code{AC_OUTPUT} link each of the existing files @var{source} to  Make @code{AC_OUTPUT} link each of the existing files @var{source} to
2840  the corresponding link name @var{dest}.  Makes a symbolic link if  the corresponding link name @var{dest}.  Makes a symbolic link if
# Line 2776  that control more than one independent p Line 2878  that control more than one independent p
2878  packages in subdirectories.  packages in subdirectories.
2879    
2880  @defmac AC_CONFIG_SUBDIRS (@var{dir} @dots{})  @defmac AC_CONFIG_SUBDIRS (@var{dir} @dots{})
2881  @acindex CONFIG_SUBDIRS  @acindex{CONFIG_SUBDIRS}
2882  @ovindex subdirs  @ovindex subdirs
2883  Make @code{AC_OUTPUT} run @command{configure} in each subdirectory  Make @code{AC_OUTPUT} run @command{configure} in each subdirectory
2884  @var{dir} in the given whitespace-separated list.  Each @var{dir} should  @var{dir} in the given whitespace-separated list.  Each @var{dir} should
# Line 2856  Some software packages might want to ins Line 2958  Some software packages might want to ins
2958  @code{AC_PREFIX_DEFAULT} macro.  @code{AC_PREFIX_DEFAULT} macro.
2959    
2960  @defmac AC_PREFIX_DEFAULT (@var{prefix})  @defmac AC_PREFIX_DEFAULT (@var{prefix})
2961  @acindex PREFIX_DEFAULT  @acindex{PREFIX_DEFAULT}
2962  Set the default installation prefix to @var{prefix} instead of  Set the default installation prefix to @var{prefix} instead of
2963  @file{/usr/local}.  @file{/usr/local}.
2964  @end defmac  @end defmac
# Line 2867  have already installed.  If you wish to Line 2969  have already installed.  If you wish to
2969  @code{AC_PREFIX_PROGRAM}.  @code{AC_PREFIX_PROGRAM}.
2970    
2971  @defmac AC_PREFIX_PROGRAM (@var{program})  @defmac AC_PREFIX_PROGRAM (@var{program})
2972  @acindex PREFIX_PROGRAM  @acindex{PREFIX_PROGRAM}
2973  If the user did not specify an installation prefix (using the  If the user did not specify an installation prefix (using the
2974  @option{--prefix} option), guess a value for it by looking for  @option{--prefix} option), guess a value for it by looking for
2975  @var{program} in @code{PATH}, the way the shell does.  If @var{program}  @var{program} in @code{PATH}, the way the shell does.  If @var{program}
# Line 3053  These macros check for particular progra Line 3155  These macros check for particular progra
3155  in some cases whether they support certain features.  in some cases whether they support certain features.
3156    
3157  @defmac AC_PROG_AWK  @defmac AC_PROG_AWK
3158  @acindex PROG_AWK  @acindex{PROG_AWK}
3159  @ovindex AWK  @ovindex AWK
3160  Check for @code{gawk}, @code{mawk}, @code{nawk}, and @code{awk}, in that  Check for @code{gawk}, @code{mawk}, @code{nawk}, and @code{awk}, in that
3161  order, and set output variable @code{AWK} to the first one that is found.  order, and set output variable @code{AWK} to the first one that is found.
# Line 3062  best implementation. Line 3164  best implementation.
3164  @end defmac  @end defmac
3165    
3166  @defmac AC_PROG_EGREP  @defmac AC_PROG_EGREP
3167  @acindex PROG_EGREP  @acindex{PROG_EGREP}
3168  @ovindex EGREP  @ovindex EGREP
3169  Check for @code{grep -E} and @code{egrep}, in that order, and set  Check for @code{grep -E} and @code{egrep}, in that order, and set
3170  output variable @code{EGREP} to the first one that is found.  output variable @code{EGREP} to the first one that is found.
3171  @end defmac  @end defmac
3172    
3173  @defmac AC_PROG_FGREP  @defmac AC_PROG_FGREP
3174  @acindex PROG_FGREP  @acindex{PROG_FGREP}
3175  @ovindex FGREP  @ovindex FGREP
3176  Check for @code{grep -F} and @code{fgrep}, in that order, and set  Check for @code{grep -F} and @code{fgrep}, in that order, and set
3177  output variable @code{FGREP} to the first one that is found.  output variable @code{FGREP} to the first one that is found.
3178  @end defmac  @end defmac
3179    
3180  @defmac AC_PROG_INSTALL  @defmac AC_PROG_INSTALL
3181  @acindex PROG_INSTALL  @acindex{PROG_INSTALL}
3182  @ovindex INSTALL  @ovindex INSTALL
3183  @ovindex INSTALL_PROGRAM  @ovindex INSTALL_PROGRAM
3184  @ovindex INSTALL_DATA  @ovindex INSTALL_DATA
# Line 3111  not found in standard @code{install} pro Line 3213  not found in standard @code{install} pro
3213  @end defmac  @end defmac
3214    
3215  @defmac AC_PROG_LEX  @defmac AC_PROG_LEX
3216  @acindex PROG_LEX  @acindex{PROG_LEX}
3217  @ovindex LEX  @ovindex LEX
3218  @ovindex LEXLIB  @ovindex LEXLIB
3219  @cvindex YYTEXT_POINTER  @cvindex YYTEXT_POINTER
# Line 3156  of Automake will fix this issue; meanwhi Line 3258  of Automake will fix this issue; meanwhi
3258  @end defmac  @end defmac
3259    
3260  @defmac AC_PROG_LN_S  @defmac AC_PROG_LN_S
3261  @acindex PROG_LN_S  @acindex{PROG_LN_S}
3262  @ovindex LN_S  @ovindex LN_S
3263  If @samp{ln -s} works on the current file system (the operating system  If @samp{ln -s} works on the current file system (the operating system
3264  and file system support symbolic links), set the output variable  and file system support symbolic links), set the output variable
# Line 3182  Instead, do: Line 3284  Instead, do:
3284  @end defmac  @end defmac
3285    
3286  @defmac AC_PROG_RANLIB  @defmac AC_PROG_RANLIB
3287  @acindex PROG_RANLIB  @acindex{PROG_RANLIB}
3288  @ovindex RANLIB  @ovindex RANLIB
3289  Set output variable @code{RANLIB} to @samp{ranlib} if @code{ranlib}  Set output variable @code{RANLIB} to @samp{ranlib} if @code{ranlib}
3290  is found, and otherwise to @samp{:} (do nothing).  is found, and otherwise to @samp{:} (do nothing).
3291  @end defmac  @end defmac
3292    
3293  @defmac AC_PROG_YACC  @defmac AC_PROG_YACC
3294  @acindex PROG_YACC  @acindex{PROG_YACC}
3295  @ovindex YACC  @ovindex YACC
3296  If @code{bison} is found, set output variable @code{YACC} to @samp{bison  If @code{bison} is found, set output variable @code{YACC} to @samp{bison
3297  -y}.  Otherwise, if @code{byacc} is found, set @code{YACC} to  -y}.  Otherwise, if @code{byacc} is found, set @code{YACC} to
# Line 3217  You are strongly encouraged to declare t Line 3319  You are strongly encouraged to declare t
3319  @code{AC_ARG_VAR}, for more details.  @code{AC_ARG_VAR}, for more details.
3320    
3321  @defmac AC_CHECK_PROG (@var{variable}, @var{prog-to-check-for}, @var{value-if-found}, @ovar{value-if-not-found}, @ovar{path},  @ovar{reject})  @defmac AC_CHECK_PROG (@var{variable}, @var{prog-to-check-for}, @var{value-if-found}, @ovar{value-if-not-found}, @ovar{path},  @ovar{reject})
3322  @acindex CHECK_PROG  @acindex{CHECK_PROG}
3323  Check whether program @var{prog-to-check-for} exists in @code{PATH}.  If  Check whether program @var{prog-to-check-for} exists in @code{PATH}.  If
3324  it is found, set @var{variable} to @var{value-if-found}, otherwise to  it is found, set @var{variable} to @var{value-if-found}, otherwise to
3325  @var{value-if-not-found}, if given.  Always pass over @var{reject} (an  @var{value-if-not-found}, if given.  Always pass over @var{reject} (an
# Line 3229  that case, set @var{variable} using the Line 3331  that case, set @var{variable} using the
3331  @end defmac  @end defmac
3332    
3333  @defmac AC_CHECK_PROGS (@var{variable}, @var{progs-to-check-for}, @ovar{value-if-not-found}, @ovar{path})  @defmac AC_CHECK_PROGS (@var{variable}, @var{progs-to-check-for}, @ovar{value-if-not-found}, @ovar{path})
3334  @acindex CHECK_PROGS  @acindex{CHECK_PROGS}
3335  Check for each program in the whitespace-separated list  Check for each program in the whitespace-separated list
3336  @var{progs-to-check-for} existing in the @code{PATH}.  If one is found, set  @var{progs-to-check-for} existing in the @code{PATH}.  If one is found, set
3337  @var{variable} to the name of that program.  Otherwise, continue  @var{variable} to the name of that program.  Otherwise, continue
# Line 3240  is not changed.  Calls @code{AC_SUBST} f Line 3342  is not changed.  Calls @code{AC_SUBST} f
3342  @end defmac  @end defmac
3343    
3344  @defmac AC_CHECK_TOOL (@var{variable}, @var{prog-to-check-for}, @ovar{value-if-not-found}, @ovar{path})  @defmac AC_CHECK_TOOL (@var{variable}, @var{prog-to-check-for}, @ovar{value-if-not-found}, @ovar{path})
3345  @acindex CHECK_TOOL  @acindex{CHECK_TOOL}
3346  Like @code{AC_CHECK_PROG}, but first looks for @var{prog-to-check-for}  Like @code{AC_CHECK_PROG}, but first looks for @var{prog-to-check-for}
3347  with a prefix of the host type as determined by  with a prefix of the host type as determined by
3348  @code{AC_CANONICAL_HOST}, followed by a dash (@pxref{Canonicalizing}).  @code{AC_CANONICAL_HOST}, followed by a dash (@pxref{Canonicalizing}).
# Line 3256  sets @code{RANLIB} to @file{i386-gnu-ran Line 3358  sets @code{RANLIB} to @file{i386-gnu-ran
3358  @end defmac  @end defmac
3359    
3360  @defmac AC_CHECK_TOOLS (@var{variable}, @var{progs-to-check-for}, @ovar{value-if-not-found}, @ovar{path})  @defmac AC_CHECK_TOOLS (@var{variable}, @var{progs-to-check-for}, @ovar{value-if-not-found}, @ovar{path})
3361  @acindex CHECK_TOOLS  @acindex{CHECK_TOOLS}
3362  Like @code{AC_CHECK_TOOL}, each of the tools in the list  Like @code{AC_CHECK_TOOL}, each of the tools in the list
3363  @var{progs-to-check-for} are checked with a prefix of the host type as  @var{progs-to-check-for} are checked with a prefix of the host type as
3364  determined by @code{AC_CANONICAL_HOST}, followed by a dash  determined by @code{AC_CANONICAL_HOST}, followed by a dash
# Line 3269  is not changed.  Calls @code{AC_SUBST} f Line 3371  is not changed.  Calls @code{AC_SUBST} f
3371  @end defmac  @end defmac
3372    
3373  @defmac AC_PATH_PROG (@var{variable}, @var{prog-to-check-for}, @ovar{value-if-not-found}, @ovar{path})  @defmac AC_PATH_PROG (@var{variable}, @var{prog-to-check-for}, @ovar{value-if-not-found}, @ovar{path})
3374  @acindex PATH_PROG  @acindex{PATH_PROG}
3375  Like @code{AC_CHECK_PROG}, but set @var{variable} to the entire  Like @code{AC_CHECK_PROG}, but set @var{variable} to the entire
3376  path of @var{prog-to-check-for} if found.  path of @var{prog-to-check-for} if found.
3377  @end defmac  @end defmac
3378    
3379  @defmac AC_PATH_PROGS (@var{variable}, @var{progs-to-check-for}, @ovar{value-if-not-found}, @ovar{path})  @defmac AC_PATH_PROGS (@var{variable}, @var{progs-to-check-for}, @ovar{value-if-not-found}, @ovar{path})
3380  @acindex PATH_PROGS  @acindex{PATH_PROGS}
3381  Like @code{AC_CHECK_PROGS}, but if any of @var{progs-to-check-for}  Like @code{AC_CHECK_PROGS}, but if any of @var{progs-to-check-for}
3382  are found, set @var{variable} to the entire path of the program  are found, set @var{variable} to the entire path of the program
3383  found.  found.
3384  @end defmac  @end defmac
3385    
3386  @defmac AC_PATH_TOOL (@var{variable}, @var{prog-to-check-for}, @ovar{value-if-not-found}, @ovar{path})  @defmac AC_PATH_TOOL (@var{variable}, @var{prog-to-check-for}, @ovar{value-if-not-found}, @ovar{path})
3387  @acindex PATH_TOOL  @acindex{PATH_TOOL}
3388  Like @code{AC_CHECK_TOOL}, but set @var{variable} to the entire  Like @code{AC_CHECK_TOOL}, but set @var{variable} to the entire
3389  path of the program if it is found.  path of the program if it is found.
3390  @end defmac  @end defmac
# Line 3298  solution.  Be aware that, like most Auto Line 3400  solution.  Be aware that, like most Auto
3400  of the host machine, and therefore, they die when cross-compiling.  of the host machine, and therefore, they die when cross-compiling.
3401    
3402  @defmac AC_CHECK_FILE (@var{file}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_CHECK_FILE (@var{file}, @ovar{action-if-found}, @ovar{action-if-not-found})
3403  @acindex CHECK_FILE  @acindex{CHECK_FILE}
3404  Check whether file @var{file} exists on the native system.  If it is  Check whether file @var{file} exists on the native system.  If it is
3405  found, execute @var{action-if-found}, otherwise do  found, execute @var{action-if-found}, otherwise do
3406  @var{action-if-not-found}, if given.  @var{action-if-not-found}, if given.
3407  @end defmac  @end defmac
3408    
3409  @defmac AC_CHECK_FILES (@var{files}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_CHECK_FILES (@var{files}, @ovar{action-if-found}, @ovar{action-if-not-found})
3410  @acindex CHECK_FILES  @acindex{CHECK_FILES}
3411  Executes @code{AC_CHECK_FILE} once for each file listed in @var{files}.  Executes @code{AC_CHECK_FILE} once for each file listed in @var{files}.
3412  Additionally, defines @samp{HAVE_@var{file}} (@pxref{Standard Symbols})  Additionally, defines @samp{HAVE_@var{file}} (@pxref{Standard Symbols})
3413  for each file found.  for each file found.
# Line 3320  The following macros check for the prese Line 3422  The following macros check for the prese
3422  77 library archive files.  77 library archive files.
3423    
3424  @defmac AC_CHECK_LIB (@var{library}, @var{function}, @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{other-libraries})  @defmac AC_CHECK_LIB (@var{library}, @var{function}, @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{other-libraries})
3425  @acindex CHECK_LIB  @acindex{CHECK_LIB}
3426  Depending on the current language(@pxref{Language Choice}), try to  Depending on the current language(@pxref{Language Choice}), try to
3427  ensure that the C, C++, or Fortran 77 function @var{function} is  ensure that the C, C++, or Fortran 77 function @var{function} is
3428  available by checking whether a test program can be linked with the  available by checking whether a test program can be linked with the
# Line 3352  in the presence of another that is not a Line 3454  in the presence of another that is not a
3454    
3455    
3456  @defmac AC_SEARCH_LIBS (@var{function}, @var{search-libs}, @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{other-libraries})  @defmac AC_SEARCH_LIBS (@var{function}, @var{search-libs}, @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{other-libraries})
3457  @acindex SEARCH_LIBS  @acindex{SEARCH_LIBS}
3458  Search for a library defining @var{function} if it's not already  Search for a library defining @var{function} if it's not already
3459  available.  This equates to calling  available.  This equates to calling
3460  @samp{AC_LINK_IFELSE([AC_LANG_CALL([], [@var{function}])])} first with  @samp{AC_LINK_IFELSE([AC_LANG_CALL([], [@var{function}])])} first with
# Line 3505  These macros check for particular C func Line 3607  These macros check for particular C func
3607  in some cases how they respond when given certain arguments.  in some cases how they respond when given certain arguments.
3608    
3609  @defmac AC_FUNC_ALLOCA  @defmac AC_FUNC_ALLOCA
3610  @acindex FUNC_ALLOCA  @acindex{FUNC_ALLOCA}
3611  @cvindex C_ALLOCA  @cvindex C_ALLOCA
3612  @cvindex HAVE_ALLOCA_H  @cvindex HAVE_ALLOCA_H
3613  @ovindex ALLOCA  @ovindex ALLOCA
# Line 3560  char *alloca (); Line 3662  char *alloca ();
3662  @end defmac  @end defmac
3663    
3664  @defmac AC_FUNC_CHOWN  @defmac AC_FUNC_CHOWN
3665  @acindex FUNC_CHOWN  @acindex{FUNC_CHOWN}
3666  @c @fuindex chown  @c @fuindex chown
3667  @prindex @code{chown}  @prindex @code{chown}
3668  If the @code{chown} function is available and works (in particular, it  If the @code{chown} function is available and works (in particular, it
# Line 3570  should accept @option{-1} for @code{uid} Line 3672  should accept @option{-1} for @code{uid}
3672    
3673    
3674  @defmac AC_FUNC_CLOSEDIR_VOID  @defmac AC_FUNC_CLOSEDIR_VOID
3675  @acindex FUNC_CLOSEDIR_VOID  @acindex{FUNC_CLOSEDIR_VOID}
3676  @cvindex CLOSEDIR_VOID  @cvindex CLOSEDIR_VOID
3677  @c @fuindex closedir  @c @fuindex closedir
3678  @prindex @code{closedir}  @prindex @code{closedir}
# Line 3580  return value for an error indicator. Line 3682  return value for an error indicator.
3682  @end defmac  @end defmac
3683    
3684  @defmac AC_FUNC_ERROR_AT_LINE  @defmac AC_FUNC_ERROR_AT_LINE
3685  @acindex FUNC_ERROR_AT_LINE  @acindex{FUNC_ERROR_AT_LINE}
3686  @c @fuindex error_at_line  @c @fuindex error_at_line
3687  @prindex @code{error_at_line}  @prindex @code{error_at_line}
3688  If the @code{error_at_line} function is not found, require an  If the @code{error_at_line} function is not found, require an
# Line 3588  If the @code{error_at_line} function is Line 3690  If the @code{error_at_line} function is
3690  @end defmac  @end defmac
3691    
3692  @defmac AC_FUNC_FNMATCH  @defmac AC_FUNC_FNMATCH
3693  @acindex FUNC_FNMATCH  @acindex{FUNC_FNMATCH}
3694  @c @fuindex fnmatch  @c @fuindex fnmatch
3695  @prindex @code{fnmatch}  @prindex @code{fnmatch}
3696  If the @code{fnmatch} function conforms to @acronym{POSIX}, define  If the @code{fnmatch} function conforms to @acronym{POSIX}, define
# Line 3601  broken/missing @code{fnmatch}.  See @cod Line 3703  broken/missing @code{fnmatch}.  See @cod
3703  @end defmac  @end defmac
3704    
3705  @defmac AC_FUNC_FNMATCH_GNU  @defmac AC_FUNC_FNMATCH_GNU
3706  @acindex FUNC_FNMATCH_GNU  @acindex{FUNC_FNMATCH_GNU}
3707  @c @fuindex fnmatch  @c @fuindex fnmatch
3708  @prindex @code{fnmatch}  @prindex @code{fnmatch}
3709  Behave like @code{AC_REPLACE_FNMATCH} (@emph{replace}) but also test  Behave like @code{AC_REPLACE_FNMATCH} (@emph{replace}) but also test
# Line 3611  Library 2.1. Line 3713  Library 2.1.
3713  @end defmac  @end defmac
3714    
3715  @defmac AC_FUNC_FORK  @defmac AC_FUNC_FORK
3716  @acindex FUNC_FORK  @acindex{FUNC_FORK}
3717  @cvindex HAVE_VFORK_H  @cvindex HAVE_VFORK_H
3718  @cvindex HAVE_WORKING_FORK  @cvindex HAVE_WORKING_FORK
3719  @cvindex HAVE_WORKING_VFORK  @cvindex HAVE_WORKING_VFORK
# Line 3647  yourself in new code: Line 3749  yourself in new code:
3749  @end defmac  @end defmac
3750    
3751  @defmac AC_FUNC_FSEEKO  @defmac AC_FUNC_FSEEKO
3752  @acindex FUNC_FSEEKO  @acindex{FUNC_FSEEKO}
3753  @cvindex _LARGEFILE_SOURCE  @cvindex _LARGEFILE_SOURCE
3754  @c @fuindex fseeko  @c @fuindex fseeko
3755  @prindex @code{fseeko}  @prindex @code{fseeko}
# Line 3656  Define @code{_LARGEFILE_SOURCE} if neces Line 3758  Define @code{_LARGEFILE_SOURCE} if neces
3758  @end defmac  @end defmac
3759    
3760  @defmac AC_FUNC_GETGROUPS  @defmac AC_FUNC_GETGROUPS
3761  @acindex FUNC_GETGROUPS  @acindex{FUNC_GETGROUPS}
3762  @ovindex GETGROUPS_LIBS  @ovindex GETGROUPS_LIBS
3763  @c @fuindex getgroups  @c @fuindex getgroups
3764  @prindex @code{getgroups}  @prindex @code{getgroups}
# Line 3667  needed to get that function.  This macro Line 3769  needed to get that function.  This macro
3769  @end defmac  @end defmac
3770    
3771  @defmac AC_FUNC_GETLOADAVG  @defmac AC_FUNC_GETLOADAVG
3772  @acindex FUNC_GETLOADAVG  @acindex{FUNC_GETLOADAVG}
3773  @cvindex SVR4  @cvindex SVR4
3774  @cvindex DGUX  @cvindex DGUX
3775  @cvindex UMAX  @cvindex UMAX
# Line 3723  program. Line 3825  program.
3825  @end defmac  @end defmac
3826    
3827  @defmac AC_FUNC_GETMNTENT  @defmac AC_FUNC_GETMNTENT
3828  @acindex FUNC_GETMNTENT  @acindex{FUNC_GETMNTENT}
3829  @cvindex HAVE_GETMNTENT  @cvindex HAVE_GETMNTENT
3830  @c @fuindex getmntent  @c @fuindex getmntent
3831  @prindex @code{getmntent}  @prindex @code{getmntent}
# Line 3733  libraries, for @sc{irix} 4, PTX, and Uni Line 3835  libraries, for @sc{irix} 4, PTX, and Uni
3835  @end defmac  @end defmac
3836    
3837  @defmac AC_FUNC_GETPGRP  @defmac AC_FUNC_GETPGRP
3838  @acindex FUNC_GETPGRP  @acindex{FUNC_GETPGRP}
3839  @cvindex GETPGRP_VOID  @cvindex GETPGRP_VOID
3840  @c @fuindex getpgid  @c @fuindex getpgid
3841  @c @fuindex getpgrp  @c @fuindex getpgrp
# Line 3758  first call @code{AC_CHECK_FUNC} for @cod Line 3860  first call @code{AC_CHECK_FUNC} for @cod
3860  @end defmac  @end defmac
3861    
3862  @defmac AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK  @defmac AC_FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK
3863  @acindex FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK  @acindex{FUNC_LSTAT_FOLLOWS_SLASHED_SYMLINK}
3864  @cvindex LSTAT_FOLLOWS_SLASHED_SYMLINK  @cvindex LSTAT_FOLLOWS_SLASHED_SYMLINK
3865  @c @fuindex lstat  @c @fuindex lstat
3866  @prindex @code{lstat}  @prindex @code{lstat}
# Line 3776  If @code{lstat} behaves properly, define Line 3878  If @code{lstat} behaves properly, define
3878  @end defmac  @end defmac
3879    
3880  @defmac AC_FUNC_MALLOC  @defmac AC_FUNC_MALLOC
3881  @acindex FUNC_MALLOC  @acindex{FUNC_MALLOC}
3882  @cvindex HAVE_MALLOC  @cvindex HAVE_MALLOC
3883  @cvindex malloc  @cvindex malloc
3884  @c @fuindex malloc  @c @fuindex malloc
# Line 3815  rpl_malloc (size_t n) Line 3917  rpl_malloc (size_t n)
3917  @end defmac  @end defmac
3918    
3919  @defmac AC_FUNC_MEMCMP  @defmac AC_FUNC_MEMCMP
3920  @acindex FUNC_MEMCMP  @acindex{FUNC_MEMCMP}
3921  @ovindex LIBOBJS  @ovindex LIBOBJS
3922  @c @fuindex memcmp  @c @fuindex memcmp
3923  @prindex @code{memcmp}  @prindex @code{memcmp}
# Line 3827  boundary (such as the one on NeXT x86 Op Line 3929  boundary (such as the one on NeXT x86 Op
3929  @end defmac  @end defmac
3930    
3931  @defmac AC_FUNC_MBRTOWC  @defmac AC_FUNC_MBRTOWC
3932  @acindex FUNC_MBRTOWC  @acindex{FUNC_MBRTOWC}
3933  @cvindex HAVE_MBRTOWC  @cvindex HAVE_MBRTOWC
3934  @c @fuindex mbrtowc  @c @fuindex mbrtowc
3935  @prindex @code{mbrtowc}  @prindex @code{mbrtowc}
# Line 3836  type @code{mbstate_t} are properly decla Line 3938  type @code{mbstate_t} are properly decla
3938  @end defmac  @end defmac
3939    
3940  @defmac AC_FUNC_MKTIME  @defmac AC_FUNC_MKTIME
3941  @acindex FUNC_MKTIME  @acindex{FUNC_MKTIME}
3942  @ovindex LIBOBJS  @ovindex LIBOBJS
3943  @c @fuindex mktime  @c @fuindex mktime
3944  @prindex @code{mktime}  @prindex @code{mktime}
# Line 3845  correctly, require an @code{AC_LIBOBJ} r Line 3947  correctly, require an @code{AC_LIBOBJ} r
3947  @end defmac  @end defmac
3948    
3949  @defmac AC_FUNC_MMAP  @defmac AC_FUNC_MMAP
3950  @acindex FUNC_MMAP  @acindex{FUNC_MMAP}
3951  @cvindex HAVE_MMAP  @cvindex HAVE_MMAP
3952  @c @fuindex mmap  @c @fuindex mmap
3953  @prindex @code{mmap}  @prindex @code{mmap}
# Line 3855  memory. Line 3957  memory.
3957  @end defmac  @end defmac
3958    
3959  @defmac AC_FUNC_OBSTACK  @defmac AC_FUNC_OBSTACK
3960  @acindex FUNC_OBSTACK  @acindex{FUNC_OBSTACK}
3961  @cvindex HAVE_OBSTACK  @cvindex HAVE_OBSTACK
3962  @cindex obstack  @cindex obstack
3963  If the obstacks are found, define @code{HAVE_OBSTACK}, else require an  If the obstacks are found, define @code{HAVE_OBSTACK}, else require an
# Line 3863  If the obstacks are found, define @code{ Line 3965  If the obstacks are found, define @code{
3965  @end defmac  @end defmac
3966    
3967  @defmac AC_FUNC_REALLOC  @defmac AC_FUNC_REALLOC
3968  @acindex FUNC_REALLOC  @acindex{FUNC_REALLOC}
3969  @cvindex HAVE_REALLOC  @cvindex HAVE_REALLOC
3970  @cvindex realloc  @cvindex realloc
3971  @c @fuindex realloc  @c @fuindex realloc
# Line 3878  the native @code{realloc} is not used in Line 3980  the native @code{realloc} is not used in
3980  @end defmac  @end defmac
3981    
3982  @defmac AC_FUNC_SELECT_ARGTYPES  @defmac AC_FUNC_SELECT_ARGTYPES
3983  @acindex FUNC_SELECT_ARGTYPES  @acindex{FUNC_SELECT_ARGTYPES}
3984  @cvindex SELECT_TYPE_ARG1  @cvindex SELECT_TYPE_ARG1
3985  @cvindex SELECT_TYPE_ARG234  @cvindex SELECT_TYPE_ARG234
3986  @cvindex SELECT_TYPE_ARG5  @cvindex SELECT_TYPE_ARG5
# Line 3893  and @code{SELECT_TYPE_ARG5} defaults to Line 3995  and @code{SELECT_TYPE_ARG5} defaults to
3995  @end defmac  @end defmac
3996    
3997  @defmac AC_FUNC_SETPGRP  @defmac AC_FUNC_SETPGRP
3998  @acindex FUNC_SETPGRP  @acindex{FUNC_SETPGRP}
3999  @cvindex SETPGRP_VOID  @cvindex SETPGRP_VOID
4000  @c @fuindex setpgrp  @c @fuindex setpgrp
4001  @prindex @code{setpgrp}  @prindex @code{setpgrp}
# Line 3906  first call @code{AC_CHECK_FUNC} for @cod Line 4008  first call @code{AC_CHECK_FUNC} for @cod
4008    
4009  @defmac AC_FUNC_STAT  @defmac AC_FUNC_STAT
4010  @defmacx AC_FUNC_LSTAT  @defmacx AC_FUNC_LSTAT
4011  @acindex FUNC_STAT  @acindex{FUNC_STAT}
4012  @acindex FUNC_LSTAT  @acindex{FUNC_LSTAT}
4013  @cvindex HAVE_STAT_EMPTY_STRING_BUG  @cvindex HAVE_STAT_EMPTY_STRING_BUG
4014  @cvindex HAVE_LSTAT_EMPTY_STRING_BUG  @cvindex HAVE_LSTAT_EMPTY_STRING_BUG
4015  @c @fuindex stat  @c @fuindex stat
# Line 3925  replacement of it. Line 4027  replacement of it.
4027  @end defmac  @end defmac
4028    
4029  @defmac AC_FUNC_SETVBUF_REVERSED  @defmac AC_FUNC_SETVBUF_REVERSED
4030  @acindex FUNC_SETVBUF_REVERSED  @acindex{FUNC_SETVBUF_REVERSED}
4031  @cvindex SETVBUF_REVERSED  @cvindex SETVBUF_REVERSED
4032  @c @fuindex setvbuf  @c @fuindex setvbuf
4033  @prindex @code{setvbuf}  @prindex @code{setvbuf}
# Line 3935  the buffer pointer as the third, instead Line 4037  the buffer pointer as the third, instead
4037  @end defmac  @end defmac
4038    
4039  @defmac AC_FUNC_STRCOLL  @defmac AC_FUNC_STRCOLL
4040  @acindex FUNC_STRCOLL  @acindex{FUNC_STRCOLL}
4041  @cvindex HAVE_STRCOLL  @cvindex HAVE_STRCOLL
4042  @c @fuindex strcoll  @c @fuindex strcoll
4043  @prindex @code{strcoll}  @prindex @code{strcoll}
# Line 3946  definitions of @code{strcoll} that shoul Line 4048  definitions of @code{strcoll} that shoul
4048  @end defmac  @end defmac
4049    
4050  @defmac AC_FUNC_STRTOD  @defmac AC_FUNC_STRTOD
4051  @acindex FUNC_STRTOD  @acindex{FUNC_STRTOD}
4052  @ovindex POW_LIB  @ovindex POW_LIB
4053  @c @fuindex strtod  @c @fuindex strtod
4054  @prindex @code{strtod}  @prindex @code{strtod}
# Line 3957  variable @code{POW_LIB} to the extra lib Line 4059  variable @code{POW_LIB} to the extra lib
4059  @end defmac  @end defmac
4060    
4061  @defmac AC_FUNC_STRERROR_R  @defmac AC_FUNC_STRERROR_R
4062  @acindex FUNC_STRERROR_R  @acindex{FUNC_STRERROR_R}
4063  @cvindex HAVE_STRERROR_R  @cvindex HAVE_STRERROR_R
4064  @cvindex HAVE_DECL_STRERROR_R  @cvindex HAVE_DECL_STRERROR_R
4065  @cvindex STRERROR_R_CHAR_P  @cvindex STRERROR_R_CHAR_P
# Line 3974  the buffer argument. Line 4076  the buffer argument.
4076  @end defmac  @end defmac
4077    
4078  @defmac AC_FUNC_STRFTIME  @defmac AC_FUNC_STRFTIME
4079  @acindex FUNC_STRFTIME  @acindex{FUNC_STRFTIME}
4080  @cvindex HAVE_STRFTIME  @cvindex HAVE_STRFTIME
4081  @c @fuindex strftime  @c @fuindex strftime
4082  @prindex @code{strftime}  @prindex @code{strftime}
# Line 3983  Then, if @code{strftime} is available, d Line 4085  Then, if @code{strftime} is available, d
4085  @end defmac  @end defmac
4086    
4087  @defmac AC_FUNC_STRNLEN  @defmac AC_FUNC_STRNLEN
4088  @acindex FUNC_STRNLEN  @acindex{FUNC_STRNLEN}
4089  @cvindex HAVE_STRNLEN  @cvindex HAVE_STRNLEN
4090  @c @fuindex strnlen  @c @fuindex strnlen
4091  @prindex @code{strnlen}  @prindex @code{strnlen}
# Line 3992  from @acronym{AIX} 4.3), require an @cod Line 4094  from @acronym{AIX} 4.3), require an @cod
4094  @end defmac  @end defmac
4095    
4096  @defmac AC_FUNC_UTIME_NULL  @defmac AC_FUNC_UTIME_NULL
4097  @acindex FUNC_UTIME_NULL  @acindex{FUNC_UTIME_NULL}
4098  @cvindex HAVE_UTIME_NULL  @cvindex HAVE_UTIME_NULL
4099  @c @fuindex utime  @c @fuindex utime
4100  @prindex @code{utime}  @prindex @code{utime}
# Line 4001  the present, define @code{HAVE_UTIME_NUL Line 4103  the present, define @code{HAVE_UTIME_NUL
4103  @end defmac  @end defmac
4104    
4105  @defmac AC_FUNC_VPRINTF  @defmac AC_FUNC_VPRINTF
4106  @acindex FUNC_VPRINTF  @acindex{FUNC_VPRINTF}
4107  @cvindex HAVE_VPRINTF  @cvindex HAVE_VPRINTF
4108  @cvindex HAVE_DOPRNT  @cvindex HAVE_DOPRNT
4109  @c @fuindex vprintf  @c @fuindex vprintf
# Line 4013  are also available.) Line 4115  are also available.)
4115  @end defmac  @end defmac
4116    
4117  @defmac AC_REPLACE_FNMATCH  @defmac AC_REPLACE_FNMATCH
4118  @acindex REPLACE_FNMATCH  @acindex{REPLACE_FNMATCH}
4119  @c @fuindex fnmatch  @c @fuindex fnmatch
4120  @prindex @code{fnmatch}  @prindex @code{fnmatch}
4121  If the @code{fnmatch} function does not conform to @acronym{POSIX} (see  If the @code{fnmatch} function does not conform to @acronym{POSIX} (see
# Line 4040  whether it is present, you have to write Line 4142  whether it is present, you have to write
4142  it (@pxref{Writing Tests}).  it (@pxref{Writing Tests}).
4143    
4144  @defmac AC_CHECK_FUNC (@var{function}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_CHECK_FUNC (@var{function}, @ovar{action-if-found}, @ovar{action-if-not-found})
4145  @acindex CHECK_FUNC  @acindex{CHECK_FUNC}
4146  If C function @var{function} is available, run shell commands  If C function @var{function} is available, run shell commands
4147  @var{action-if-found}, otherwise @var{action-if-not-found}.  If you just  @var{action-if-found}, otherwise @var{action-if-not-found}.  If you just
4148  want to define a symbol if the function is available, consider using  want to define a symbol if the function is available, consider using
# Line 4051  about selecting the language for checks. Line 4153  about selecting the language for checks.
4153  @end defmac  @end defmac
4154    
4155  @defmac AC_CHECK_FUNCS (@var{function}@dots{}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_CHECK_FUNCS (@var{function}@dots{}, @ovar{action-if-found}, @ovar{action-if-not-found})
4156  @acindex CHECK_FUNCS  @acindex{CHECK_FUNCS}
4157  @cvindex HAVE_@var{function}  @cvindex HAVE_@var{function}
4158  For each @var{function} in the whitespace-separated argument list,  For each @var{function} in the whitespace-separated argument list,
4159  define @code{HAVE_@var{function}} (in all capitals) if it is available.  define @code{HAVE_@var{function}} (in all capitals) if it is available.
# Line 4071  environment.  Some functions may be miss Line 4173  environment.  Some functions may be miss
4173  package must be ready to replace them.  package must be ready to replace them.
4174    
4175  @defmac AC_LIBOBJ (@var{function})  @defmac AC_LIBOBJ (@var{function})
4176  @acindex LIBOBJ  @acindex{LIBOBJ}
4177  @ovindex LIBOBJS  @ovindex LIBOBJS
4178  Specify that @samp{@var{function}.c} must be included in the executables  Specify that @samp{@var{function}.c} must be included in the executables
4179  to replace a missing or broken implementation of @var{function}.  to replace a missing or broken implementation of @var{function}.
# Line 4083  since this is not traceable. Line 4185  since this is not traceable.
4185  @end defmac  @end defmac
4186    
4187  @defmac AC_LIBSOURCE (@var{file})  @defmac AC_LIBSOURCE (@var{file})
4188  @acindex LIBSOURCE  @acindex{LIBSOURCE}
4189  Specify that @var{file} might be needed to compile the project.  If you  Specify that @var{file} might be needed to compile the project.  If you
4190  need to know what files might be needed by a @file{configure.ac}, you  need to know what files might be needed by a @file{configure.ac}, you
4191  should trace @code{AC_LIBSOURCE}.  @var{file} must be a literal.  should trace @code{AC_LIBSOURCE}.  @var{file} must be a literal.
# Line 4112  e.g., @code{foo}, as its argument rather Line 4214  e.g., @code{foo}, as its argument rather
4214  @end defmac  @end defmac
4215    
4216  @defmac AC_LIBSOURCES (@var{files})  @defmac AC_LIBSOURCES (@var{files})
4217  @acindex LIBSOURCES  @acindex{LIBSOURCES}
4218  Like @code{AC_LIBSOURCE}, but accepts one or more @var{files} in a  Like @code{AC_LIBSOURCE}, but accepts one or more @var{files} in a
4219  comma-separated M4 list.  Thus, the above example might be rewritten:  comma-separated M4 list.  Thus, the above example might be rewritten:
4220    
# Line 4123  AC_LIBOBJ($foo_or_bar) Line 4225  AC_LIBOBJ($foo_or_bar)
4225  @end defmac  @end defmac
4226    
4227  @defmac AC_CONFIG_LIBOBJ_DIR (@var{directory})  @defmac AC_CONFIG_LIBOBJ_DIR (@var{directory})
4228  @acindex CONFIG_LIBOBJ_DIR  @acindex{CONFIG_LIBOBJ_DIR}
4229  Specify that @code{AC_LIBOBJ} replacement files are to be found in  Specify that @code{AC_LIBOBJ} replacement files are to be found in
4230  @var{directory}, a relative path starting from the top level of the  @var{directory}, a relative path starting from the top level of the
4231  source tree.  The replacement directory defaults to @file{.}, the top  source tree.  The replacement directory defaults to @file{.}, the top
# Line 4143  for its @code{AC_LIBOBJ} replacement if Line 4245  for its @code{AC_LIBOBJ} replacement if
4245  a convenient shorthand.  a convenient shorthand.
4246    
4247  @defmac AC_REPLACE_FUNCS (@var{function}@dots{})  @defmac AC_REPLACE_FUNCS (@var{function}@dots{})
4248  @acindex REPLACE_FUNCS  @acindex{REPLACE_FUNCS}
4249  @ovindex LIBOBJS  @ovindex LIBOBJS
4250  Like @code{AC_CHECK_FUNCS}, but uses @samp{AC_LIBOBJ(@var{function})} as  Like @code{AC_CHECK_FUNCS}, but uses @samp{AC_LIBOBJ(@var{function})} as
4251  @var{action-if-not-found}.  You can declare your replacement function by  @var{action-if-not-found}.  You can declare your replacement function by
# Line 4194  These macros check for particular system Line 4296  These macros check for particular system
4296  exist, and in some cases whether they declare certain symbols.  exist, and in some cases whether they declare certain symbols.
4297    
4298  @defmac AC_HEADER_DIRENT  @defmac AC_HEADER_DIRENT
4299  @acindex HEADER_DIRENT  @acindex{HEADER_DIRENT}
4300  @cvindex HAVE_DIRENT_H  @cvindex HAVE_DIRENT_H
4301  @cvindex HAVE_NDIR_H  @cvindex HAVE_NDIR_H
4302  @cvindex HAVE_SYS_DIR_H  @cvindex HAVE_SYS_DIR_H
# Line 4242  This macro also checks for the SCO Xenix Line 4344  This macro also checks for the SCO Xenix
4344  @end defmac  @end defmac
4345    
4346  @defmac AC_HEADER_MAJOR  @defmac AC_HEADER_MAJOR
4347  @acindex HEADER_MAJOR  @acindex{HEADER_MAJOR}
4348  @cvindex MAJOR_IN_MKDEV  @cvindex MAJOR_IN_MKDEV
4349  @cvindex MAJOR_IN_SYSMACROS  @cvindex MAJOR_IN_SYSMACROS
4350  If @file{sys/types.h} does not define @code{major}, @code{minor}, and  If @file{sys/types.h} does not define @code{major}, @code{minor}, and
# Line 4253  If @file{sys/types.h} does not define @c Line 4355  If @file{sys/types.h} does not define @c
4355    
4356    
4357  @defmac AC_HEADER_STAT  @defmac AC_HEADER_STAT
4358  @acindex HEADER_STAT  @acindex{HEADER_STAT}
4359  @acindex STAT_MACROS_BROKEN  @acindex{STAT_MACROS_BROKEN}
4360  If the macros @code{S_ISDIR}, @code{S_ISREG}, etc.@: defined in  If the macros @code{S_ISDIR}, @code{S_ISREG}, etc.@: defined in
4361  @file{sys/stat.h} do not work properly (returning false positives),  @file{sys/stat.h} do not work properly (returning false positives),
4362  define @code{STAT_MACROS_BROKEN}.  This is the case on Tektronix UTekV,  define @code{STAT_MACROS_BROKEN}.  This is the case on Tektronix UTekV,
# Line 4262  Amdahl UTS and Motorola System V/88. Line 4364  Amdahl UTS and Motorola System V/88.
4364  @end defmac  @end defmac
4365    
4366  @defmac AC_HEADER_STDBOOL  @defmac AC_HEADER_STDBOOL
4367  @acindex HEADER_STDBOOL  @acindex{HEADER_STDBOOL}
4368  @cvindex HAVE_STDBOOL_H  @cvindex HAVE_STDBOOL_H
4369  @cvindex HAVE__BOOL  @cvindex HAVE__BOOL
4370  If @file{stdbool.h} exists and is conformant to C99, define  If @file{stdbool.h} exists and is conformant to C99, define
# Line 4291  typedef unsigned char _Bool; Line 4393  typedef unsigned char _Bool;
4393    
4394    
4395  @defmac AC_HEADER_STDC  @defmac AC_HEADER_STDC
4396  @acindex HEADER_STDC  @acindex{HEADER_STDC}
4397  @cvindex STDC_HEADERS  @cvindex STDC_HEADERS
4398  Define @code{STDC_HEADERS} if the system has @acronym{ANSI} C header files.  Define @code{STDC_HEADERS} if the system has @acronym{ANSI} C header files.
4399  Specifically, this macro checks for @file{stdlib.h}, @file{stdarg.h},  Specifically, this macro checks for @file{stdlib.h}, @file{stdarg.h},
# Line 4358  for example, put it in @file{memchr.c} a Line 4460  for example, put it in @file{memchr.c} a
4460  @end defmac  @end defmac
4461    
4462  @defmac AC_HEADER_SYS_WAIT  @defmac AC_HEADER_SYS_WAIT
4463  @acindex HEADER_SYS_WAIT  @acindex{HEADER_SYS_WAIT}
4464  @cvindex HAVE_SYS_WAIT_H  @cvindex HAVE_SYS_WAIT_H
4465  If @file{sys/wait.h} exists and is compatible with @acronym{POSIX}, define  If @file{sys/wait.h} exists and is compatible with @acronym{POSIX}, define
4466  @code{HAVE_SYS_WAIT_H}.  Incompatibility can occur if @file{sys/wait.h}  @code{HAVE_SYS_WAIT_H}.  Incompatibility can occur if @file{sys/wait.h}
# Line 4406  The way to check if the system supports Line 4508  The way to check if the system supports
4508  @end example  @end example
4509    
4510  @defmac AC_HEADER_TIME  @defmac AC_HEADER_TIME
4511  @acindex HEADER_TIME  @acindex{HEADER_TIME}
4512  @cvindex TIME_WITH_SYS_TIME  @cvindex TIME_WITH_SYS_TIME
4513  If a program may include both @file{time.h} and @file{sys/time.h},  If a program may include both @file{time.h} and @file{sys/time.h},
4514  define @code{TIME_WITH_SYS_TIME}.  On some older systems,  define @code{TIME_WITH_SYS_TIME}.  On some older systems,
# Line 4436  example, @code{struct timeval} as well a Line 4538  example, @code{struct timeval} as well a
4538    
4539    
4540  @defmac AC_HEADER_TIOCGWINSZ  @defmac AC_HEADER_TIOCGWINSZ
4541  @acindex HEADER_TIOCGWINSZ  @acindex{HEADER_TIOCGWINSZ}
4542  @cvindex GWINSZ_IN_SYS_IOCTL  @cvindex GWINSZ_IN_SYS_IOCTL
4543  @c FIXME: I need clarifications from Jim.  @c FIXME: I need clarifications from Jim.
4544  If the use of @code{TIOCGWINSZ} requires @file{<sys/ioctl.h>}, then  If the use of @code{TIOCGWINSZ} requires @file{<sys/ioctl.h>}, then
# Line 4467  as well as find out whether it is presen Line 4569  as well as find out whether it is presen
4569  test for it (@pxref{Writing Tests}).  test for it (@pxref{Writing Tests}).
4570    
4571  @defmac AC_CHECK_HEADER (@var{header-file}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})  @defmac AC_CHECK_HEADER (@var{header-file}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})
4572  @acindex CHECK_HEADER  @acindex{CHECK_HEADER}
4573  If the system header file @var{header-file} is compilable, execute shell  If the system header file @var{header-file} is compilable, execute shell
4574  commands @var{action-if-found}, otherwise execute  commands @var{action-if-found}, otherwise execute
4575  @var{action-if-not-found}.  If you just want to define a symbol if the  @var{action-if-not-found}.  If you just want to define a symbol if the
# Line 4479  below. Line 4581  below.
4581  @end defmac  @end defmac
4582    
4583  @defmac AC_CHECK_HEADERS (@var{header-file}@dots{}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})  @defmac AC_CHECK_HEADERS (@var{header-file}@dots{}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})
4584  @acindex CHECK_HEADERS  @acindex{CHECK_HEADERS}
4585  @cvindex HAVE_@var{header}  @cvindex HAVE_@var{header}
4586  For each given system header file @var{header-file} in the  For each given system header file @var{header-file} in the
4587  whitespace-separated argument list that exists, define  whitespace-separated argument list that exists, define
# Line 4544  These macros are used to find declaratio Line 4646  These macros are used to find declaratio
4646  test macros.  test macros.
4647    
4648  @defmac AC_CHECK_DECL (@var{symbol}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})  @defmac AC_CHECK_DECL (@var{symbol}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})
4649  @acindex CHECK_DECL  @acindex{CHECK_DECL}
4650  If @var{symbol} (a function or a variable) is not declared in  If @var{symbol} (a function or a variable) is not declared in
4651  @var{includes} and a declaration is needed, run the shell commands  @var{includes} and a declaration is needed, run the shell commands
4652  @var{action-if-not-found}, otherwise @var{action-if-found}.  If no  @var{action-if-not-found}, otherwise @var{action-if-found}.  If no
# Line 4557  introducing extra declarations when they Line 4659  introducing extra declarations when they
4659  @end defmac  @end defmac
4660    
4661  @defmac AC_CHECK_DECLS (@var{symbols}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})  @defmac AC_CHECK_DECLS (@var{symbols}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})
4662  @acindex CHECK_DECLS  @acindex{CHECK_DECLS}
4663  @cvindex HAVE_DECL_@var{symbol}  @cvindex HAVE_DECL_@var{symbol}
4664  For each of the @var{symbols} (@emph{comma}-separated list), define  For each of the @var{symbols} (@emph{comma}-separated list), define
4665  @code{HAVE_DECL_@var{symbol}} (in all capitals) to @samp{1} if  @code{HAVE_DECL_@var{symbol}} (in all capitals) to @samp{1} if
# Line 4624  member you need, then you can use the ge Line 4726  member you need, then you can use the ge
4726  The following macros check for certain structures or structure members.  The following macros check for certain structures or structure members.
4727    
4728  @defmac AC_STRUCT_ST_BLKSIZE  @defmac AC_STRUCT_ST_BLKSIZE
4729  @acindex STRUCT_ST_BLKSIZE  @acindex{STRUCT_ST_BLKSIZE}
4730  @cvindex HAVE_STRUCT_STAT_ST_BLKSIZE  @cvindex HAVE_STRUCT_STAT_ST_BLKSIZE
4731  @cvindex HAVE_ST_BLKSIZE  @cvindex HAVE_ST_BLKSIZE
4732  If @code{struct stat} contains an @code{st_blksize} member, define  If @code{struct stat} contains an @code{st_blksize} member, define
# Line 4638  AC_CHECK_MEMBERS([struct stat.st_blksize Line 4740  AC_CHECK_MEMBERS([struct stat.st_blksize
4740  @end defmac  @end defmac
4741    
4742  @defmac AC_STRUCT_ST_BLOCKS  @defmac AC_STRUCT_ST_BLOCKS
4743  @acindex STRUCT_ST_BLOCKS  @acindex{STRUCT_ST_BLOCKS}
4744  @cvindex HAVE_STRUCT_STAT_ST_BLOCKS  @cvindex HAVE_STRUCT_STAT_ST_BLOCKS
4745  @cvindex HAVE_ST_BLOCKS  @cvindex HAVE_ST_BLOCKS
4746  @ovindex LIBOBJS  @ovindex LIBOBJS
# Line 4650  future. Line 4752  future.
4752  @end defmac  @end defmac
4753    
4754  @defmac AC_STRUCT_ST_RDEV  @defmac AC_STRUCT_ST_RDEV
4755  @acindex STRUCT_ST_RDEV  @acindex{STRUCT_ST_RDEV}
4756  @cvindex HAVE_ST_RDEV  @cvindex HAVE_ST_RDEV
4757  @cvindex HAVE_STRUCT_STAT_ST_RDEV  @cvindex HAVE_STRUCT_STAT_ST_RDEV
4758  If @code{struct stat} contains an @code{st_rdev} member, define  If @code{struct stat} contains an @code{st_rdev} member, define
# Line 4664  AC_CHECK_MEMBERS([struct stat.st_rdev]) Line 4766  AC_CHECK_MEMBERS([struct stat.st_rdev])
4766  @end defmac  @end defmac
4767    
4768  @defmac AC_STRUCT_TM  @defmac AC_STRUCT_TM
4769  @acindex STRUCT_TM  @acindex{STRUCT_TM}
4770  @cvindex TM_IN_SYS_TIME  @cvindex TM_IN_SYS_TIME
4771  If @file{time.h} does not define @code{struct tm}, define  If @file{time.h} does not define @code{struct tm}, define
4772  @code{TM_IN_SYS_TIME}, which means that including @file{sys/time.h}  @code{TM_IN_SYS_TIME}, which means that including @file{sys/time.h}
# Line 4672  had better define @code{struct tm}. Line 4774  had better define @code{struct tm}.
4774  @end defmac  @end defmac
4775    
4776  @defmac AC_STRUCT_TIMEZONE  @defmac AC_STRUCT_TIMEZONE
4777  @acindex STRUCT_TIMEZONE  @acindex{STRUCT_TIMEZONE}
4778  @cvindex HAVE_TM_ZONE  @cvindex HAVE_TM_ZONE
4779  @cvindex HAVE_TZNAME  @cvindex HAVE_TZNAME
4780  Figure out how to get the current timezone.  If @code{struct tm} has a  Figure out how to get the current timezone.  If @code{struct tm} has a
# Line 4688  These macros are used to find structure Line 4790  These macros are used to find structure
4790  ``particular'' test macros.  ``particular'' test macros.
4791    
4792  @defmac AC_CHECK_MEMBER (@var{aggregate}.@var{member}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})  @defmac AC_CHECK_MEMBER (@var{aggregate}.@var{member}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})
4793  @acindex CHECK_MEMBER  @acindex{CHECK_MEMBER}
4794  Check whether @var{member} is a member of the aggregate @var{aggregate}.  Check whether @var{member} is a member of the aggregate @var{aggregate}.
4795  If no @var{includes} are specified, the default includes are used  If no @var{includes} are specified, the default includes are used
4796  (@pxref{Default Includes}).  (@pxref{Default Includes}).
# Line 4707  AC_CHECK_MEMBER(struct top.middle.bot) Line 4809  AC_CHECK_MEMBER(struct top.middle.bot)
4809  @end defmac  @end defmac
4810    
4811  @defmac AC_CHECK_MEMBERS (@var{members}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})  @defmac AC_CHECK_MEMBERS (@var{members}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})
4812  @acindex CHECK_MEMBERS  @acindex{CHECK_MEMBERS}
4813  Check for the existence of each @samp{@var{aggregate}.@var{member}} of  Check for the existence of each @samp{@var{aggregate}.@var{member}} of
4814  @var{members} using the previous macro.  When @var{member} belongs to  @var{members} using the previous macro.  When @var{member} belongs to
4815  @var{aggregate}, define @code{HAVE_@var{aggregate}_@var{member}} (in all  @var{aggregate}, define @code{HAVE_@var{aggregate}_@var{member}} (in all
# Line 4740  These macros check for particular C type Line 4842  These macros check for particular C type
4842  @file{stdlib.h} and others, if they exist.  @file{stdlib.h} and others, if they exist.
4843    
4844  @defmac AC_TYPE_GETGROUPS  @defmac AC_TYPE_GETGROUPS
4845  @acindex TYPE_GETGROUPS  @acindex{TYPE_GETGROUPS}
4846  @cvindex GETGROUPS_T  @cvindex GETGROUPS_T
4847  Define @code{GETGROUPS_T} to be whichever of @code{gid_t} or @code{int}  Define @code{GETGROUPS_T} to be whichever of @code{gid_t} or @code{int}
4848  is the base type of the array argument to @code{getgroups}.  is the base type of the array argument to @code{getgroups}.
4849  @end defmac  @end defmac
4850    
4851  @defmac AC_TYPE_MBSTATE_T  @defmac AC_TYPE_MBSTATE_T
4852  @acindex TYPE_MBSTATE_T  @acindex{TYPE_MBSTATE_T}
4853  @cvindex mbstate_t  @cvindex mbstate_t
4854  Define @code{HAVE_MBSTATE_T} if @code{<wchar.h>} declares the  Define @code{HAVE_MBSTATE_T} if @code{<wchar.h>} declares the
4855  @code{mbstate_t} type.  Also, define @code{mbstate_t} to be a type if  @code{mbstate_t} type.  Also, define @code{mbstate_t} to be a type if
# Line 4755  Define @code{HAVE_MBSTATE_T} if @code{<w Line 4857  Define @code{HAVE_MBSTATE_T} if @code{<w
4857  @end defmac  @end defmac
4858    
4859  @defmac AC_TYPE_MODE_T  @defmac AC_TYPE_MODE_T
4860  @acindex TYPE_MODE_T  @acindex{TYPE_MODE_T}
4861  @cvindex mode_t  @cvindex mode_t
4862  Equivalent to @samp{AC_CHECK_TYPE(mode_t, int)}.  Equivalent to @samp{AC_CHECK_TYPE(mode_t, int)}.
4863  @end defmac  @end defmac
4864    
4865  @defmac AC_TYPE_OFF_T  @defmac AC_TYPE_OFF_T
4866  @acindex TYPE_OFF_T  @acindex{TYPE_OFF_T}
4867  @cvindex off_t  @cvindex off_t
4868  Equivalent to @samp{AC_CHECK_TYPE(off_t, long)}.  Equivalent to @samp{AC_CHECK_TYPE(off_t, long)}.
4869  @end defmac  @end defmac
4870    
4871  @defmac AC_TYPE_PID_T  @defmac AC_TYPE_PID_T
4872  @acindex TYPE_PID_T  @acindex{TYPE_PID_T}
4873  @cvindex pid_t  @cvindex pid_t
4874  Equivalent to @samp{AC_CHECK_TYPE(pid_t, int)}.  Equivalent to @samp{AC_CHECK_TYPE(pid_t, int)}.
4875  @end defmac  @end defmac
4876    
4877  @defmac AC_TYPE_SIGNAL  @defmac AC_TYPE_SIGNAL
4878  @acindex TYPE_SIGNAL  @acindex{TYPE_SIGNAL}
4879  @cvindex RETSIGTYPE  @cvindex RETSIGTYPE
4880  If @file{signal.h} declares @code{signal} as returning a pointer to a  If @file{signal.h} declares @code{signal} as returning a pointer to a
4881  function returning @code{void}, define @code{RETSIGTYPE} to be  function returning @code{void}, define @code{RETSIGTYPE} to be
# Line 4793  hup_handler () Line 4895  hup_handler ()
4895  @end defmac  @end defmac
4896    
4897  @defmac AC_TYPE_SIZE_T  @defmac AC_TYPE_SIZE_T
4898  @acindex TYPE_SIZE_T  @acindex{TYPE_SIZE_T}
4899  @cvindex size_t  @cvindex size_t
4900  Equivalent to @samp{AC_CHECK_TYPE(size_t, unsigned)}.  Equivalent to @samp{AC_CHECK_TYPE(size_t, unsigned)}.
4901  @end defmac  @end defmac
4902    
4903  @defmac AC_TYPE_UID_T  @defmac AC_TYPE_UID_T
4904  @acindex TYPE_UID_T  @acindex{TYPE_UID_T}
4905  @cvindex uid_t  @cvindex uid_t
4906  @cvindex gid_t  @cvindex gid_t
4907  If @code{uid_t} is not defined, define @code{uid_t} to be @code{int} and  If @code{uid_t} is not defined, define @code{uid_t} to be @code{int} and
# Line 4813  These macros are used to check for types Line 4915  These macros are used to check for types
4915  test macros.  test macros.
4916    
4917  @defmac AC_CHECK_TYPE (@var{type}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})  @defmac AC_CHECK_TYPE (@var{type}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})
4918  @acindex CHECK_TYPE  @acindex{CHECK_TYPE}
4919  Check whether @var{type} is defined.  It may be a compiler builtin type  Check whether @var{type} is defined.  It may be a compiler builtin type
4920  or defined by the @var{includes} (@pxref{Default Includes}).  or defined by the @var{includes} (@pxref{Default Includes}).
4921  @end defmac  @end defmac
4922    
4923    
4924  @defmac AC_CHECK_TYPES (@var{types}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})  @defmac AC_CHECK_TYPES (@var{types}, @ovar{action-if-found}, @ovar{action-if-not-found}, @dvar{includes, default-includes})
4925  @acindex CHECK_TYPES  @acindex{CHECK_TYPES}
4926  For each @var{type} of the @var{types} that is defined, define  For each @var{type} of the @var{types} that is defined, define
4927  @code{HAVE_@var{type}} (in all capitals).  If no @var{includes} are  @code{HAVE_@var{type}} (in all capitals).  If no @var{includes} are
4928  specified, the default includes are used (@pxref{Default Includes}).  If  specified, the default includes are used (@pxref{Default Includes}).  If
# Line 4911  Autoconf works around this problem by ca Line 5013  Autoconf works around this problem by ca
5013  @subsection Generic Compiler Characteristics  @subsection Generic Compiler Characteristics
5014    
5015  @defmac AC_CHECK_SIZEOF (@var{type}, @ovar{unused}, @dvar{includes, default-includes})  @defmac AC_CHECK_SIZEOF (@var{type}, @ovar{unused}, @dvar{includes, default-includes})
5016  @acindex CHECK_SIZEOF  @acindex{CHECK_SIZEOF}
5017  Define @code{SIZEOF_@var{type}} (@pxref{Standard Symbols}) to be the  Define @code{SIZEOF_@var{type}} (@pxref{Standard Symbols}) to be the
5018  size in bytes of @var{type}.  If @samp{type} is unknown, it gets a size  size in bytes of @var{type}.  If @samp{type} is unknown, it gets a size
5019  of 0.  If no @var{includes} are specified, the default includes are used  of 0.  If no @var{includes} are specified, the default includes are used
# Line 4995  makes this invalid.  That is the reason Line 5097  makes this invalid.  That is the reason
5097  @end table  @end table
5098    
5099  @defmac AC_PROG_CC (@ovar{compiler-search-list})  @defmac AC_PROG_CC (@ovar{compiler-search-list})
5100  @acindex PROG_CC  @acindex{PROG_CC}
5101  @ovindex CC  @ovindex CC
5102  @ovindex CFLAGS  @ovindex CFLAGS
5103  Determine a C compiler to use.  If @code{CC} is not already set in the  Determine a C compiler to use.  If @code{CC} is not already set in the
# Line 5034  where GCC does not accept @option{-g}), Line 5136  where GCC does not accept @option{-g}),
5136  @end defmac  @end defmac
5137    
5138  @defmac AC_PROG_CC_C_O  @defmac AC_PROG_CC_C_O
5139  @acindex PROG_CC_C_O  @acindex{PROG_CC_C_O}
5140  @cvindex NO_MINUS_C_MINUS_O  @cvindex NO_MINUS_C_MINUS_O
5141  If the C compiler does not accept the @option{-c} and @option{-o} options  If the C compiler does not accept the @option{-c} and @option{-o} options
5142  simultaneously, define @code{NO_MINUS_C_MINUS_O}.  This macro actually  simultaneously, define @code{NO_MINUS_C_MINUS_O}.  This macro actually
# Line 5046  rule. Line 5148  rule.
5148    
5149    
5150  @defmac AC_PROG_CPP  @defmac AC_PROG_CPP
5151  @acindex PROG_CPP  @acindex{PROG_CPP}
5152  @ovindex CPP  @ovindex CPP
5153  Set output variable @code{CPP} to a command that runs the  Set output variable @code{CPP} to a command that runs the
5154  C preprocessor.  If @samp{$CC -E} doesn't work, @file{/lib/cpp} is used.  C preprocessor.  If @samp{$CC -E} doesn't work, @file{/lib/cpp} is used.
# Line 5066  features.  To check for characteristics Line 5168  features.  To check for characteristics
5168  @code{AC_RUN_IFELSE} (@pxref{Run Time}).  @code{AC_RUN_IFELSE} (@pxref{Run Time}).
5169    
5170  @defmac AC_C_BACKSLASH_A  @defmac AC_C_BACKSLASH_A
5171  @acindex HAVE_C_BACKSLASH_A  @acindex{HAVE_C_BACKSLASH_A}
5172  Define @samp{HAVE_C_BACKSLASH_A} to 1 if the C compiler understands  Define @samp{HAVE_C_BACKSLASH_A} to 1 if the C compiler understands
5173  @samp{\a}.  @samp{\a}.
5174  @end defmac  @end defmac
5175    
5176  @defmac AC_C_BIGENDIAN (@ovar{action-if-true}, @ovar{action-if-false}, @ovar{action-if-unknown})  @defmac AC_C_BIGENDIAN (@ovar{action-if-true}, @ovar{action-if-false}, @ovar{action-if-unknown})
5177  @acindex C_BIGENDIAN  @acindex{C_BIGENDIAN}
5178  @cvindex WORDS_BIGENDIAN  @cvindex WORDS_BIGENDIAN
5179  @cindex Endianness  @cindex Endianness
5180  If words are stored with the most significant byte first (like Motorola  If words are stored with the most significant byte first (like Motorola
# Line 5093  to bypass this test. Line 5195  to bypass this test.
5195  @end defmac  @end defmac
5196    
5197  @defmac AC_C_CONST  @defmac AC_C_CONST
5198  @acindex C_CONST  @acindex{C_CONST}
5199  @cvindex const  @cvindex const
5200  If the C compiler does not fully support the @acronym{ANSI} C qualifier  If the C compiler does not fully support the @acronym{ANSI} C qualifier
5201  @code{const}, define @code{const} to be empty.  Some C compilers that do  @code{const}, define @code{const} to be empty.  Some C compilers that do
# Line 5123  like GCC to compile their C code. Line 5225  like GCC to compile their C code.
5225  @end defmac  @end defmac
5226    
5227  @defmac AC_C_VOLATILE  @defmac AC_C_VOLATILE
5228  @acindex C_VOLATILE  @acindex{C_VOLATILE}
5229  @cvindex volatile  @cvindex volatile
5230  If the C compiler does not understand the keyword @code{volatile},  If the C compiler does not understand the keyword @code{volatile},
5231  define @code{volatile} to be empty.  Programs can simply use  define @code{volatile} to be empty.  Programs can simply use
# Line 5144  support volatile, but does not define @c Line 5246  support volatile, but does not define @c
5246  @end defmac  @end defmac
5247    
5248  @defmac AC_C_INLINE  @defmac AC_C_INLINE
5249  @acindex C_INLINE  @acindex{C_INLINE}
5250  @cvindex inline  @cvindex inline
5251  If the C compiler supports the keyword @code{inline}, do nothing.  If the C compiler supports the keyword @code{inline}, do nothing.
5252  Otherwise define @code{inline} to @code{__inline__} or @code{__inline}  Otherwise define @code{inline} to @code{__inline__} or @code{__inline}
# Line 5152  if it accepts one of those, otherwise de Line 5254  if it accepts one of those, otherwise de
5254  @end defmac  @end defmac
5255    
5256  @defmac AC_C_CHAR_UNSIGNED  @defmac AC_C_CHAR_UNSIGNED
5257  @acindex C_CHAR_UNSIGNED  @acindex{C_CHAR_UNSIGNED}
5258  @cvindex __CHAR_UNSIGNED__  @cvindex __CHAR_UNSIGNED__
5259  If the C type @code{char} is unsigned, define @code{__CHAR_UNSIGNED__},  If the C type @code{char} is unsigned, define @code{__CHAR_UNSIGNED__},
5260  unless the C compiler predefines it.  unless the C compiler predefines it.
5261  @end defmac  @end defmac
5262    
5263  @defmac AC_C_LONG_DOUBLE  @defmac AC_C_LONG_DOUBLE
5264  @acindex C_LONG_DOUBLE  @acindex{C_LONG_DOUBLE}
5265  @cvindex HAVE_LONG_DOUBLE  @cvindex HAVE_LONG_DOUBLE
5266  If the C compiler supports a working @code{long double} type with more  If the C compiler supports a working @code{long double} type with more
5267  range or precision than the @code{double} type, define  range or precision than the @code{double} type, define
# Line 5167  range or precision than the @code{double Line 5269  range or precision than the @code{double
5269  @end defmac  @end defmac
5270    
5271  @defmac AC_C_STRINGIZE  @defmac AC_C_STRINGIZE
5272  @acindex C_STRINGIZE  @acindex{C_STRINGIZE}
5273  @cvindex HAVE_STRINGIZE  @cvindex HAVE_STRINGIZE
5274  If the C preprocessor supports the stringizing operator, define  If the C preprocessor supports the stringizing operator, define
5275  @code{HAVE_STRINGIZE}.  The stringizing operator is @samp{#} and is  @code{HAVE_STRINGIZE}.  The stringizing operator is @samp{#} and is
# Line 5179  found in macros such as this: Line 5281  found in macros such as this:
5281  @end defmac  @end defmac
5282    
5283  @defmac AC_C_PROTOTYPES  @defmac AC_C_PROTOTYPES
5284  @acindex C_PROTOTYPES  @acindex{C_PROTOTYPES}
5285  @cvindex PROTOTYPES  @cvindex PROTOTYPES
5286  @cvindex __PROTOTYPES  @cvindex __PROTOTYPES
5287  @cvindex PARAMS  @cvindex PARAMS
# Line 5212  This macro also defines @code{__PROTOTYP Line 5314  This macro also defines @code{__PROTOTYP
5314  header files that cannot use macros that infringe on user name space.  header files that cannot use macros that infringe on user name space.
5315    
5316  @defmac AC_PROG_GCC_TRADITIONAL  @defmac AC_PROG_GCC_TRADITIONAL
5317  @acindex PROG_GCC_TRADITIONAL  @acindex{PROG_GCC_TRADITIONAL}
5318  @ovindex CC  @ovindex CC
5319  Add @option{-traditional} to output variable @code{CC} if using the  Add @option{-traditional} to output variable @code{CC} if using the
5320  @acronym{GNU} C compiler and @code{ioctl} does not work properly without  @acronym{GNU} C compiler and @code{ioctl} does not work properly without
# Line 5228  this is becoming a less prevalent proble Line 5330  this is becoming a less prevalent proble
5330    
5331    
5332  @defmac AC_PROG_CXX (@ovar{compiler-search-list})  @defmac AC_PROG_CXX (@ovar{compiler-search-list})
5333  @acindex PROG_CXX  @acindex{PROG_CXX}
5334  @ovindex CXX  @ovindex CXX
5335  @ovindex CXXFLAGS  @ovindex CXXFLAGS
5336  Determine a C++ compiler to use.  Check if the environment variable  Determine a C++ compiler to use.  Check if the environment variable
# Line 5259  compilers. Line 5361  compilers.
5361  @end defmac  @end defmac
5362    
5363  @defmac AC_PROG_CXXCPP  @defmac AC_PROG_CXXCPP
5364  @acindex PROG_CXXCPP  @acindex{PROG_CXXCPP}
5365  @ovindex CXXCPP  @ovindex CXXCPP
5366  Set output variable @code{CXXCPP} to a command that runs the C++  Set output variable @code{CXXCPP} to a command that runs the C++
5367  preprocessor.  If @samp{$CXX -E} doesn't work, @file{/lib/cpp} is used.  preprocessor.  If @samp{$CXX -E} doesn't work, @file{/lib/cpp} is used.
# Line 5279  it is not known whether such broken prep Line 5381  it is not known whether such broken prep
5381  @subsection Fortran 77 Compiler Characteristics  @subsection Fortran 77 Compiler Characteristics
5382    
5383  @defmac AC_PROG_F77 (@ovar{compiler-search-list})  @defmac AC_PROG_F77 (@ovar{compiler-search-list})
5384  @acindex PROG_FORTRAN  @acindex{PROG_FORTRAN}
5385  @ovindex F77  @ovindex F77
5386  @ovindex FFLAGS  @ovindex FFLAGS
5387  Determine a Fortran 77 compiler to use.  If @code{F77} is not already  Determine a Fortran 77 compiler to use.  If @code{F77} is not already
# Line 5307  where @code{g77} does not accept @option Line 5409  where @code{g77} does not accept @option
5409  @end defmac  @end defmac
5410    
5411  @defmac AC_PROG_F77_C_O  @defmac AC_PROG_F77_C_O
5412  @acindex PROG_F77_C_O  @acindex{PROG_F77_C_O}
5413  @cvindex F77_NO_MINUS_C_MINUS_O  @cvindex F77_NO_MINUS_C_MINUS_O
5414  Test if the Fortran 77 compiler accepts the options @option{-c} and  Test if the Fortran 77 compiler accepts the options @option{-c} and
5415  @option{-o} simultaneously, and define @code{F77_NO_MINUS_C_MINUS_O} if it  @option{-o} simultaneously, and define @code{F77_NO_MINUS_C_MINUS_O} if it
# Line 5323  Time}), making sure to first set the cur Line 5425  Time}), making sure to first set the cur
5425    
5426    
5427  @defmac AC_F77_LIBRARY_LDFLAGS  @defmac AC_F77_LIBRARY_LDFLAGS
5428  @acindex F77_LIBRARY_LDFLAGS  @acindex{F77_LIBRARY_LDFLAGS}
5429  @ovindex FLIBS  @ovindex FLIBS
5430  Determine the linker flags (e.g., @option{-L} and @option{-l}) for the  Determine the linker flags (e.g., @option{-L} and @option{-l}) for the
5431  @dfn{Fortran 77 intrinsic and run-time libraries} that are required to  @dfn{Fortran 77 intrinsic and run-time libraries} that are required to
# Line 5353  also be necessary to link C/C++ with For Line 5455  also be necessary to link C/C++ with For
5455    
5456    
5457  @defmac AC_F77_DUMMY_MAIN (@ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_F77_DUMMY_MAIN (@ovar{action-if-found}, @ovar{action-if-not-found})
5458  @acindex F77_DUMMY_MAIN  @acindex{F77_DUMMY_MAIN}
5459  @cvindex F77_DUMMY_MAIN  @cvindex F77_DUMMY_MAIN
5460  With many compilers, the Fortran libraries detected by  With many compilers, the Fortran libraries detected by
5461  @code{AC_F77_LIBRARY_LDFLAGS} provide their own @code{main} entry  @code{AC_F77_LIBRARY_LDFLAGS} provide their own @code{main} entry
# Line 5394  unless one wants to change the default a Line 5496  unless one wants to change the default a
5496  @end defmac  @end defmac
5497    
5498  @defmac AC_F77_MAIN  @defmac AC_F77_MAIN
5499  @acindex F77_MAIN  @acindex{F77_MAIN}
5500  @cvindex F77_MAIN  @cvindex F77_MAIN
5501  As discussed above for @code{AC_F77_DUMMY_MAIN}, many Fortran libraries  As discussed above for @code{AC_F77_DUMMY_MAIN}, many Fortran libraries
5502  allow you to provide an entry point called (say) @code{MAIN__} instead of  allow you to provide an entry point called (say) @code{MAIN__} instead of
# Line 5411  instead of @code{main}. Line 5513  instead of @code{main}.
5513  @end defmac  @end defmac
5514    
5515  @defmac AC_F77_WRAPPERS  @defmac AC_F77_WRAPPERS
5516  @acindex F77_WRAPPERS  @acindex{F77_WRAPPERS}
5517  @cvindex F77_FUNC  @cvindex F77_FUNC
5518  @cvindex F77_FUNC_  @cvindex F77_FUNC_
5519  Defines C macros @code{F77_FUNC(name,NAME)} and  Defines C macros @code{F77_FUNC(name,NAME)} and
# Line 5475  If the Fortran 77 identifier contains an Line 5577  If the Fortran 77 identifier contains an
5577  @end defmac  @end defmac
5578    
5579  @defmac AC_F77_FUNC (@var{name}, @ovar{shellvar})  @defmac AC_F77_FUNC (@var{name}, @ovar{shellvar})
5580  @acindex F77_FUNC  @acindex{F77_FUNC}
5581  Given an identifier @var{name}, set the shell variable @var{shellvar} to  Given an identifier @var{name}, set the shell variable @var{shellvar} to
5582  hold the mangled version @var{name} according to the rules of the  hold the mangled version @var{name} according to the rules of the
5583  Fortran 77 linker (see also @code{AC_F77_WRAPPERS}).  @var{shellvar} is  Fortran 77 linker (see also @code{AC_F77_WRAPPERS}).  @var{shellvar} is
# Line 5492  language other than C/C++. Line 5594  language other than C/C++.
5594  The following macros check for operating system services or capabilities.  The following macros check for operating system services or capabilities.
5595    
5596  @defmac AC_PATH_X  @defmac AC_PATH_X
5597  @acindex PATH_X  @acindex{PATH_X}
5598  Try to locate the X Window System include files and libraries.  If the  Try to locate the X Window System include files and libraries.  If the
5599  user gave the command line options @option{--x-includes=@var{dir}} and  user gave the command line options @option{--x-includes=@var{dir}} and
5600  @option{--x-libraries=@var{dir}}, use those directories.  If either or  @option{--x-libraries=@var{dir}}, use those directories.  If either or
# Line 5510  otherwise set it to the empty string. Line 5612  otherwise set it to the empty string.
5612  @end defmac  @end defmac
5613    
5614  @defmac AC_PATH_XTRA  @defmac AC_PATH_XTRA
5615  @acindex PATH_XTRA  @acindex{PATH_XTRA}
5616  @ovindex X_CFLAGS  @ovindex X_CFLAGS
5617  @ovindex X_LIBS  @ovindex X_LIBS
5618  @ovindex X_EXTRA_LIBS  @ovindex X_EXTRA_LIBS
# Line 5534  any found to the output variable @code{X Line 5636  any found to the output variable @code{X
5636  @end defmac  @end defmac
5637    
5638  @defmac AC_SYS_INTERPRETER  @defmac AC_SYS_INTERPRETER
5639  @acindex SYS_INTERPRETER  @acindex{SYS_INTERPRETER}
5640  Check whether the system supports starting scripts with a line of the  Check whether the system supports starting scripts with a line of the
5641  form @samp{#! /bin/csh} to select the interpreter to use for the script.  form @samp{#! /bin/csh} to select the interpreter to use for the script.
5642  After running this macro, shell code in @file{configure.ac} can check  After running this macro, shell code in @file{configure.ac} can check
# Line 5543  if the system supports @samp{#!}, @samp{ Line 5645  if the system supports @samp{#!}, @samp{
5645  @end defmac  @end defmac
5646    
5647  @defmac AC_SYS_LARGEFILE  @defmac AC_SYS_LARGEFILE
5648  @acindex SYS_LARGEFILE  @acindex{SYS_LARGEFILE}
5649  @cvindex _FILE_OFFSET_BITS  @cvindex _FILE_OFFSET_BITS
5650  @cvindex _LARGE_FILES  @cvindex _LARGE_FILES
5651  @ovindex CC  @ovindex CC
# Line 5565  an arbitrary @code{off_t} value @code{X} Line 5667  an arbitrary @code{off_t} value @code{X}
5667  @end defmac  @end defmac
5668    
5669  @defmac AC_SYS_LONG_FILE_NAMES  @defmac AC_SYS_LONG_FILE_NAMES
5670  @acindex SYS_LONG_FILE_NAMES  @acindex{SYS_LONG_FILE_NAMES}
5671  @cvindex HAVE_LONG_FILE_NAMES  @cvindex HAVE_LONG_FILE_NAMES
5672  If the system supports file names longer than 14 characters, define  If the system supports file names longer than 14 characters, define
5673  @code{HAVE_LONG_FILE_NAMES}.  @code{HAVE_LONG_FILE_NAMES}.
5674  @end defmac  @end defmac
5675    
5676  @defmac AC_SYS_POSIX_TERMIOS  @defmac AC_SYS_POSIX_TERMIOS
5677  @acindex SYS_POSIX_TERMIOS  @acindex{SYS_POSIX_TERMIOS}
5678  @cindex POSIX termios headers  @cindex POSIX termios headers
5679  @cindex termios POSIX headers  @cindex termios POSIX headers
5680  Check to see if the POSIX termios headers and functions are available on the  Check to see if the POSIX termios headers and functions are available on the
# Line 5590  replaced by a more systematic approach, Line 5692  replaced by a more systematic approach,
5692  available or the environments they provide.  available or the environments they provide.
5693    
5694  @defmac AC_AIX  @defmac AC_AIX
5695  @acindex AIX  @acindex{AIX}
5696  @cvindex _ALL_SOURCE  @cvindex _ALL_SOURCE
5697  If on @acronym{AIX}, define @code{_ALL_SOURCE}.  Allows the use of some @acronym{BSD}  If on @acronym{AIX}, define @code{_ALL_SOURCE}.  Allows the use of some @acronym{BSD}
5698  functions.  Should be called before any macros that run the C compiler.  functions.  Should be called before any macros that run the C compiler.
5699  @end defmac  @end defmac
5700    
5701  @defmac AC_GNU_SOURCE  @defmac AC_GNU_SOURCE
5702  @acindex GNU_SOURCE  @acindex{GNU_SOURCE}
5703  @cvindex _GNU_SOURCE  @cvindex _GNU_SOURCE
5704  If using the @acronym{GNU} C library, define @code{_GNU_SOURCE}.  If using the @acronym{GNU} C library, define @code{_GNU_SOURCE}.
5705  Allows the use of some @acronym{GNU} functions.  Should be called  Allows the use of some @acronym{GNU} functions.  Should be called
# Line 5605  before any macros that run the C compile Line 5707  before any macros that run the C compile
5707  @end defmac  @end defmac
5708    
5709  @defmac AC_ISC_POSIX  @defmac AC_ISC_POSIX
5710  @acindex ISC_POSIX  @acindex{ISC_POSIX}
5711  @ovindex LIBS  @ovindex LIBS
5712  For @sc{interactive unix} (@acronym{ISC}), add @option{-lcposix} to output  For @sc{interactive unix} (@acronym{ISC}), add @option{-lcposix} to output
5713  variable @code{LIBS} if necessary for @acronym{POSIX} facilities.  Call this  variable @code{LIBS} if necessary for @acronym{POSIX} facilities.  Call this
# Line 5616  obsolescent. Line 5718  obsolescent.
5718  @end defmac  @end defmac
5719    
5720  @defmac AC_MINIX  @defmac AC_MINIX
5721  @acindex MINIX  @acindex{MINIX}
5722  @cvindex _MINIX  @cvindex _MINIX
5723  @cvindex _POSIX_SOURCE  @cvindex _POSIX_SOURCE
5724  @cvindex _POSIX_1_SOURCE  @cvindex _POSIX_1_SOURCE
# Line 5702  test programs. Line 5804  test programs.
5804  @end defmac  @end defmac
5805    
5806  @defmac AC_LANG_PUSH (@var{language})  @defmac AC_LANG_PUSH (@var{language})
5807  @acindex LANG_PUSH  @acindex{LANG_PUSH}
5808  Remember the current language (as set by @code{AC_LANG}) on a stack, and  Remember the current language (as set by @code{AC_LANG}) on a stack, and
5809  then select the @var{language}.  Use this macro and @code{AC_LANG_POP}  then select the @var{language}.  Use this macro and @code{AC_LANG_POP}
5810  in macros that need to temporarily switch to a particular language.  in macros that need to temporarily switch to a particular language.
5811  @end defmac  @end defmac
5812    
5813  @defmac AC_LANG_POP (@ovar{language})  @defmac AC_LANG_POP (@ovar{language})
5814  @acindex LANG_POP  @acindex{LANG_POP}
5815  Select the language that is saved on the top of the stack, as set by  Select the language that is saved on the top of the stack, as set by
5816  @code{AC_LANG_PUSH}, and remove it from the stack.  @code{AC_LANG_PUSH}, and remove it from the stack.
5817    
# Line 5726  AC_LANG_POP(Fortran 77) Line 5828  AC_LANG_POP(Fortran 77)
5828  @end defmac  @end defmac
5829    
5830  @defmac AC_REQUIRE_CPP  @defmac AC_REQUIRE_CPP
5831  @acindex REQUIRE_CPP  @acindex{REQUIRE_CPP}
5832  Ensure that whichever preprocessor would currently be used for tests has  Ensure that whichever preprocessor would currently be used for tests has
5833  been found.  Calls @code{AC_REQUIRE} (@pxref{Prerequisite Macros}) with an  been found.  Calls @code{AC_REQUIRE} (@pxref{Prerequisite Macros}) with an
5834  argument of either @code{AC_PROG_CPP} or @code{AC_PROG_CXXCPP},  argument of either @code{AC_PROG_CPP} or @code{AC_PROG_CXXCPP},
# Line 5848  actually depend on the current language Line 5950  actually depend on the current language
5950    
5951    
5952  @defmac AC_LANG_CONFTEST (@var{source})  @defmac AC_LANG_CONFTEST (@var{source})
5953  @acindex LANG_CONFTEST  @acindex{LANG_CONFTEST}
5954  Save the @var{source} text in the current test source file:  Save the @var{source} text in the current test source file:
5955  @file{conftest.@var{extension}} where the @var{extension} depends on the  @file{conftest.@var{extension}} where the @var{extension} depends on the
5956  current language.  current language.
# Line 5859  invocation, (ii) if not, be sure to doub Line 5961  invocation, (ii) if not, be sure to doub
5961  @end defmac  @end defmac
5962    
5963  @defmac AC_LANG_SOURCE (@var{source})  @defmac AC_LANG_SOURCE (@var{source})
5964  @acindex LANG_SOURCE  @acindex{LANG_SOURCE}
5965  Expands into the @var{source}, with the definition of  Expands into the @var{source}, with the definition of
5966  all the @code{AC_DEFINE} performed so far.  all the @code{AC_DEFINE} performed so far.
5967  @end defmac  @end defmac
# Line 5895  const char hw[] = "Hello, World\n"; Line 5997  const char hw[] = "Hello, World\n";
5997  @end example  @end example
5998    
5999  @defmac AC_LANG_PROGRAM (@var{prologue}, @var{body})  @defmac AC_LANG_PROGRAM (@var{prologue}, @var{body})
6000  @acindex LANG_PROGRAM  @acindex{LANG_PROGRAM}
6001  Expands into a source file which consists of the @var{prologue}, and  Expands into a source file which consists of the @var{prologue}, and
6002  then @var{body} as body of the main function (e.g., @code{main} in  then @var{body} as body of the main function (e.g., @code{main} in
6003  C).  Since it uses @code{AC_LANG_SOURCE}, the feature of the latter are  C).  Since it uses @code{AC_LANG_SOURCE}, the feature of the latter are
# Line 5942  fputs (hw, stdout); Line 6044  fputs (hw, stdout);
6044    
6045    
6046  @defmac AC_LANG_CALL (@var{prologue}, @var{function})  @defmac AC_LANG_CALL (@var{prologue}, @var{function})
6047  @acindex LANG_CALL  @acindex{LANG_CALL}
6048  Expands into a source file which consists of the @var{prologue}, and  Expands into a source file which consists of the @var{prologue}, and
6049  then a call to the @var{function} as body of the main function (e.g.,  then a call to the @var{function} as body of the main function (e.g.,
6050  @code{main} in C).  Since it uses @code{AC_LANG_PROGRAMS}, the feature  @code{main} in C).  Since it uses @code{AC_LANG_PROGRAMS}, the feature
# Line 5955  not encouraged, as it violates strongly Line 6057  not encouraged, as it violates strongly
6057    
6058    
6059  @defmac AC_LANG_FUNC_LINK_TRY (@var{function})  @defmac AC_LANG_FUNC_LINK_TRY (@var{function})
6060  @acindex LANG_FUNC_LINK_TRY  @acindex{LANG_FUNC_LINK_TRY}
6061  Expands into a source file which consists of a pseudo use of the  Expands into a source file which consists of a pseudo use of the
6062  @var{function} as body of the main function (e.g., @code{main} in C): a  @var{function} as body of the main function (e.g., @code{main} in C): a
6063  simple (function pointer) assignment.  Since it uses  simple (function pointer) assignment.  Since it uses
# Line 5980  Nevertheless, if you need to run the pre Line 6082  Nevertheless, if you need to run the pre
6082  @code{AC_PREPROC_IFELSE}.  @code{AC_PREPROC_IFELSE}.
6083    
6084  @defmac AC_PREPROC_IFELSE (@var{input}, @ovar{action-if-true}, @ovar{action-if-false})  @defmac AC_PREPROC_IFELSE (@var{input}, @ovar{action-if-true}, @ovar{action-if-false})
6085  @acindex PREPROC_IFELSE  @acindex{PREPROC_IFELSE}
6086  Run the preprocessor of the current language (@pxref{Language Choice})  Run the preprocessor of the current language (@pxref{Language Choice})
6087  on the @var{input}, run the shell commands @var{action-if-true} on  on the @var{input}, run the shell commands @var{action-if-true} on
6088  success, @var{action-if-false} otherwise.  The @var{input} can be made  success, @var{action-if-false} otherwise.  The @var{input} can be made
# Line 6033  get rid of your old use of the macro @co Line 6135  get rid of your old use of the macro @co
6135  to run the @emph{preprocessor} and not the compiler?  to run the @emph{preprocessor} and not the compiler?
6136    
6137  @defmac AC_EGREP_HEADER (@var{pattern}, @var{header-file}, @var{action-if-found}, @ovar{action-if-not-found})  @defmac AC_EGREP_HEADER (@var{pattern}, @var{header-file}, @var{action-if-found}, @ovar{action-if-not-found})
6138  @acindex EGREP_HEADER  @acindex{EGREP_HEADER}
6139  If the output of running the preprocessor on the system header file  If the output of running the preprocessor on the system header file
6140  @var{header-file} matches the extended regular expression  @var{header-file} matches the extended regular expression
6141  @var{pattern}, execute shell commands @var{action-if-found}, otherwise  @var{pattern}, execute shell commands @var{action-if-found}, otherwise
# Line 6041  execute @var{action-if-not-found}. Line 6143  execute @var{action-if-not-found}.
6143  @end defmac  @end defmac
6144    
6145  @defmac AC_EGREP_CPP (@var{pattern}, @var{program}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_EGREP_CPP (@var{pattern}, @var{program}, @ovar{action-if-found}, @ovar{action-if-not-found})
6146  @acindex EGREP_CPP  @acindex{EGREP_CPP}
6147  @var{program} is the text of a C or C++ program, on which shell  @var{program} is the text of a C or C++ program, on which shell
6148  variable, back quote, and backslash substitutions are performed.  If the  variable, back quote, and backslash substitutions are performed.  If the
6149  output of running the preprocessor on @var{program} matches the  output of running the preprocessor on @var{program} matches the
# Line 6061  program that uses that feature. Line 6163  program that uses that feature.
6163    
6164    
6165  @defmac AC_COMPILE_IFELSE (@var{input}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_COMPILE_IFELSE (@var{input}, @ovar{action-if-found}, @ovar{action-if-not-found})
6166  @acindex COMPILE_IFELSE  @acindex{COMPILE_IFELSE}
6167  Run the compiler of the current language (@pxref{Language Choice}) on  Run the compiler of the current language (@pxref{Language Choice}) on
6168  the @var{input}, run the shell commands @var{action-if-true} on success,  the @var{input}, run the shell commands @var{action-if-true} on success,
6169  @var{action-if-false} otherwise.  The @var{input} can be made by  @var{action-if-false} otherwise.  The @var{input} can be made by
# Line 6101  program. Line 6203  program.
6203    
6204    
6205  @defmac AC_LINK_IFELSE (@var{input}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_LINK_IFELSE (@var{input}, @ovar{action-if-found}, @ovar{action-if-not-found})
6206  @acindex LINK_IFELSE  @acindex{LINK_IFELSE}
6207  Run the compiler and the linker of the current language (@pxref{Language  Run the compiler and the linker of the current language (@pxref{Language
6208  Choice}) on the @var{input}, run the shell commands @var{action-if-true}  Choice}) on the @var{input}, run the shell commands @var{action-if-true}
6209  on success, @var{action-if-false} otherwise.  The @var{input} can be made  on success, @var{action-if-false} otherwise.  The @var{input} can be made
# Line 6135  possible, because this prevents people f Line 6237  possible, because this prevents people f
6237  cross-compiling.  cross-compiling.
6238    
6239  @defmac AC_RUN_IFELSE (@var{input}, @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{action-if-cross-compiling})  @defmac AC_RUN_IFELSE (@var{input}, @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{action-if-cross-compiling})
6240  @acindex RUN_IFELSE  @acindex{RUN_IFELSE}
6241  If @var{program} compiles and links successfully and returns an exit  If @var{program} compiles and links successfully and returns an exit
6242  status of 0 when executed, run shell commands @var{action-if-true}.  status of 0 when executed, run shell commands @var{action-if-true}.
6243  Otherwise, run shell commands @var{action-if-false}.  Otherwise, run shell commands @var{action-if-false}.
# Line 6320  output. Line 6422  output.
6422    
6423  @defmac AC_DEFINE (@var{variable}, @var{value}, @ovar{description})  @defmac AC_DEFINE (@var{variable}, @var{value}, @ovar{description})
6424  @defmacx AC_DEFINE (@var{variable})  @defmacx AC_DEFINE (@var{variable})
6425  @acindex DEFINE  @acindex{DEFINE}
6426  Define the C preprocessor variable @var{variable} to @var{value} (verbatim).  Define the C preprocessor variable @var{variable} to @var{value} (verbatim).
6427  @var{value} should not contain literal newlines, and if you are not  @var{value} should not contain literal newlines, and if you are not
6428  using @code{AC_CONFIG_HEADERS} it should not contain any @samp{#}  using @code{AC_CONFIG_HEADERS} it should not contain any @samp{#}
# Line 6345  is obsolescent and may be withdrawn in f Line 6447  is obsolescent and may be withdrawn in f
6447    
6448  @defmac AC_DEFINE_UNQUOTED (@var{variable}, @var{value}, @ovar{description})  @defmac AC_DEFINE_UNQUOTED (@var{variable}, @var{value}, @ovar{description})
6449  @defmacx AC_DEFINE_UNQUOTED (@var{variable})  @defmacx AC_DEFINE_UNQUOTED (@var{variable})
6450  @acindex DEFINE_UNQUOTED  @acindex{DEFINE_UNQUOTED}
6451  Like @code{AC_DEFINE}, but three shell expansions are  Like @code{AC_DEFINE}, but three shell expansions are
6452  performed---once---on @var{variable} and @var{value}: variable expansion  performed---once---on @var{variable} and @var{value}: variable expansion
6453  (@samp{$}), command substitution (@samp{`}), and backslash escaping  (@samp{$}), command substitution (@samp{`}), and backslash escaping
# Line 6396  output variables.  @xref{Preset Output V Line 6498  output variables.  @xref{Preset Output V
6498  variables that are always available.  variables that are always available.
6499    
6500  @defmac AC_SUBST (@var{variable}, @ovar{value})  @defmac AC_SUBST (@var{variable}, @ovar{value})
6501  @acindex SUBST  @acindex{SUBST}
6502  Create an output variable from a shell variable.  Make @code{AC_OUTPUT}  Create an output variable from a shell variable.  Make @code{AC_OUTPUT}
6503  substitute the variable @var{variable} into output files (typically one  substitute the variable @var{variable} into output files (typically one
6504  or more @file{Makefile}s).  This means that @code{AC_OUTPUT} will  or more @file{Makefile}s).  This means that @code{AC_OUTPUT} will
# Line 6409  If @var{value} is given, in addition ass Line 6511  If @var{value} is given, in addition ass
6511  @end defmac  @end defmac
6512    
6513  @defmac AC_SUBST_FILE (@var{variable})  @defmac AC_SUBST_FILE (@var{variable})
6514  @acindex SUBST_FILE  @acindex{SUBST_FILE}
6515  Another way to create an output variable from a shell variable.  Make  Another way to create an output variable from a shell variable.  Make
6516  @code{AC_OUTPUT} insert (without substitutions) the contents of the file  @code{AC_OUTPUT} insert (without substitutions) the contents of the file
6517  named by shell variable @var{variable} into output files.  This means  named by shell variable @var{variable} into output files.  This means
# Line 6454  above, are called @dfn{precious variable Line 6556  above, are called @dfn{precious variable
6556  by @code{AC_ARG_VAR}.  by @code{AC_ARG_VAR}.
6557    
6558  @defmac AC_ARG_VAR (@var{variable}, @var{description})  @defmac AC_ARG_VAR (@var{variable}, @var{description})
6559  @acindex ARG_VAR  @acindex{ARG_VAR}
6560  Declare @var{variable} is a precious variable, and include its  Declare @var{variable} is a precious variable, and include its
6561  @var{description} in the variable section of @samp{./configure --help}.  @var{description} in the variable section of @samp{./configure --help}.
6562    
# Line 6524  result, @command{configure} can then run Line 6626  result, @command{configure} can then run
6626  perform all of the checks every time.  perform all of the checks every time.
6627    
6628  @defmac AC_CACHE_VAL (@var{cache-id}, @var{commands-to-set-it})  @defmac AC_CACHE_VAL (@var{cache-id}, @var{commands-to-set-it})
6629  @acindex CACHE_VAL  @acindex{CACHE_VAL}
6630  Ensure that the results of the check identified by @var{cache-id} are  Ensure that the results of the check identified by @var{cache-id} are
6631  available.  If the results of the check were in the cache file that was  available.  If the results of the check were in the cache file that was
6632  read, and @command{configure} was not given the @option{--quiet} or  read, and @command{configure} was not given the @option{--quiet} or
# Line 6540  setting the variable @var{cache-id}, see Line 6642  setting the variable @var{cache-id}, see
6642  @end defmac  @end defmac
6643    
6644  @defmac AC_CACHE_CHECK (@var{message}, @var{cache-id}, @var{commands-to-set-it})  @defmac AC_CACHE_CHECK (@var{message}, @var{cache-id}, @var{commands-to-set-it})
6645  @acindex CACHE_CHECK  @acindex{CACHE_CHECK}
6646  A wrapper for @code{AC_CACHE_VAL} that takes care of printing the  A wrapper for @code{AC_CACHE_VAL} that takes care of printing the
6647  messages.  This macro provides a convenient shorthand for the most  messages.  This macro provides a convenient shorthand for the most
6648  common way to use these macros.  It calls @code{AC_MSG_CHECKING} for  common way to use these macros.  It calls @code{AC_MSG_CHECKING} for
# Line 6698  reduce the amount of time it takes to re Line 6800  reduce the amount of time it takes to re
6800    
6801  @c FIXME: Do we really want to document this guy?  @c FIXME: Do we really want to document this guy?
6802  @defmac AC_CACHE_LOAD  @defmac AC_CACHE_LOAD
6803  @acindex CACHE_LOAD  @acindex{CACHE_LOAD}
6804  Loads values from existing cache file, or creates a new cache file if a  Loads values from existing cache file, or creates a new cache file if a
6805  cache file is not found.  Called automatically from @code{AC_INIT}.  cache file is not found.  Called automatically from @code{AC_INIT}.
6806  @end defmac  @end defmac
6807    
6808  @defmac AC_CACHE_SAVE  @defmac AC_CACHE_SAVE
6809  @acindex CACHE_SAVE  @acindex{CACHE_SAVE}
6810  Flushes all cached values to the cache file.  Called automatically from  Flushes all cached values to the cache file.  Called automatically from
6811  @code{AC_OUTPUT}, but it can be quite useful to call  @code{AC_OUTPUT}, but it can be quite useful to call
6812  @code{AC_CACHE_SAVE} at key points in @file{configure.ac}.  @code{AC_CACHE_SAVE} at key points in @file{configure.ac}.
# Line 6759  To diagnose static issues, i.e., when @c Line 6861  To diagnose static issues, i.e., when @c
6861  @ref{Reporting Messages}.  @ref{Reporting Messages}.
6862    
6863  @defmac AC_MSG_CHECKING (@var{feature-description})  @defmac AC_MSG_CHECKING (@var{feature-description})
6864  @acindex MSG_CHECKING  @acindex{MSG_CHECKING}
6865  Notify the user that @command{configure} is checking for a particular  Notify the user that @command{configure} is checking for a particular
6866  feature.  This macro prints a message that starts with @samp{checking }  feature.  This macro prints a message that starts with @samp{checking }
6867  and ends with @samp{...} and no newline.  It must be followed by a call  and ends with @samp{...} and no newline.  It must be followed by a call
# Line 6773  This macro prints nothing if @command{co Line 6875  This macro prints nothing if @command{co
6875  @end defmac  @end defmac
6876    
6877  @defmac AC_MSG_RESULT (@var{result-description})  @defmac AC_MSG_RESULT (@var{result-description})
6878  @acindex MSG_RESULT  @acindex{MSG_RESULT}
6879  Notify the user of the results of a check.  @var{result-description} is  Notify the user of the results of a check.  @var{result-description} is
6880  almost always the value of the cache variable for the check, typically  almost always the value of the cache variable for the check, typically
6881  @samp{yes}, @samp{no}, or a file name.  This macro should follow a call  @samp{yes}, @samp{no}, or a file name.  This macro should follow a call
# Line 6786  This macro prints nothing if @command{co Line 6888  This macro prints nothing if @command{co
6888  @end defmac  @end defmac
6889    
6890  @defmac AC_MSG_NOTICE (@var{message})  @defmac AC_MSG_NOTICE (@var{message})
6891  @acindex MSG_NOTICE  @acindex{MSG_NOTICE}
6892  Deliver the @var{message} to the user.  It is useful mainly to print a  Deliver the @var{message} to the user.  It is useful mainly to print a
6893  general description of the overall purpose of a group of feature checks,  general description of the overall purpose of a group of feature checks,
6894  e.g.,  e.g.,
# Line 6800  This macro prints nothing if @command{co Line 6902  This macro prints nothing if @command{co
6902  @end defmac  @end defmac
6903    
6904  @defmac AC_MSG_ERROR (@var{error-description}, @ovar{exit-status})  @defmac AC_MSG_ERROR (@var{error-description}, @ovar{exit-status})
6905  @acindex MSG_ERROR  @acindex{MSG_ERROR}
6906  Notify the user of an error that prevents @command{configure} from  Notify the user of an error that prevents @command{configure} from
6907  completing.  This macro prints an error message to the standard error  completing.  This macro prints an error message to the standard error
6908  output and exits @command{configure} with @var{exit-status} (1 by default).  output and exits @command{configure} with @var{exit-status} (1 by default).
# Line 6812  The @var{error-description} should start Line 6914  The @var{error-description} should start
6914  @end defmac  @end defmac
6915    
6916  @defmac AC_MSG_FAILURE (@var{error-description}, @ovar{exit-status})  @defmac AC_MSG_FAILURE (@var{error-description}, @ovar{exit-status})
6917  @acindex MSG_FAILURE  @acindex{MSG_FAILURE}
6918  This @code{AC_MSG_ERROR} wrapper notifies the user of an error that  This @code{AC_MSG_ERROR} wrapper notifies the user of an error that
6919  prevents @command{configure} from completing @emph{and} that additional  prevents @command{configure} from completing @emph{and} that additional
6920  details are provided in @file{config.log}.  This is typically used when  details are provided in @file{config.log}.  This is typically used when
# Line 6820  abnormal results are found during a comp Line 6922  abnormal results are found during a comp
6922  @end defmac  @end defmac
6923    
6924  @defmac AC_MSG_WARN (@var{problem-description})  @defmac AC_MSG_WARN (@var{problem-description})
6925  @acindex MSG_WARN  @acindex{MSG_WARN}
6926  Notify the @command{configure} user of a possible problem.  This macro  Notify the @command{configure} user of a possible problem.  This macro
6927  prints the message to the standard error output; @command{configure}  prints the message to the standard error output; @command{configure}
6928  continues running afterward, so macros that call @code{AC_MSG_WARN} should  continues running afterward, so macros that call @code{AC_MSG_WARN} should
# Line 7771  Some M4 macros are redefined, and are sl Line 7873  Some M4 macros are redefined, and are sl
7873  native equivalent.  native equivalent.
7874    
7875  @defmac dnl  @defmac dnl
7876  @msindex dnl  @msindex{dnl}
7877  This macro kept its original name: no @code{m4_dnl} is defined.  This macro kept its original name: no @code{m4_dnl} is defined.
7878  @end defmac  @end defmac
7879    
7880  @defmac m4_defn (@var{macro})  @defmac m4_defn (@var{macro})
7881  @msindex defn  @msindex{defn}
7882  Contrary to the M4 builtin, this macro fails if @var{macro} is not  Contrary to the M4 builtin, this macro fails if @var{macro} is not
7883  defined.  See @code{m4_undefine}.  defined.  See @code{m4_undefine}.
7884  @end defmac  @end defmac
7885    
7886  @defmac m4_exit (@var{exit-status})  @defmac m4_exit (@var{exit-status})
7887  @msindex m4_exit  @msindex{exit}
7888  This macro corresponds to @code{m4exit}.  This macro corresponds to @code{m4exit}.
7889  @end defmac  @end defmac
7890    
7891  @defmac m4_if (@var{comment})  @defmac m4_if (@var{comment})
7892  @defmacx m4_if (@var{string-1}, @var{string-2}, @var{equal}, @ovar{not-equal})  @defmacx m4_if (@var{string-1}, @var{string-2}, @var{equal}, @ovar{not-equal})
7893  @defmacx m4_if (@var{string-1}, @var{string-2}, @var{equal}, @dots{})  @defmacx m4_if (@var{string-1}, @var{string-2}, @var{equal}, @dots{})
7894  @msindex m4_if  @msindex{if}
7895  This macro corresponds to @code{ifelse}.  This macro corresponds to @code{ifelse}.
7896  @end defmac  @end defmac
7897    
7898  @defmac m4_undefine (@var{macro})  @defmac m4_undefine (@var{macro})
7899  @msindex undefine  @msindex{undefine}
7900  Contrary to the M4 builtin, this macro fails if @var{macro} is not  Contrary to the M4 builtin, this macro fails if @var{macro} is not
7901  defined.  Use  defined.  Use
7902    
# Line 7807  to recover the behavior of the builtin. Line 7909  to recover the behavior of the builtin.
7909  @end defmac  @end defmac
7910    
7911  @defmac m4_bpatsubst (@var{string}, @var{regexp}, @ovar{replacement})  @defmac m4_bpatsubst (@var{string}, @var{regexp}, @ovar{replacement})
7912  @msindex bpatsubst  @msindex{bpatsubst}
7913  This macro corresponds to @code{patsubst}.  The name @code{m4_patsubst}  This macro corresponds to @code{patsubst}.  The name @code{m4_patsubst}
7914  is kept for future versions of M4sh, on top of @acronym{GNU} M4 which will  is kept for future versions of M4sh, on top of @acronym{GNU} M4 which will
7915  provide extended regular expression syntax via @code{epatsubst}.  provide extended regular expression syntax via @code{epatsubst}.
7916  @end defmac  @end defmac
7917    
7918  @defmac m4_popdef (@var{macro})  @defmac m4_popdef (@var{macro})
7919  @msindex defn  @msindex{popdef}
7920  Contrary to the M4 builtin, this macro fails if @var{macro} is not  Contrary to the M4 builtin, this macro fails if @var{macro} is not
7921  defined.  See @code{m4_undefine}.  defined.  See @code{m4_undefine}.
7922  @end defmac  @end defmac
7923    
7924  @defmac m4_bregexp (@var{string}, @var{regexp}, @ovar{replacement})  @defmac m4_bregexp (@var{string}, @var{regexp}, @ovar{replacement})
7925  @msindex bregexp  @msindex{bregexp}
7926  This macro corresponds to @code{regexp}.  The name @code{m4_regexp}  This macro corresponds to @code{regexp}.  The name @code{m4_regexp}
7927  is kept for future versions of M4sh, on top of @acronym{GNU} M4 which will  is kept for future versions of M4sh, on top of @acronym{GNU} M4 which will
7928  provide extended regular expression syntax via @code{eregexp}.  provide extended regular expression syntax via @code{eregexp}.
7929  @end defmac  @end defmac
7930    
7931  @defmac m4_wrap (@var{text})  @defmac m4_wrap (@var{text})
7932  @msindex m4_wrap  @msindex{wrap}
7933  This macro corresponds to @code{m4wrap}.  This macro corresponds to @code{m4wrap}.
7934    
7935  You are encouraged to end @var{text} with @samp{[]}, so that there are  You are encouraged to end @var{text} with @samp{[]}, so that there are
# Line 7852  by adding or removing levels of quotes. Line 7954  by adding or removing levels of quotes.
7954  programmers.  programmers.
7955    
7956  @defmac m4_dquote (@var{arg1}, @dots{})  @defmac m4_dquote (@var{arg1}, @dots{})
7957  @msindex dquote  @msindex{dquote}
7958  Return the arguments as a quoted list of quoted arguments.  Return the arguments as a quoted list of quoted arguments.
7959  @end defmac  @end defmac
7960    
7961  @defmac m4_quote (@var{arg1}, @dots{})  @defmac m4_quote (@var{arg1}, @dots{})
7962  @msindex quote  @msindex{quote}
7963  Return the arguments as a single entity, i.e., wrap them into a pair of  Return the arguments as a single entity, i.e., wrap them into a pair of
7964  quotes.  quotes.
7965  @end defmac  @end defmac
# Line 7894  wrong (typically a macro was not evaluat Line 7996  wrong (typically a macro was not evaluat
7996  M4sugar forbids all the tokens matching @samp{^m4_} and @samp{^dnl$}.  M4sugar forbids all the tokens matching @samp{^m4_} and @samp{^dnl$}.
7997    
7998  @defmac m4_pattern_forbid (@var{pattern})  @defmac m4_pattern_forbid (@var{pattern})
7999  @msindex pattern_forbid  @msindex{pattern_forbid}
8000  Declare that no token matching @var{pattern} must be found in the output.  Declare that no token matching @var{pattern} must be found in the output.
8001  Comments are not checked; this can be a problem if, for instance, you  Comments are not checked; this can be a problem if, for instance, you
8002  have some macro left unexpanded after an @samp{#include}.  No consensus  have some macro left unexpanded after an @samp{#include}.  No consensus
# Line 7908  Of course, you might encounter exception Line 8010  Of course, you might encounter exception
8010  instance you might have to refer to @samp{$m4_flags}.  instance you might have to refer to @samp{$m4_flags}.
8011    
8012  @defmac m4_pattern_allow (@var{pattern})  @defmac m4_pattern_allow (@var{pattern})
8013  @msindex pattern_allow  @msindex{pattern_allow}
8014  Any token matching @var{pattern} is allowed, including if it matches an  Any token matching @var{pattern} is allowed, including if it matches an
8015  @code{m4_pattern_forbid} pattern.  @code{m4_pattern_forbid} pattern.
8016  @end defmac  @end defmac
# Line 7947  M4sh provides portable alternatives for Line 8049  M4sh provides portable alternatives for
8049  that unfortunately are not portable in practice.  that unfortunately are not portable in practice.
8050    
8051  @defmac AS_DIRNAME (@var{pathname})  @defmac AS_DIRNAME (@var{pathname})
8052  @msindex DIRNAME  @asindex{DIRNAME}
8053  Return the directory portion of @var{pathname}, using the algorithm  Return the directory portion of @var{pathname}, using the algorithm
8054  required by @acronym{POSIX}.  @xref{Limitations of Usual Tools}, for more  required by @acronym{POSIX}.  @xref{Limitations of Usual Tools}, for more
8055  details about what this returns and why it is more portable than the  details about what this returns and why it is more portable than the
# Line 7955  details about what this returns and why Line 8057  details about what this returns and why
8057  @end defmac  @end defmac
8058    
8059  @defmac AS_MKDIR_P (@var{filename})  @defmac AS_MKDIR_P (@var{filename})
8060  @msindex MKDIR_P  @asindex{MKDIR_P}
8061  Make the directory @var{filename}, including intervening directories  Make the directory @var{filename}, including intervening directories
8062  as necessary.  This is equivalent to @samp{mkdir -p @var{filename}},  as necessary.  This is equivalent to @samp{mkdir -p @var{filename}},
8063  except that it is portable to older versions of @command{mkdir} that  except that it is portable to older versions of @command{mkdir} that
# Line 7983  Here are some instructions and guideline Line 8085  Here are some instructions and guideline
8085  @node Macro Definitions  @node Macro Definitions
8086  @section Macro Definitions  @section Macro Definitions
8087    
8088  @acindex DEFUN  @acindex{DEFUN}
8089  Autoconf macros are defined using the @code{AC_DEFUN} macro, which is  Autoconf macros are defined using the @code{AC_DEFUN} macro, which is
8090  similar to the M4 builtin @code{m4_define} macro.  In addition to  similar to the M4 builtin @code{m4_define} macro.  In addition to
8091  defining a macro, @code{AC_DEFUN} adds to it some code that is used to  defining a macro, @code{AC_DEFUN} adds to it some code that is used to
# Line 8105  they should report them using these macr Line 8207  they should report them using these macr
8207  when @command{configure} is run, see @ref{Printing Messages}.  when @command{configure} is run, see @ref{Printing Messages}.
8208    
8209  @defmac AC_DIAGNOSE (@var{category}, @var{message})  @defmac AC_DIAGNOSE (@var{category}, @var{message})
8210  @acindex DIAGNOSE  @acindex{DIAGNOSE}
8211  Report @var{message} as a warning (or as an error if requested by the  Report @var{message} as a warning (or as an error if requested by the
8212  user) if warnings of the @var{category} are turned on.  You are  user) if warnings of the @var{category} are turned on.  You are
8213  encouraged to use standard categories, which currently include:  encouraged to use standard categories, which currently include:
# Line 8127  dubious syntactic constructs, incorrectl Line 8229  dubious syntactic constructs, incorrectl
8229  @end defmac  @end defmac
8230    
8231  @defmac AC_WARNING (@var{message})  @defmac AC_WARNING (@var{message})
8232  @acindex WARNING  @acindex{WARNING}
8233  Equivalent to @samp{AC_DIAGNOSE([syntax], @var{message})}, but you are  Equivalent to @samp{AC_DIAGNOSE([syntax], @var{message})}, but you are
8234  strongly encouraged to use a finer grained category.  strongly encouraged to use a finer grained category.
8235  @end defmac  @end defmac
8236    
8237  @defmac AC_FATAL (@var{message})  @defmac AC_FATAL (@var{message})
8238  @acindex FATAL  @acindex{FATAL}
8239  Report a severe error @var{message}, and have @command{autoconf} die.  Report a severe error @var{message}, and have @command{autoconf} die.
8240  @end defmac  @end defmac
8241    
# Line 8169  it automatically.  @code{AC_REQUIRE} can Line 8271  it automatically.  @code{AC_REQUIRE} can
8271  called if it is needed, and only called once.  called if it is needed, and only called once.
8272    
8273  @defmac AC_REQUIRE (@var{macro-name})  @defmac AC_REQUIRE (@var{macro-name})
8274  @acindex REQUIRE  @acindex{REQUIRE}
8275  If the M4 macro @var{macro-name} has not already been called, call it  If the M4 macro @var{macro-name} has not already been called, call it
8276  (without any arguments).  Make sure to quote @var{macro-name} with  (without any arguments).  Make sure to quote @var{macro-name} with
8277  square brackets.  @var{macro-name} must have been defined using  square brackets.  @var{macro-name} must have been defined using
# Line 8281  This warns the user if a call to @code{A Line 8383  This warns the user if a call to @code{A
8383  when @code{AC_PROG_CC} is called.  when @code{AC_PROG_CC} is called.
8384    
8385  @defmac AC_BEFORE (@var{this-macro-name}, @var{called-macro-name})  @defmac AC_BEFORE (@var{this-macro-name}, @var{called-macro-name})
8386  @acindex BEFORE  @acindex{BEFORE}
8387  Make M4 print a warning message to the standard error output if  Make M4 print a warning message to the standard error output if
8388  @var{called-macro-name} has already been called.  @var{this-macro-name}  @var{called-macro-name} has already been called.  @var{this-macro-name}
8389  should be the name of the macro that is calling @code{AC_BEFORE}.  The  should be the name of the macro that is calling @code{AC_BEFORE}.  The
# Line 8305  with their modern implementation. Line 8407  with their modern implementation.
8407  Autoconf provides a simple means to obsolete a macro.  Autoconf provides a simple means to obsolete a macro.
8408    
8409  @defmac AU_DEFUN (@var{old-macro}, @var{implementation}, @ovar{message})  @defmac AU_DEFUN (@var{old-macro}, @var{implementation}, @ovar{message})
8410  @acindex DEFUN  @acindex{DEFUN}
8411  @acindex AU_DEFUN  @acindex{AU_DEFUN}
8412  Define @var{old-macro} as @var{implementation}.  The only difference  Define @var{old-macro} as @var{implementation}.  The only difference
8413  with @code{AC_DEFUN} is that the user will be warned that  with @code{AC_DEFUN} is that the user will be warned that
8414  @var{old-macro} is now obsolete.  @var{old-macro} is now obsolete.
# Line 11525  to control in which directory @command{c Line 11627  to control in which directory @command{c
11627    
11628    
11629  @defmac AC_CANONICAL_BUILD  @defmac AC_CANONICAL_BUILD
11630  @acindex CANONICAL_BUILD  @acindex{CANONICAL_BUILD}
11631  @ovindex build  @ovindex build
11632  @ovindex build_cpu  @ovindex build_cpu
11633  @ovindex build_vendor  @ovindex build_vendor
# Line 11540  otherwise it is determined by the shell Line 11642  otherwise it is determined by the shell
11642  @end defmac  @end defmac
11643    
11644  @defmac AC_CANONICAL_HOST  @defmac AC_CANONICAL_HOST
11645  @acindex CANONICAL_HOST  @acindex{CANONICAL_HOST}
11646  @ovindex host  @ovindex host
11647  @ovindex host_cpu  @ovindex host_cpu
11648  @ovindex host_vendor  @ovindex host_vendor
# Line 11555  otherwise it defaults to @code{build}. Line 11657  otherwise it defaults to @code{build}.
11657  @end defmac  @end defmac
11658    
11659  @defmac AC_CANONICAL_TARGET  @defmac AC_CANONICAL_TARGET
11660  @acindex CANONICAL_TARGET  @acindex{CANONICAL_TARGET}
11661  @ovindex target  @ovindex target
11662  @ovindex target_cpu  @ovindex target_cpu
11663  @ovindex target_vendor  @ovindex target_vendor
# Line 11691  user asked to use it.  Whether each pack Line 11793  user asked to use it.  Whether each pack
11793  and which arguments are valid, is up to you.  and which arguments are valid, is up to you.
11794    
11795  @defmac AC_ARG_WITH (@var{package}, @var{help-string}, @ovar{action-if-given}, @ovar{action-if-not-given})  @defmac AC_ARG_WITH (@var{package}, @var{help-string}, @ovar{action-if-given}, @ovar{action-if-not-given})
11796  @acindex ARG_WITH  @acindex{ARG_WITH}
11797  If the user gave @command{configure} the option @option{--with-@var{package}}  If the user gave @command{configure} the option @option{--with-@var{package}}
11798  or @option{--without-@var{package}}, run shell commands  or @option{--without-@var{package}}, run shell commands
11799  @var{action-if-given}.  If neither option was given, run shell commands  @var{action-if-given}.  If neither option was given, run shell commands
# Line 11723  You should format your @var{help-string} Line 11825  You should format your @var{help-string}
11825  @end defmac  @end defmac
11826    
11827  @defmac AC_WITH (@var{package}, @var{action-if-given}, @ovar{action-if-not-given})  @defmac AC_WITH (@var{package}, @var{action-if-given}, @ovar{action-if-not-given})
11828  @acindex WITH  @acindex{WITH}
11829  This is an obsolete version of @code{AC_ARG_WITH} that does not  This is an obsolete version of @code{AC_ARG_WITH} that does not
11830  support providing a help string.  support providing a help string.
11831  @end defmac  @end defmac
# Line 11770  to include it.  Whether each feature is Line 11872  to include it.  Whether each feature is
11872  which arguments are valid, is up to you.  which arguments are valid, is up to you.
11873    
11874  @defmac AC_ARG_ENABLE (@var{feature}, @var{help-string}, @ovar{action-if-given}, @ovar{action-if-not-given})  @defmac AC_ARG_ENABLE (@var{feature}, @var{help-string}, @ovar{action-if-given}, @ovar{action-if-not-given})
11875  @acindex ARG_ENABLE  @acindex{ARG_ENABLE}
11876  If the user gave @command{configure} the option  If the user gave @command{configure} the option
11877  @option{--enable-@var{feature}} or @option{--disable-@var{feature}}, run  @option{--enable-@var{feature}} or @option{--disable-@var{feature}}, run
11878  shell commands @var{action-if-given}.  If neither option was given, run  shell commands @var{action-if-given}.  If neither option was given, run
# Line 11791  You should format your @var{help-string} Line 11893  You should format your @var{help-string}
11893  @end defmac  @end defmac
11894    
11895  @defmac AC_ENABLE (@var{feature}, @var{action-if-given}, @ovar{action-if-not-given})  @defmac AC_ENABLE (@var{feature}, @var{action-if-given}, @ovar{action-if-not-given})
11896  @acindex ENABLE  @acindex{ENABLE}
11897  This is an obsolete version of @code{AC_ARG_ENABLE} that does not  This is an obsolete version of @code{AC_ARG_ENABLE} that does not
11898  support providing a help string.  support providing a help string.
11899  @end defmac  @end defmac
# Line 11808  your own @samp{help strings} to line up Line 11910  your own @samp{help strings} to line up
11910  strings} do.  This is the purpose of the @code{AC_HELP_STRING} macro.  strings} do.  This is the purpose of the @code{AC_HELP_STRING} macro.
11911    
11912  @defmac AC_HELP_STRING (@var{left-hand-side}, @var{right-hand-side})  @defmac AC_HELP_STRING (@var{left-hand-side}, @var{right-hand-side})
11913  @acindex HELP_STRING  @acindex{HELP_STRING}
11914    
11915  Expands into an help string that looks pretty when the user executes  Expands into an help string that looks pretty when the user executes
11916  @samp{configure --help}.  It is typically used in @code{AC_ARG_WITH}  @samp{configure --help}.  It is typically used in @code{AC_ARG_WITH}
# Line 11877  In order to use these transformations, @ Line 11979  In order to use these transformations, @
11979  macro @code{AC_ARG_PROGRAM}.  macro @code{AC_ARG_PROGRAM}.
11980    
11981  @defmac AC_ARG_PROGRAM  @defmac AC_ARG_PROGRAM
11982  @acindex ARG_PROGRAM  @acindex{ARG_PROGRAM}
11983  @ovindex program_transform_name  @ovindex program_transform_name
11984  Place in output variable @code{program_transform_name} a sequence of  Place in output variable @code{program_transform_name} a sequence of
11985  @code{sed} commands for changing the names of installed programs.  @code{sed} commands for changing the names of installed programs.
# Line 12425  refer to the definition of the new macro Line 12527  refer to the definition of the new macro
12527  description.  description.
12528    
12529  @defmac AC_ALLOCA  @defmac AC_ALLOCA
12530  @acindex ALLOCA  @acindex{ALLOCA}
12531  @code{AC_FUNC_ALLOCA}  @code{AC_FUNC_ALLOCA}
12532  @end defmac  @end defmac
12533    
12534  @defmac AC_ARG_ARRAY  @defmac AC_ARG_ARRAY
12535  @acindex ARG_ARRAY  @acindex{ARG_ARRAY}
12536  removed because of limited usefulness  removed because of limited usefulness
12537  @end defmac  @end defmac
12538    
12539  @defmac AC_C_CROSS  @defmac AC_C_CROSS
12540  @acindex C_CROSS  @acindex{C_CROSS}
12541  This macro is obsolete; it does nothing.  This macro is obsolete; it does nothing.
12542  @end defmac  @end defmac
12543    
12544  @defmac AC_CANONICAL_SYSTEM  @defmac AC_CANONICAL_SYSTEM
12545  @acindex CANONICAL_SYSTEM  @acindex{CANONICAL_SYSTEM}
12546  Determine the system type and set output variables to the names of the  Determine the system type and set output variables to the names of the
12547  canonical system types.  @xref{Canonicalizing}, for details about the  canonical system types.  @xref{Canonicalizing}, for details about the
12548  variables this macro sets.  variables this macro sets.
# Line 12452  other macros. Line 12554  other macros.
12554  @end defmac  @end defmac
12555    
12556  @defmac AC_CHAR_UNSIGNED  @defmac AC_CHAR_UNSIGNED
12557  @acindex CHAR_UNSIGNED  @acindex{CHAR_UNSIGNED}
12558  @code{AC_C_CHAR_UNSIGNED}  @code{AC_C_CHAR_UNSIGNED}
12559  @end defmac  @end defmac
12560    
12561  @defmac AC_CHECK_TYPE (@var{type}, @var{default})  @defmac AC_CHECK_TYPE (@var{type}, @var{default})
12562  @acindex CHECK_TYPE  @acindex{CHECK_TYPE}
12563  Autoconf, up to 2.13, used to provide this version of  Autoconf, up to 2.13, used to provide this version of
12564  @code{AC_CHECK_TYPE}, deprecated because of its flaws.  Firstly, although  @code{AC_CHECK_TYPE}, deprecated because of its flaws.  Firstly, although
12565  it is a member of the @code{CHECK} clan, singular sub-family, it does  it is a member of the @code{CHECK} clan, singular sub-family, it does
# Line 12516  typedef loff_t off_t; Line 12618  typedef loff_t off_t;
12618  @c end of AC_CHECK_TYPE  @c end of AC_CHECK_TYPE
12619    
12620  @defmac AC_CHECKING (@var{feature-description})  @defmac AC_CHECKING (@var{feature-description})
12621  @acindex CHECKING  @acindex{CHECKING}
12622  Same as @samp{AC_MSG_NOTICE([checking @var{feature-description}@dots{}]}.  Same as @samp{AC_MSG_NOTICE([checking @var{feature-description}@dots{}]}.
12623  @end defmac  @end defmac
12624    
12625  @defmac AC_COMPILE_CHECK (@var{echo-text}, @var{includes}, @var{function-body}, @var{action-if-found}, @ovar{action-if-not-found})  @defmac AC_COMPILE_CHECK (@var{echo-text}, @var{includes}, @var{function-body}, @var{action-if-found}, @ovar{action-if-not-found})
12626  @acindex COMPILE_CHECK  @acindex{COMPILE_CHECK}
12627  This is an obsolete version of @code{AC_TRY_COMPILE} itself replaced by  This is an obsolete version of @code{AC_TRY_COMPILE} itself replaced by
12628  @code{AC_COMPILE_IFELSE} (@pxref{Running the Compiler}), with the  @code{AC_COMPILE_IFELSE} (@pxref{Running the Compiler}), with the
12629  addition that it prints @samp{checking for @var{echo-text}} to the  addition that it prints @samp{checking for @var{echo-text}} to the
# Line 12531  messages (@pxref{Printing Messages}). Line 12633  messages (@pxref{Printing Messages}).
12633  @end defmac  @end defmac
12634    
12635  @defmac AC_CONST  @defmac AC_CONST
12636  @acindex CONST  @acindex{CONST}
12637  @code{AC_C_CONST}  @code{AC_C_CONST}
12638  @end defmac  @end defmac
12639    
12640  @defmac AC_CROSS_CHECK  @defmac AC_CROSS_CHECK
12641  @acindex CROSS_CHECK  @acindex{CROSS_CHECK}
12642  Same as @code{AC_C_CROSS}, which is obsolete too, and does nothing  Same as @code{AC_C_CROSS}, which is obsolete too, and does nothing
12643  @code{:-)}.  @code{:-)}.
12644  @end defmac  @end defmac
12645    
12646  @defmac AC_CYGWIN  @defmac AC_CYGWIN
12647  @acindex CYGWIN  @acindex{CYGWIN}
12648  Check for the Cygwin environment in which case the shell variable  Check for the Cygwin environment in which case the shell variable
12649  @code{CYGWIN} is set to @samp{yes}.  Don't use this macro, the dignified  @code{CYGWIN} is set to @samp{yes}.  Don't use this macro, the dignified
12650  means to check the nature of the host is using  means to check the nature of the host is using
# Line 12562  not to use this macro. Line 12664  not to use this macro.
12664  @end defmac  @end defmac
12665    
12666  @defmac AC_DECL_SYS_SIGLIST  @defmac AC_DECL_SYS_SIGLIST
12667  @acindex DECL_SYS_SIGLIST  @acindex{DECL_SYS_SIGLIST}
12668  @cvindex SYS_SIGLIST_DECLARED  @cvindex SYS_SIGLIST_DECLARED
12669  Same as @samp{AC_CHECK_DECLS([sys_siglist])}.  Same as @samp{AC_CHECK_DECLS([sys_siglist])}.
12670  @end defmac  @end defmac
12671    
12672  @defmac AC_DECL_YYTEXT  @defmac AC_DECL_YYTEXT
12673  @acindex DECL_YYTEXT  @acindex{DECL_YYTEXT}
12674  Does nothing, now integrated in @code{AC_PROG_LEX}.  Does nothing, now integrated in @code{AC_PROG_LEX}.
12675  @end defmac  @end defmac
12676    
12677  @defmac AC_DIR_HEADER  @defmac AC_DIR_HEADER
12678  @acindex DIR_HEADER  @acindex{DIR_HEADER}
12679  @cvindex DIRENT  @cvindex DIRENT
12680  @cvindex SYSNDIR  @cvindex SYSNDIR
12681  @cvindex SYSDIR  @cvindex SYSDIR
# Line 12592  header file is found: Line 12694  header file is found:
12694  @end defmac  @end defmac
12695    
12696  @defmac AC_DYNIX_SEQ  @defmac AC_DYNIX_SEQ
12697  @acindex DYNIX_SEQ  @acindex{DYNIX_SEQ}
12698  If on DYNIX/ptx, add @option{-lseq} to output variable  If on DYNIX/ptx, add @option{-lseq} to output variable
12699  @code{LIBS}.  This macro used to be defined as  @code{LIBS}.  This macro used to be defined as
12700    
# Line 12605  now it is just @code{AC_FUNC_GETMNTENT}. Line 12707  now it is just @code{AC_FUNC_GETMNTENT}.
12707  @end defmac  @end defmac
12708    
12709  @defmac AC_EXEEXT  @defmac AC_EXEEXT
12710  @acindex EXEEXT  @acindex{EXEEXT}
12711  @ovindex EXEEXT  @ovindex EXEEXT
12712  Defined the output variable @code{EXEEXT} based on the output of the  Defined the output variable @code{EXEEXT} based on the output of the
12713  compiler, which is now done automatically.  Typically set to empty  compiler, which is now done automatically.  Typically set to empty
# Line 12613  string if Unix and @samp{.exe} if Win32 Line 12715  string if Unix and @samp{.exe} if Win32
12715  @end defmac  @end defmac
12716    
12717  @defmac AC_EMXOS2  @defmac AC_EMXOS2
12718  @acindex EMXOS2  @acindex{EMXOS2}
12719  Similar to @code{AC_CYGWIN} but checks for the EMX environment on OS/2  Similar to @code{AC_CYGWIN} but checks for the EMX environment on OS/2
12720  and sets @code{EMXOS2}.  and sets @code{EMXOS2}.
12721  @end defmac  @end defmac
12722    
12723  @defmac AC_ERROR  @defmac AC_ERROR
12724  @acindex ERROR  @acindex{ERROR}
12725  @code{AC_MSG_ERROR}  @code{AC_MSG_ERROR}
12726  @end defmac  @end defmac
12727    
12728  @defmac AC_FIND_X  @defmac AC_FIND_X
12729  @acindex FIND_X  @acindex{FIND_X}
12730  @code{AC_PATH_X}  @code{AC_PATH_X}
12731  @end defmac  @end defmac
12732    
12733  @defmac AC_FIND_XTRA  @defmac AC_FIND_XTRA
12734  @acindex FIND_XTRA  @acindex{FIND_XTRA}
12735  @code{AC_PATH_XTRA}  @code{AC_PATH_XTRA}
12736  @end defmac  @end defmac
12737    
12738  @defmac AC_FUNC_CHECK  @defmac AC_FUNC_CHECK
12739  @acindex FUNC_CHECK  @acindex{FUNC_CHECK}
12740  @code{AC_CHECK_FUNC}  @code{AC_CHECK_FUNC}
12741  @end defmac  @end defmac
12742    
12743  @defmac AC_FUNC_WAIT3  @defmac AC_FUNC_WAIT3
12744  @acindex FUNC_WAIT3  @acindex{FUNC_WAIT3}
12745  @cvindex HAVE_WAIT3  @cvindex HAVE_WAIT3
12746  If @code{wait3} is found and fills in the contents of its third argument  If @code{wait3} is found and fills in the contents of its third argument
12747  (a @samp{struct rusage *}), which HP-UX does not do, define  (a @samp{struct rusage *}), which HP-UX does not do, define
# Line 12651  standards, and will not appear in the ne Line 12753  standards, and will not appear in the ne
12753  @end defmac  @end defmac
12754    
12755  @defmac AC_GCC_TRADITIONAL  @defmac AC_GCC_TRADITIONAL
12756  @acindex GCC_TRADITIONAL  @acindex{GCC_TRADITIONAL}
12757  @code{AC_PROG_GCC_TRADITIONAL}  @code{AC_PROG_GCC_TRADITIONAL}
12758  @end defmac  @end defmac
12759    
12760  @defmac AC_GETGROUPS_T  @defmac AC_GETGROUPS_T
12761  @acindex GETGROUPS_T  @acindex{GETGROUPS_T}
12762  @code{AC_TYPE_GETGROUPS}  @code{AC_TYPE_GETGROUPS}
12763  @end defmac  @end defmac
12764    
12765  @defmac AC_GETLOADAVG  @defmac AC_GETLOADAVG
12766  @acindex GETLOADAVG  @acindex{GETLOADAVG}
12767  @code{AC_FUNC_GETLOADAVG}  @code{AC_FUNC_GETLOADAVG}
12768  @end defmac  @end defmac
12769    
12770  @defmac AC_HAVE_FUNCS  @defmac AC_HAVE_FUNCS
12771  @acindex HAVE_FUNCS  @acindex{HAVE_FUNCS}
12772  @code{AC_CHECK_FUNCS}  @code{AC_CHECK_FUNCS}
12773  @end defmac  @end defmac
12774    
12775  @defmac AC_HAVE_HEADERS  @defmac AC_HAVE_HEADERS
12776  @acindex HAVE_HEADERS  @acindex{HAVE_HEADERS}
12777  @code{AC_CHECK_HEADERS}  @code{AC_CHECK_HEADERS}
12778  @end defmac  @end defmac
12779    
12780  @defmac AC_HAVE_LIBRARY (@var{library}, @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{other-libraries})  @defmac AC_HAVE_LIBRARY (@var{library}, @ovar{action-if-found}, @ovar{action-if-not-found}, @ovar{other-libraries})
12781  @acindex HAVE_LIBRARY  @acindex{HAVE_LIBRARY}
12782  This macro is equivalent to calling @code{AC_CHECK_LIB} with a  This macro is equivalent to calling @code{AC_CHECK_LIB} with a
12783  @var{function} argument of @code{main}.  In addition, @var{library} can  @var{function} argument of @code{main}.  In addition, @var{library} can
12784  be written as any of @samp{foo}, @option{-lfoo}, or @samp{libfoo.a}.  In  be written as any of @samp{foo}, @option{-lfoo}, or @samp{libfoo.a}.  In
# Line 12685  all of those cases, the compiler is pass Line 12787  all of those cases, the compiler is pass
12787  @end defmac  @end defmac
12788    
12789  @defmac AC_HAVE_POUNDBANG  @defmac AC_HAVE_POUNDBANG
12790  @acindex HAVE_POUNDBANG  @acindex{HAVE_POUNDBANG}
12791  @code{AC_SYS_INTERPRETER} (different calling convention)  @code{AC_SYS_INTERPRETER} (different calling convention)
12792  @end defmac  @end defmac
12793    
12794  @defmac AC_HEADER_CHECK  @defmac AC_HEADER_CHECK
12795  @acindex HEADER_CHECK  @acindex{HEADER_CHECK}
12796  @code{AC_CHECK_HEADER}  @code{AC_CHECK_HEADER}
12797  @end defmac  @end defmac
12798    
12799  @defmac AC_HEADER_EGREP  @defmac AC_HEADER_EGREP
12800  @acindex HEADER_EGREP  @acindex{HEADER_EGREP}
12801  @code{AC_EGREP_HEADER}  @code{AC_EGREP_HEADER}
12802  @end defmac  @end defmac
12803    
12804  @defmac AC_INIT (@var{unique-file-in-source-dir})  @defmac AC_INIT (@var{unique-file-in-source-dir})
12805  @acindex INIT  @acindex{INIT}
12806  Formerly @code{AC_INIT} used to have a single argument, and was  Formerly @code{AC_INIT} used to have a single argument, and was
12807  equivalent to:  equivalent to:
12808    
# Line 12711  AC_CONFIG_SRCDIR(@var{unique-file-in-sou Line 12813  AC_CONFIG_SRCDIR(@var{unique-file-in-sou
12813  @end defmac  @end defmac
12814    
12815  @defmac AC_INLINE  @defmac AC_INLINE
12816  @acindex INLINE  @acindex{INLINE}
12817  @code{AC_C_INLINE}  @code{AC_C_INLINE}
12818  @end defmac  @end defmac
12819    
12820  @defmac AC_INT_16_BITS  @defmac AC_INT_16_BITS
12821  @acindex INT_16_BITS  @acindex{INT_16_BITS}
12822  @cvindex INT_16_BITS  @cvindex INT_16_BITS
12823  If the C type @code{int} is 16 bits wide, define @code{INT_16_BITS}.  If the C type @code{int} is 16 bits wide, define @code{INT_16_BITS}.
12824  Use @samp{AC_CHECK_SIZEOF(int)} instead.  Use @samp{AC_CHECK_SIZEOF(int)} instead.
12825  @end defmac  @end defmac
12826    
12827  @defmac AC_IRIX_SUN  @defmac AC_IRIX_SUN
12828  @acindex IRIX_SUN  @acindex{IRIX_SUN}
12829  If on @sc{irix} (Silicon Graphics @sc{unix}), add @option{-lsun} to output  If on @sc{irix} (Silicon Graphics @sc{unix}), add @option{-lsun} to output
12830  @code{LIBS}.  If you were using it to get @code{getmntent}, use  @code{LIBS}.  If you were using it to get @code{getmntent}, use
12831  @code{AC_FUNC_GETMNTENT} instead.  If you used it for the NIS versions  @code{AC_FUNC_GETMNTENT} instead.  If you used it for the NIS versions
# Line 12744  AC_CHECK_LIB(sun, getpwnam) Line 12846  AC_CHECK_LIB(sun, getpwnam)
12846  @end defmac  @end defmac
12847    
12848  @defmac AC_LANG_C  @defmac AC_LANG_C
12849  @acindex LANG_C  @acindex{LANG_C}
12850  Same as @samp{AC_LANG(C)}.  Same as @samp{AC_LANG(C)}.
12851  @end defmac  @end defmac
12852    
12853  @defmac AC_LANG_CPLUSPLUS  @defmac AC_LANG_CPLUSPLUS
12854  @acindex LANG_CPLUSPLUS  @acindex{LANG_CPLUSPLUS}
12855  Same as @samp{AC_LANG(C++)}.  Same as @samp{AC_LANG(C++)}.
12856  @end defmac  @end defmac
12857    
12858  @defmac AC_LANG_FORTRAN77  @defmac AC_LANG_FORTRAN77
12859  @acindex LANG_FORTRAN77  @acindex{LANG_FORTRAN77}
12860  Same as @samp{AC_LANG(Fortran 77)}.  Same as @samp{AC_LANG(Fortran 77)}.
12861  @end defmac  @end defmac
12862    
12863  @defmac AC_LANG_RESTORE  @defmac AC_LANG_RESTORE
12864  @acindex LANG_RESTORE  @acindex{LANG_RESTORE}
12865  Select the @var{language} that is saved on the top of the stack, as set  Select the @var{language} that is saved on the top of the stack, as set
12866  by @code{AC_LANG_SAVE}, remove it from the stack, and call  by @code{AC_LANG_SAVE}, remove it from the stack, and call
12867  @code{AC_LANG(@var{language})}.  @code{AC_LANG(@var{language})}.
12868  @end defmac  @end defmac
12869    
12870  @defmac AC_LANG_SAVE  @defmac AC_LANG_SAVE
12871  @acindex LANG_SAVE  @acindex{LANG_SAVE}
12872  Remember the current language (as set by @code{AC_LANG}) on a stack.  Remember the current language (as set by @code{AC_LANG}) on a stack.
12873  The current language does not change.  @code{AC_LANG_PUSH} is preferred.  The current language does not change.  @code{AC_LANG_PUSH} is preferred.
12874  @end defmac  @end defmac
12875    
12876  @defmac AC_LINK_FILES (@var{source}@dots{}, @var{dest}@dots{})  @defmac AC_LINK_FILES (@var{source}@dots{}, @var{dest}@dots{})
12877  @acindex LINK_FILES  @acindex{LINK_FILES}
12878  This is an obsolete version of @code{AC_CONFIG_LINKS}.  An updated  This is an obsolete version of @code{AC_CONFIG_LINKS}.  An updated
12879  version of:  version of:
12880    
# Line 12791  AC_CONFIG_LINKS(host.h:config/$machine.h Line 12893  AC_CONFIG_LINKS(host.h:config/$machine.h
12893  @end defmac  @end defmac
12894    
12895  @defmac AC_LN_S  @defmac AC_LN_S
12896  @acindex LN_S  @acindex{LN_S}
12897  @code{AC_PROG_LN_S}  @code{AC_PROG_LN_S}
12898  @end defmac  @end defmac
12899    
12900  @defmac AC_LONG_64_BITS  @defmac AC_LONG_64_BITS
12901  @acindex LONG_64_BITS  @acindex{LONG_64_BITS}
12902  @cvindex LONG_64_BITS  @cvindex LONG_64_BITS
12903  Define @code{LONG_64_BITS} if the C type @code{long int} is 64 bits wide.  Define @code{LONG_64_BITS} if the C type @code{long int} is 64 bits wide.
12904  Use the generic macro @samp{AC_CHECK_SIZEOF([long int])} instead.  Use the generic macro @samp{AC_CHECK_SIZEOF([long int])} instead.
12905  @end defmac  @end defmac
12906    
12907  @defmac AC_LONG_DOUBLE  @defmac AC_LONG_DOUBLE
12908  @acindex LONG_DOUBLE  @acindex{LONG_DOUBLE}
12909  @code{AC_C_LONG_DOUBLE}  @code{AC_C_LONG_DOUBLE}
12910  @end defmac  @end defmac
12911    
12912  @defmac AC_LONG_FILE_NAMES  @defmac AC_LONG_FILE_NAMES
12913  @acindex LONG_FILE_NAMES  @acindex{LONG_FILE_NAMES}
12914  @code{AC_SYS_LONG_FILE_NAMES}  @code{AC_SYS_LONG_FILE_NAMES}
12915  @end defmac  @end defmac
12916    
12917  @defmac AC_MAJOR_HEADER  @defmac AC_MAJOR_HEADER
12918  @acindex MAJOR_HEADER  @acindex{MAJOR_HEADER}
12919  @code{AC_HEADER_MAJOR}  @code{AC_HEADER_MAJOR}
12920  @end defmac  @end defmac
12921    
12922  @defmac AC_MEMORY_H  @defmac AC_MEMORY_H
12923  @acindex MEMORY_H  @acindex{MEMORY_H}
12924  @cvindex NEED_MEMORY_H  @cvindex NEED_MEMORY_H
12925  Used to define @code{NEED_MEMORY_H} if the @code{mem} functions were  Used to define @code{NEED_MEMORY_H} if the @code{mem} functions were
12926  defined in @file{memory.h}.  Today it is equivalent to  defined in @file{memory.h}.  Today it is equivalent to
# Line 12828  Symbols}. Line 12930  Symbols}.
12930  @end defmac  @end defmac
12931    
12932  @defmac AC_MINGW32  @defmac AC_MINGW32
12933  @acindex MINGW32  @acindex{MINGW32}
12934  Similar to @code{AC_CYGWIN} but checks for the MingW32 compiler  Similar to @code{AC_CYGWIN} but checks for the MingW32 compiler
12935  environment and sets @code{MINGW32}.  environment and sets @code{MINGW32}.
12936  @end defmac  @end defmac
12937    
12938  @defmac AC_MINUS_C_MINUS_O  @defmac AC_MINUS_C_MINUS_O
12939  @acindex MINUS_C_MINUS_O  @acindex{MINUS_C_MINUS_O}
12940  @code{AC_PROG_CC_C_O}  @code{AC_PROG_CC_C_O}
12941  @end defmac  @end defmac
12942    
12943  @defmac AC_MMAP  @defmac AC_MMAP
12944  @acindex MMAP  @acindex{MMAP}
12945  @code{AC_FUNC_MMAP}  @code{AC_FUNC_MMAP}
12946  @end defmac  @end defmac
12947    
12948  @defmac AC_MODE_T  @defmac AC_MODE_T
12949  @acindex MODE_T  @acindex{MODE_T}
12950  @code{AC_TYPE_MODE_T}  @code{AC_TYPE_MODE_T}
12951  @end defmac  @end defmac
12952    
12953  @defmac AC_OBJEXT  @defmac AC_OBJEXT
12954  @acindex OBJEXT  @acindex{OBJEXT}
12955  @ovindex OBJEXT  @ovindex OBJEXT
12956  Defined the output variable @code{OBJEXT} based on the output of the  Defined the output variable @code{OBJEXT} based on the output of the
12957  compiler, after .c files have been excluded.  Typically set to @samp{o}  compiler, after .c files have been excluded.  Typically set to @samp{o}
# Line 12858  this automatically. Line 12960  this automatically.
12960  @end defmac  @end defmac
12961    
12962  @defmac AC_OBSOLETE (@var{this-macro-name}, @ovar{suggestion})  @defmac AC_OBSOLETE (@var{this-macro-name}, @ovar{suggestion})
12963  @acindex OBSOLETE  @acindex{OBSOLETE}
12964  Make M4 print a message to the standard error output warning that  Make M4 print a message to the standard error output warning that
12965  @var{this-macro-name} is obsolete, and giving the file and line number  @var{this-macro-name} is obsolete, and giving the file and line number
12966  where it was called.  @var{this-macro-name} should be the name of the  where it was called.  @var{this-macro-name} should be the name of the
# Line 12877  services to the user. Line 12979  services to the user.
12979  @end defmac  @end defmac
12980    
12981  @defmac AC_OFF_T  @defmac AC_OFF_T
12982  @acindex OFF_T  @acindex{OFF_T}
12983  @code{AC_TYPE_OFF_T}  @code{AC_TYPE_OFF_T}
12984  @end defmac  @end defmac
12985    
12986  @defmac AC_OUTPUT (@ovar{file}@dots{}, @ovar{extra-cmds}, @ovar{init-cmds})  @defmac AC_OUTPUT (@ovar{file}@dots{}, @ovar{extra-cmds}, @ovar{init-cmds})
12987  @acindex OUTPUT  @acindex{OUTPUT}
12988  The use of @code{AC_OUTPUT} with argument is deprecated.  This obsoleted  The use of @code{AC_OUTPUT} with argument is deprecated.  This obsoleted
12989  interface is equivalent to:  interface is equivalent to:
12990    
# Line 12897  AC_OUTPUT Line 12999  AC_OUTPUT
12999  @end defmac  @end defmac
13000    
13001  @defmac AC_OUTPUT_COMMANDS (@var{extra-cmds}, @ovar{init-cmds})  @defmac AC_OUTPUT_COMMANDS (@var{extra-cmds}, @ovar{init-cmds})
13002  @acindex OUTPUT_COMMANDS  @acindex{OUTPUT_COMMANDS}
13003  Specify additional shell commands to run at the end of  Specify additional shell commands to run at the end of
13004  @file{config.status}, and shell commands to initialize any variables  @file{config.status}, and shell commands to initialize any variables
13005  from @command{configure}.  This macro may be called multiple times.  It is  from @command{configure}.  This macro may be called multiple times.  It is
# Line 12937  AC_CONFIG_COMMANDS([default], [[echo "Sq Line 13039  AC_CONFIG_COMMANDS([default], [[echo "Sq
13039  @end defmac  @end defmac
13040    
13041  @defmac AC_PID_T  @defmac AC_PID_T
13042  @acindex PID_T  @acindex{PID_T}
13043  @code{AC_TYPE_PID_T}  @code{AC_TYPE_PID_T}
13044  @end defmac  @end defmac
13045    
13046  @defmac AC_PREFIX  @defmac AC_PREFIX
13047  @acindex PREFIX  @acindex{PREFIX}
13048  @code{AC_PREFIX_PROGRAM}  @code{AC_PREFIX_PROGRAM}
13049  @end defmac  @end defmac
13050    
13051  @defmac AC_PROG_CC_STDC  @defmac AC_PROG_CC_STDC
13052  @acindex PROG_CC_STDC  @acindex{PROG_CC_STDC}
13053  This macro has been integrated into @code{AC_PROG_CC}.  This macro has been integrated into @code{AC_PROG_CC}.
13054  @end defmac  @end defmac
13055    
13056  @defmac AC_PROGRAMS_CHECK  @defmac AC_PROGRAMS_CHECK
13057  @acindex PROGRAMS_CHECK  @acindex{PROGRAMS_CHECK}
13058  @code{AC_CHECK_PROGS}  @code{AC_CHECK_PROGS}
13059  @end defmac  @end defmac
13060    
13061  @defmac AC_PROGRAMS_PATH  @defmac AC_PROGRAMS_PATH
13062  @acindex PROGRAMS_PATH  @acindex{PROGRAMS_PATH}
13063  @code{AC_PATH_PROGS}  @code{AC_PATH_PROGS}
13064  @end defmac  @end defmac
13065    
13066  @defmac AC_PROGRAM_CHECK  @defmac AC_PROGRAM_CHECK
13067  @acindex PROGRAM_CHECK  @acindex{PROGRAM_CHECK}
13068  @code{AC_CHECK_PROG}  @code{AC_CHECK_PROG}
13069  @end defmac  @end defmac
13070    
13071  @defmac AC_PROGRAM_EGREP  @defmac AC_PROGRAM_EGREP
13072  @acindex PROGRAM_EGREP  @acindex{PROGRAM_EGREP}
13073  @code{AC_EGREP_CPP}  @code{AC_EGREP_CPP}
13074  @end defmac  @end defmac
13075    
13076  @defmac AC_PROGRAM_PATH  @defmac AC_PROGRAM_PATH
13077  @acindex PROGRAM_PATH  @acindex{PROGRAM_PATH}
13078  @code{AC_PATH_PROG}  @code{AC_PATH_PROG}
13079  @end defmac  @end defmac
13080    
13081  @defmac AC_REMOTE_TAPE  @defmac AC_REMOTE_TAPE
13082  @acindex REMOTE_TAPE  @acindex{REMOTE_TAPE}
13083  removed because of limited usefulness  removed because of limited usefulness
13084  @end defmac  @end defmac
13085    
13086  @defmac AC_RESTARTABLE_SYSCALLS  @defmac AC_RESTARTABLE_SYSCALLS
13087  @acindex RESTARTABLE_SYSCALLS  @acindex{RESTARTABLE_SYSCALLS}
13088  @code{AC_SYS_RESTARTABLE_SYSCALLS}  @code{AC_SYS_RESTARTABLE_SYSCALLS}
13089  @end defmac  @end defmac
13090    
13091  @defmac AC_RETSIGTYPE  @defmac AC_RETSIGTYPE
13092  @acindex RETSIGTYPE  @acindex{RETSIGTYPE}
13093  @code{AC_TYPE_SIGNAL}  @code{AC_TYPE_SIGNAL}
13094  @end defmac  @end defmac
13095    
13096  @defmac AC_RSH  @defmac AC_RSH
13097  @acindex RSH  @acindex{RSH}
13098  removed because of limited usefulness  removed because of limited usefulness
13099  @end defmac  @end defmac
13100    
13101  @defmac AC_SCO_INTL  @defmac AC_SCO_INTL
13102  @acindex SCO_INTL  @acindex{SCO_INTL}
13103  @ovindex LIBS  @ovindex LIBS
13104  If on SCO UNIX, add @option{-lintl} to output variable @code{LIBS}.  This  If on SCO UNIX, add @option{-lintl} to output variable @code{LIBS}.  This
13105  macro used to  macro used to
# Line 13011  Now it just calls @code{AC_FUNC_STRFTIME Line 13113  Now it just calls @code{AC_FUNC_STRFTIME
13113  @end defmac  @end defmac
13114    
13115  @defmac AC_SETVBUF_REVERSED  @defmac AC_SETVBUF_REVERSED
13116  @acindex SETVBUF_REVERSED  @acindex{SETVBUF_REVERSED}
13117  @code{AC_FUNC_SETVBUF_REVERSED}  @code{AC_FUNC_SETVBUF_REVERSED}
13118  @end defmac  @end defmac
13119    
13120  @defmac AC_SET_MAKE  @defmac AC_SET_MAKE
13121  @acindex SET_MAKE  @acindex{SET_MAKE}
13122  @code{AC_PROG_MAKE_SET}  @code{AC_PROG_MAKE_SET}
13123  @end defmac  @end defmac
13124    
13125  @defmac AC_SIZEOF_TYPE  @defmac AC_SIZEOF_TYPE
13126  @acindex SIZEOF_TYPE  @acindex{SIZEOF_TYPE}
13127  @code{AC_CHECK_SIZEOF}  @code{AC_CHECK_SIZEOF}
13128  @end defmac  @end defmac
13129    
13130  @defmac AC_SIZE_T  @defmac AC_SIZE_T
13131  @acindex SIZE_T  @acindex{SIZE_T}
13132  @code{AC_TYPE_SIZE_T}  @code{AC_TYPE_SIZE_T}
13133  @end defmac  @end defmac
13134    
13135  @defmac AC_STAT_MACROS_BROKEN  @defmac AC_STAT_MACROS_BROKEN
13136  @acindex STAT_MACROS_BROKEN  @acindex{STAT_MACROS_BROKEN}
13137  @code{AC_HEADER_STAT}  @code{AC_HEADER_STAT}
13138  @end defmac  @end defmac
13139    
13140  @defmac AC_STDC_HEADERS  @defmac AC_STDC_HEADERS
13141  @acindex STDC_HEADERS  @acindex{STDC_HEADERS}
13142  @code{AC_HEADER_STDC}  @code{AC_HEADER_STDC}
13143  @end defmac  @end defmac
13144    
13145  @defmac AC_STRCOLL  @defmac AC_STRCOLL
13146  @acindex STRCOLL  @acindex{STRCOLL}
13147  @code{AC_FUNC_STRCOLL}  @code{AC_FUNC_STRCOLL}
13148  @end defmac  @end defmac
13149    
13150  @defmac AC_ST_BLKSIZE  @defmac AC_ST_BLKSIZE
13151  @acindex ST_BLKSIZE  @acindex{ST_BLKSIZE}
13152  @code{AC_CHECK_MEMBERS}  @code{AC_CHECK_MEMBERS}
13153  @end defmac  @end defmac
13154    
13155  @defmac AC_ST_BLOCKS  @defmac AC_ST_BLOCKS
13156  @acindex ST_BLOCKS  @acindex{ST_BLOCKS}
13157  @code{AC_STRUCT_ST_BLOCKS}  @code{AC_STRUCT_ST_BLOCKS}
13158  @end defmac  @end defmac
13159    
13160  @defmac AC_ST_RDEV  @defmac AC_ST_RDEV
13161  @acindex ST_RDEV  @acindex{ST_RDEV}
13162  @code{AC_CHECK_MEMBERS}  @code{AC_CHECK_MEMBERS}
13163  @end defmac  @end defmac
13164    
13165  @defmac AC_SYS_RESTARTABLE_SYSCALLS  @defmac AC_SYS_RESTARTABLE_SYSCALLS
13166  @acindex SYS_RESTARTABLE_SYSCALLS  @acindex{SYS_RESTARTABLE_SYSCALLS}
13167  @cvindex HAVE_RESTARTABLE_SYSCALLS  @cvindex HAVE_RESTARTABLE_SYSCALLS
13168  If the system automatically restarts a system call that is interrupted  If the system automatically restarts a system call that is interrupted
13169  by a signal, define @code{HAVE_RESTARTABLE_SYSCALLS}.  This macro does  by a signal, define @code{HAVE_RESTARTABLE_SYSCALLS}.  This macro does
# Line 13078  issue. Line 13180  issue.
13180  @end defmac  @end defmac
13181    
13182  @defmac AC_SYS_SIGLIST_DECLARED  @defmac AC_SYS_SIGLIST_DECLARED
13183  @acindex SYS_SIGLIST_DECLARED  @acindex{SYS_SIGLIST_DECLARED}
13184  @code{AC_DECL_SYS_SIGLIST}  @code{AC_DECL_SYS_SIGLIST}
13185  @end defmac  @end defmac
13186    
13187  @defmac AC_TEST_CPP  @defmac AC_TEST_CPP
13188  @acindex TEST_CPP  @acindex{TEST_CPP}
13189  @code{AC_TRY_CPP}, replaced with @code{AC_PREPROC_IFELSE}.  @code{AC_TRY_CPP}, replaced with @code{AC_PREPROC_IFELSE}.
13190  @end defmac  @end defmac
13191    
13192  @defmac AC_TEST_PROGRAM  @defmac AC_TEST_PROGRAM
13193  @acindex TEST_PROGRAM  @acindex{TEST_PROGRAM}
13194  @code{AC_TRY_RUN}, replaced with @code{AC_RUN_IFELSE}.  @code{AC_TRY_RUN}, replaced with @code{AC_RUN_IFELSE}.
13195  @end defmac  @end defmac
13196    
13197  @defmac AC_TIMEZONE  @defmac AC_TIMEZONE
13198  @acindex TIMEZONE  @acindex{TIMEZONE}
13199  @code{AC_STRUCT_TIMEZONE}  @code{AC_STRUCT_TIMEZONE}
13200  @end defmac  @end defmac
13201    
13202  @defmac AC_TIME_WITH_SYS_TIME  @defmac AC_TIME_WITH_SYS_TIME
13203  @acindex TIME_WITH_SYS_TIME  @acindex{TIME_WITH_SYS_TIME}
13204  @code{AC_HEADER_TIME}  @code{AC_HEADER_TIME}
13205  @end defmac  @end defmac
13206    
13207  @defmac AC_TRY_COMPILE (@var{includes}, @var{function-body}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_TRY_COMPILE (@var{includes}, @var{function-body}, @ovar{action-if-found}, @ovar{action-if-not-found})
13208  @acindex TRY_COMPILE  @acindex{TRY_COMPILE}
13209  Same as @samp{AC_COMPILE_IFELSE([AC_LANG_SOURCE([[@var{includes}]],  Same as @samp{AC_COMPILE_IFELSE([AC_LANG_SOURCE([[@var{includes}]],
13210  [[@var{function-body}]])], [@var{action-if-true}],  [[@var{function-body}]])], [@var{action-if-true}],
13211  [@var{action-if-false}])} (@pxref{Running the Compiler}).  [@var{action-if-false}])} (@pxref{Running the Compiler}).
# Line 13120  used when compiling. Line 13222  used when compiling.
13222  @end defmac  @end defmac
13223    
13224  @defmac AC_TRY_CPP (@var{input}, @ovar{action-if-true}, @ovar{action-if-false})  @defmac AC_TRY_CPP (@var{input}, @ovar{action-if-true}, @ovar{action-if-false})
13225  @acindex TRY_CPP  @acindex{TRY_CPP}
13226  Same as @samp{AC_PREPROC_IFELSE([AC_LANG_SOURCE([[@var{input}]])],  Same as @samp{AC_PREPROC_IFELSE([AC_LANG_SOURCE([[@var{input}]])],
13227  [@var{action-if-true}], [@var{action-if-false}])} (@pxref{Running the  [@var{action-if-true}], [@var{action-if-false}])} (@pxref{Running the
13228  Preprocessor}).  Preprocessor}).
# Line 13129  This macro double quotes the @var{input} Line 13231  This macro double quotes the @var{input}
13231  @end defmac  @end defmac
13232    
13233  @defmac AC_TRY_LINK (@var{includes}, @var{function-body}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_TRY_LINK (@var{includes}, @var{function-body}, @ovar{action-if-found}, @ovar{action-if-not-found})
13234  @acindex TRY_LINK  @acindex{TRY_LINK}
13235  Same as @samp{AC_LINK_IFELSE([AC_LANG_SOURCE([[@var{includes}]],  Same as @samp{AC_LINK_IFELSE([AC_LANG_SOURCE([[@var{includes}]],
13236  [[@var{function-body}]])], [@var{action-if-true}],  [[@var{function-body}]])], [@var{action-if-true}],
13237  [@var{action-if-false}])} (@pxref{Running the Compiler}).  [@var{action-if-false}])} (@pxref{Running the Compiler}).
# Line 13155  be used during linking in all cases. Line 13257  be used during linking in all cases.
13257  @end defmac  @end defmac
13258    
13259  @defmac AC_TRY_LINK_FUNC (@var{function}, @ovar{action-if-found}, @ovar{action-if-not-found})  @defmac AC_TRY_LINK_FUNC (@var{function}, @ovar{action-if-found}, @ovar{action-if-not-found})
13260  @acindex TRY_LINK_FUNC  @acindex{TRY_LINK_FUNC}
13261  This macro is equivalent to  This macro is equivalent to
13262  @samp{AC_LINK_IFELSE([AC_LANG_CALL([[@var{includes}]],  @samp{AC_LINK_IFELSE([AC_LANG_CALL([[@var{includes}]],
13263  [[@var{function-body}]])], [@var{action-if-true}],  [[@var{function-body}]])], [@var{action-if-true}],
# Line 13163  This macro is equivalent to Line 13265  This macro is equivalent to
13265  @end defmac  @end defmac
13266    
13267  @defmac AC_TRY_RUN (@var{program}, @ovar{action-if-true}, @ovar{action-if-false}, @ovar{action-if-cross-compiling})  @defmac AC_TRY_RUN (@var{program}, @ovar{action-if-true}, @ovar{action-if-false}, @ovar{action-if-cross-compiling})
13268  @acindex TRY_RUN  @acindex{TRY_RUN}
13269  Same as @samp{AC_RUN_IFELSE([AC_LANG_SOURCE([[@var{program}]],  Same as @samp{AC_RUN_IFELSE([AC_LANG_SOURCE([[@var{program}]],
13270  [@var{action-if-true}], [@var{action-if-false}],  [@var{action-if-true}], [@var{action-if-false}],
13271  [@var{action-if-cross-compiling}])} (@pxref{Run Time}).  [@var{action-if-cross-compiling}])} (@pxref{Run Time}).
# Line 13171  Same as @samp{AC_RUN_IFELSE([AC_LANG_SOU Line 13273  Same as @samp{AC_RUN_IFELSE([AC_LANG_SOU
13273    
13274    
13275  @defmac AC_UID_T  @defmac AC_UID_T
13276  @acindex UID_T  @acindex{UID_T}
13277  @code{AC_TYPE_UID_T}  @code{AC_TYPE_UID_T}
13278  @end defmac  @end defmac
13279    
13280  @defmac AC_UNISTD_H  @defmac AC_UNISTD_H
13281  @acindex UNISTD_H  @acindex{UNISTD_H}
13282  Same as @samp{AC_CHECK_HEADERS(unistd.h)}.  Same as @samp{AC_CHECK_HEADERS(unistd.h)}.
13283  @end defmac  @end defmac
13284    
13285  @defmac AC_USG  @defmac AC_USG
13286  @acindex USG  @acindex{USG}
13287  @cvindex USG  @cvindex USG
13288  Define @code{USG} if the @acronym{BSD} string functions are defined in  Define @code{USG} if the @acronym{BSD} string functions are defined in
13289  @file{strings.h}.  You should no longer depend upon @code{USG}, but on  @file{strings.h}.  You should no longer depend upon @code{USG}, but on
# Line 13189  Define @code{USG} if the @acronym{BSD} s Line 13291  Define @code{USG} if the @acronym{BSD} s
13291  @end defmac  @end defmac
13292    
13293  @defmac AC_UTIME_NULL  @defmac AC_UTIME_NULL
13294  @acindex UTIME_NULL  @acindex{UTIME_NULL}
13295  @code{AC_FUNC_UTIME_NULL}  @code{AC_FUNC_UTIME_NULL}
13296  @end defmac  @end defmac
13297    
13298  @defmac AC_VALIDATE_CACHED_SYSTEM_TUPLE (@ovar{cmd})  @defmac AC_VALIDATE_CACHED_SYSTEM_TUPLE (@ovar{cmd})
13299  @acindex VALIDATE_CACHED_SYSTEM_TUPLE  @acindex{VALIDATE_CACHED_SYSTEM_TUPLE}
13300  If the cache file is inconsistent with the current host, target and  If the cache file is inconsistent with the current host, target and
13301  build system types, it used to execute @var{cmd} or print a default  build system types, it used to execute @var{cmd} or print a default
13302  error message.  This is now handled by default.  error message.  This is now handled by default.
13303  @end defmac  @end defmac
13304    
13305  @defmac AC_VERBOSE (@var{result-description})  @defmac AC_VERBOSE (@var{result-description})
13306  @acindex VERBOSE  @acindex{VERBOSE}
13307  @code{AC_MSG_RESULT}.  @code{AC_MSG_RESULT}.
13308  @end defmac  @end defmac
13309    
13310  @defmac AC_VFORK  @defmac AC_VFORK
13311  @acindex VFORK  @acindex{VFORK}
13312  @code{AC_FUNC_VFORK}  @code{AC_FUNC_VFORK}
13313  @end defmac  @end defmac
13314    
13315  @defmac AC_VPRINTF  @defmac AC_VPRINTF
13316  @acindex VPRINTF  @acindex{VPRINTF}
13317  @code{AC_FUNC_VPRINTF}  @code{AC_FUNC_VPRINTF}
13318  @end defmac  @end defmac
13319    
13320  @defmac AC_WAIT3  @defmac AC_WAIT3
13321  @acindex WAIT3  @acindex{WAIT3}
13322  @code{AC_FUNC_WAIT3}  @code{AC_FUNC_WAIT3}
13323  @end defmac  @end defmac
13324    
13325  @defmac AC_WARN  @defmac AC_WARN
13326  @acindex WARN  @acindex{WARN}
13327  @code{AC_MSG_WARN}  @code{AC_MSG_WARN}
13328  @end defmac  @end defmac
13329    
13330  @defmac AC_WORDS_BIGENDIAN  @defmac AC_WORDS_BIGENDIAN
13331  @acindex WORDS_BIGENDIAN  @acindex{WORDS_BIGENDIAN}
13332  @code{AC_C_BIGENDIAN}  @code{AC_C_BIGENDIAN}
13333  @end defmac  @end defmac
13334    
13335  @defmac AC_XENIX_DIR  @defmac AC_XENIX_DIR
13336  @acindex XENIX_DIR  @acindex{XENIX_DIR}
13337  @ovindex LIBS  @ovindex LIBS
13338  This macro used to add @option{-lx} to output variable @code{LIBS} if on  This macro used to add @option{-lx} to output variable @code{LIBS} if on
13339  Xenix.  Also, if @file{dirent.h} is being checked for, added  Xenix.  Also, if @file{dirent.h} is being checked for, added
# Line 13251  AC_EGREP_CPP(yes, Line 13353  AC_EGREP_CPP(yes,
13353  @end defmac  @end defmac
13354    
13355  @defmac AC_YYTEXT_POINTER  @defmac AC_YYTEXT_POINTER
13356  @acindex YYTEXT_POINTER  @acindex{YYTEXT_POINTER}
13357  @code{AC_DECL_YYTEXT}  @code{AC_DECL_YYTEXT}
13358  @end defmac  @end defmac
13359    
# Line 14301  hierarchy: the test suite ought to be sh Line 14403  hierarchy: the test suite ought to be sh
14403  Invoke @code{AC_CONFIG_TESTDIR}.  Invoke @code{AC_CONFIG_TESTDIR}.
14404    
14405  @defmac AC_CONFIG_TESTDIR (@var{directory}, @dvar{test-path, @var{directory}})  @defmac AC_CONFIG_TESTDIR (@var{directory}, @dvar{test-path, @var{directory}})
14406  @acindex CONFIG_TESTDIR  @acindex{CONFIG_TESTDIR}
14407  An Autotest test suite is to be configured in @var{directory}.  This  An Autotest test suite is to be configured in @var{directory}.  This
14408  macro requires the instantiation of @file{@var{directory}/atconfig} from  macro requires the instantiation of @file{@var{directory}/atconfig} from
14409  @file{@var{directory}/atconfig.in}, and sets the default  @file{@var{directory}/atconfig.in}, and sets the default
# Line 15013  use these names in @code{#if} directives Line 15115  use these names in @code{#if} directives
15115  @node Autoconf Macro Index  @node Autoconf Macro Index
15116  @appendixsec Autoconf Macro Index  @appendixsec Autoconf Macro Index
15117    
15118  This is an alphabetical list of the Autoconf macros.  To make the list  This is an alphabetical list of the Autoconf macros.
15119  easier to use, the macros are listed without their preceding @samp{AC_}.  @ifset shortindexflag
15120    To make the list easier to use, the macros are listed without their
15121    preceding @samp{AC_}.
15122    @end ifset
15123    
15124  @printindex ac  @printindex AC
15125    
15126  @node M4 Macro Index  @node M4 Macro Index
15127  @appendixsec M4 Macro Index  @appendixsec M4 Macro Index
15128    
15129  This is an alphabetical list of the M4, M4sugar, and M4sh macros.  To  This is an alphabetical list of the M4, M4sugar, and M4sh macros.
15130  make the list easier to use, the macros are listed without their  @ifset shortindexflag
15131    To make the list easier to use, the macros are listed without their
15132  preceding @samp{m4_} or @samp{AS_}.  preceding @samp{m4_} or @samp{AS_}.
15133    @end ifset
15134    
15135  @printindex ms  @printindex MS
15136    
15137  @node Autotest Macro Index  @node Autotest Macro Index
15138  @appendixsec Autotest Macro Index  @appendixsec Autotest Macro Index
15139    
15140  This is an alphabetical list of the Autotest macros.  To make the list  This is an alphabetical list of the Autotest macros.
15141  easier to use, the macros are listed without their preceding @samp{AT_}.  @ifset shortindexflag
15142    To make the list easier to use, the macros are listed without their
15143    preceding @samp{AT_}.
15144    @end ifset
15145    
15146  @printindex at  @printindex AT
15147    
15148  @node Program & Function Index  @node Program & Function Index
15149  @appendixsec Program and Function Index  @appendixsec Program and Function Index

Legend:
Removed from v.1.726  
changed lines
  Added in v.1.727

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26