annotate m4/onceonly.m4 @ 285:9010796c6253 2.3 2.3.1

Generated manual for distribution
author lost
date Fri, 24 Apr 2009 22:36:09 +0000
parents 2cb097e760a5
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
283
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
1 # onceonly.m4 serial 6
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
2 dnl Copyright (C) 2002-2003, 2005-2006, 2008 Free Software Foundation, Inc.
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
3 dnl This file is free software, distributed under the terms of the GNU
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
4 dnl General Public License. As a special exception to the GNU General
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
5 dnl Public License, this file may be distributed as part of a program
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
6 dnl that contains a configuration script generated by Autoconf, under
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
7 dnl the same distribution terms as the rest of that program.
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
8
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
9 dnl This file defines some "once only" variants of standard autoconf macros.
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
10 dnl AC_CHECK_HEADERS_ONCE like AC_CHECK_HEADERS
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
11 dnl AC_CHECK_FUNCS_ONCE like AC_CHECK_FUNCS
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
12 dnl AC_CHECK_DECLS_ONCE like AC_CHECK_DECLS
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
13 dnl AC_REQUIRE([AC_FUNC_STRCOLL]) like AC_FUNC_STRCOLL
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
14 dnl The advantage is that the check for each of the headers/functions/decls
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
15 dnl will be put only once into the 'configure' file. It keeps the size of
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
16 dnl the 'configure' file down, and avoids redundant output when 'configure'
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
17 dnl is run.
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
18 dnl The drawback is that the checks cannot be conditionalized. If you write
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
19 dnl if some_condition; then gl_CHECK_HEADERS(stdlib.h); fi
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
20 dnl inside an AC_DEFUNed function, the gl_CHECK_HEADERS macro call expands to
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
21 dnl empty, and the check will be inserted before the body of the AC_DEFUNed
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
22 dnl function.
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
23
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
24 dnl The original code implemented AC_CHECK_HEADERS_ONCE and AC_CHECK_FUNCS_ONCE
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
25 dnl in terms of AC_DEFUN and AC_REQUIRE. This implementation uses diversions to
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
26 dnl named sections DEFAULTS and INIT_PREPARE in order to check all requested
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
27 dnl headers at once, thus reducing the size of 'configure'. It is known to work
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
28 dnl with autoconf 2.57..2.62 at least . The size reduction is ca. 9%.
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
29
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
30 dnl Autoconf version 2.59 plus gnulib is required; this file is not needed
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
31 dnl with Autoconf 2.60 or greater. But note that autoconf's implementation of
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
32 dnl AC_CHECK_DECLS_ONCE expects a comma-separated list of symbols as first
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
33 dnl argument!
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
34 AC_PREREQ([2.59])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
35
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
36 # AC_CHECK_HEADERS_ONCE(HEADER1 HEADER2 ...) is a once-only variant of
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
37 # AC_CHECK_HEADERS(HEADER1 HEADER2 ...).
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
38 AC_DEFUN([AC_CHECK_HEADERS_ONCE], [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
39 :
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
40 m4_foreach_w([gl_HEADER_NAME], [$1], [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
41 AC_DEFUN([gl_CHECK_HEADER_]m4_quote(translit(gl_HEADER_NAME,
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
42 [./-], [___])), [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
43 m4_divert_text([INIT_PREPARE],
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
44 [gl_header_list="$gl_header_list gl_HEADER_NAME"])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
45 gl_HEADERS_EXPANSION
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
46 AH_TEMPLATE(AS_TR_CPP([HAVE_]m4_defn([gl_HEADER_NAME])),
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
47 [Define to 1 if you have the <]m4_defn([gl_HEADER_NAME])[> header file.])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
48 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
49 AC_REQUIRE([gl_CHECK_HEADER_]m4_quote(translit(gl_HEADER_NAME,
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
50 [./-], [___])))
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
51 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
52 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
53 m4_define([gl_HEADERS_EXPANSION], [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
54 m4_divert_text([DEFAULTS], [gl_header_list=])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
55 AC_CHECK_HEADERS([$gl_header_list])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
56 m4_define([gl_HEADERS_EXPANSION], [])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
57 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
58
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
59 # AC_CHECK_FUNCS_ONCE(FUNC1 FUNC2 ...) is a once-only variant of
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
60 # AC_CHECK_FUNCS(FUNC1 FUNC2 ...).
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
61 AC_DEFUN([AC_CHECK_FUNCS_ONCE], [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
62 :
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
63 m4_foreach_w([gl_FUNC_NAME], [$1], [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
64 AC_DEFUN([gl_CHECK_FUNC_]m4_defn([gl_FUNC_NAME]), [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
65 m4_divert_text([INIT_PREPARE],
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
66 [gl_func_list="$gl_func_list gl_FUNC_NAME"])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
67 gl_FUNCS_EXPANSION
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
68 AH_TEMPLATE(AS_TR_CPP([HAVE_]m4_defn([gl_FUNC_NAME])),
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
69 [Define to 1 if you have the `]m4_defn([gl_FUNC_NAME])[' function.])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
70 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
71 AC_REQUIRE([gl_CHECK_FUNC_]m4_defn([gl_FUNC_NAME]))
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
72 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
73 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
74 m4_define([gl_FUNCS_EXPANSION], [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
75 m4_divert_text([DEFAULTS], [gl_func_list=])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
76 AC_CHECK_FUNCS([$gl_func_list])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
77 m4_define([gl_FUNCS_EXPANSION], [])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
78 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
79
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
80 # AC_CHECK_DECLS_ONCE(DECL1 DECL2 ...) is a once-only variant of
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
81 # AC_CHECK_DECLS(DECL1, DECL2, ...).
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
82 AC_DEFUN([AC_CHECK_DECLS_ONCE], [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
83 :
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
84 m4_foreach_w([gl_DECL_NAME], [$1], [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
85 AC_DEFUN([gl_CHECK_DECL_]m4_defn([gl_DECL_NAME]), [
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
86 AC_CHECK_DECLS(m4_defn([gl_DECL_NAME]))
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
87 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
88 AC_REQUIRE([gl_CHECK_DECL_]m4_defn([gl_DECL_NAME]))
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
89 ])
2cb097e760a5 Added various generated files in prep for release
lost
parents:
diff changeset
90 ])