1WAFFLE_FEATURE_TEST_(7) Waffle Manual WAFFLE_FEATURE_TEST_(7)
2
3
4
6 waffle_feature_test_macros - Macros to control definitions exposed by
7 Waffle's headers
8
10 WAFFLE_API_VERSION
11 WAFFLE_API_EXPERIMENTAL
12
13
15 Waffle's feature test macros allow the programmer to control the
16 definitions that are exposed by Waffle's headers when a program is
17 compiled. Conversely, the macros allow the programmer to control which
18 Waffle features a program's source relies on.
19
20 In order to be effective, a feature test macro must be defined before
21 including any header files. This can be done either in the compilation
22 command (cc -DMACRO=value) or by defining the macro within the source
23 code before including any headers.
24
25 Specification of feature test macro requirements in manual pages
26 When a function requires that a feature test macro be defined, the
27 manual page docments it in the SYNOPSIS. When an enum or macro requires
28 that a feature test macro be defined, the manual page documents it
29 either in the SYNOPSIS or where the enum or macro first appears in the
30 page.
31
32 List of feature test macros
33 WAFFLE_API_VERSION (since waffle 1.3)
34 This macro controls the API version exposed by Waffle's headers.
35 The value ((major << 8) | minor) exposes the API of Waffle
36 major.minor. For example, the value 0x0103 exposes the API of
37 Waffle 1.3. If this macro is undefined, then the headers expose the
38 API of Waffle 1.2.
39
40 WAFFLE_API_EXPERIMENTAL
41 This macro exposes experimental features in Waffle's headers.
42 Experimental features may be altered or removed without notice and
43 do not belong to Waffle's stable API.
44
46 Please report bugs or and feature requests to
47 https://gitlab.freedesktop.org/mesa/waffle/issues.
48
50 waffle(7)
51 feature_test_macros(7)
52
54 Chad Versace <chad.versace@linux.intel.com>
55 Maintainer
56
58 Copyright © 2013 Intel
59
60 This manual page is licensed under the Creative Commons
61 Attribution-ShareAlike 3.0 United States License (CC BY-SA 3.0). To
62 view a copy of this license, visit
63 http://creativecommons.org.license/by-sa/3.0/us.
64
65
66
67
68waffle 07/22/2023 WAFFLE_FEATURE_TEST_(7)