1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01//EN"
"http://www.w3.org/TR/html4/strict.dtd">
<html lang="en">
<head>
<title>
Autoconf Macro: ax_config_feature
</title>
<link rel="stylesheet" type="text/css" href="ac-archive.css">
</head>
<body>
<table summary="web navigation" style="width:100%;">
<tbody>
<tr>
<td style="width:50%;" align="center">
<a href="http://autoconf-archive.cryp.to/ax_config_feature.m4">Download
M4 Source</a>
</td>
<td style="width:50%;" align="center">
<a href="macros-by-category.html">Macro Index Page</a>
</td>
</tr>
</tbody>
</table>
<hr>
<h1>
ax_config_feature
</h1>
<h2>
Synopsis
</h2>
<p class="indent" style="white-space:nowrap;">
<code>AX_CONFIG_FEATURE(FEATURE-NAME, FEATURE-DESCRIPTION, DEFINE,
DEFINE-DESCRIPTION, [ACTION-IF-ENABLED [, ACTION-IF-NOT-ENABLED]])</code>
</p>
<h2>
Description
</h2>
<div class="indent">
<p>
AX_CONFIG_FEATURE is a simple wrapper for AC_ARG_ENABLE, it enables the
feature FEATURE-NAME and AC_DEFINEs the passed DEFINE, depending on the
user choice. DESCRIPTION will be used for AC_DEFINEs. ACTION-IF-ENABLED and
ACTION-IF-NOT-ENABLED are the actions that will be run. A feature is
enabled by default, in order to change this behaviour use the
AX_CONFIG_FEATURE_DEFAULT_ENABLED and AX_CONFIG_FEATURE_DEFAULT_DISABLED
macros.
</p>
<p>
A simple example:
</p>
<pre>
AX_CONFIG_FEATURE_DEFAULT_ENABLED
AX_CONFIG_FEATURE(feature_xxxxx, [turns on/off XXXXX support],
HAVE_XXXXX, [Define if you want XXXXX support])
...
AX_CONFIG_FEATURE_DEFAULT_DISABLED
AX_CONFIG_FEATURE(feature_yyyyy, [turns on/off YYYYY support],
HAVE_YYYYY, [Define if you want YYYYY support],
[enable_yyyyy="yes"], [enable_yyyyy="no"])
AM_CONDITIONAL(YYYYY, [test "$enable_yyyyy" = "yes"])
AX_CONFIG_FEATURE_DEFAULT_ENABLED
AX_CONFIG_FEATURE(...)
...
</pre>
<p>
If you have lot of features and you want a verbose dumping of each user
selection use AX_CONFIG_FEATURE_VERBOSE. Use AX_CONFIG_FEATURE_SILENT in
order to remove a previously AX_CONFIG_FEATURE_VERBOSE. By default features
are silent.
</p>
<p>
Use AX_CONFIG_FEATURE_ENABLE or AX_CONFIG_FEATURE_DISABLE in order to
enable or disable a specific feature.
</p>
<p>
Another simple example:
</p>
<pre>
AS_IF([some_test_here],[AX_CONFIG_FEATURE_ENABLE(feature_xxxxx)],[])
AX_CONFIG_FEATURE(feature_xxxxx, [turns on/off XXXXX support],
HAVE_XXXXX, [Define if you want XXXXX support])
AX_CONFIG_FEATURE(feature_yyyyy, [turns on/off YYYYY support],
HAVE_YYYYY, [Define if you want YYYYY support],
[enable_yyyyy="yes"], [enable_yyyyy="no"])
...
</pre>
<p>
NOTE: AX_CONFIG_FEATURE_ENABLE() must be placed first of the relative
AX_CONFIG_FEATURE() macro ...
</p>
</div>
<h2>
Author
</h2>
<p class="indent">
Francesco Salvestrini <salvestrini@users.sourceforge.net>
</p>
<h2>
Last Modified
</h2>
<p class="indent">
2005-01-22
</p>
<h2>
M4 Source Code
</h2>
<div class="indent">
<pre class="m4source">
AC_DEFUN([AX_CONFIG_FEATURE],[ dnl
m4_pushdef([FEATURE], patsubst([$1], -, _))dnl
AC_ARG_ENABLE([$1],AC_HELP_STRING([--enable-$1],[$2]),[
case "${enableval}" in
yes)
ax_config_feature_[]FEATURE[]="yes"
;;
no)
ax_config_feature_[]FEATURE[]="no"
;;
*)
AC_MSG_ERROR([bad value ${enableval} for feature --$1])
;;
esac
])
AS_IF([test "$ax_config_feature_[]FEATURE[]" = yes],[ dnl
AC_DEFINE([$3])
$5
AS_IF([test "$ax_config_feature_verbose" = yes],[ dnl
AC_MSG_NOTICE([Feature $1 is enabled])
])
],[ dnl
$6
AS_IF([test "$ax_config_feature_verbose" = yes],[ dnl
AC_MSG_NOTICE([Feature $1 is disabled])
])
])
AH_TEMPLATE([$3],[$4])
m4_popdef([FEATURE])dnl
])
dnl Feature global
AC_DEFUN([AX_CONFIG_FEATURE_VERBOSE],[ dnl
ax_config_feature_verbose=yes
])
dnl Feature global
AC_DEFUN([AX_CONFIG_FEATURE_SILENT],[ dnl
ax_config_feature_verbose=no
])
dnl Feature specific
AC_DEFUN([AX_CONFIG_FEATURE_DEFAULT_ENABLED], [
ax_config_feature_[]FEATURE[]_default=yes
])
dnl Feature specific
AC_DEFUN([AX_CONFIG_FEATURE_DEFAULT_DISABLED], [
ax_config_feature_[]FEATURE[]_default=no
])
dnl Feature specific
AC_DEFUN([AX_CONFIG_FEATURE_ENABLE],[ dnl
ax_config_feature_[]patsubst([$1], -, _)[]=yes
])
dnl Feature specific
AC_DEFUN([AX_CONFIG_FEATURE_DISABLE],[ dnl
ax_config_feature_[]patsubst([$1], -, _)[]=yes
])
</pre>
</div>
</body>
</html>
|
