---
name: "waffle_feature_test_macros"
section: "7"
platform: "linux"
package: "libwaffle-doc"
version: "1.8.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/waffle_feature_test_macros"
---

# waffle\_feature\_test\_macros(7)

Macros to control definitions exposed by Waffle's headers

## NAME

waffle\_feature\_test\_macros - Macros to control definitions exposed by Waffle's headers

## SYNOPSIS

```
WAFFLE_API_VERSION
WAFFLE_API_EXPERIMENTAL
```

## DESCRIPTION

Waffle's feature test macros allow the programmer to control the definitions that are exposed by Waffle's headers when a program is compiled. Conversely, the macros allow the programmer to control which Waffle features a program's source relies on.

In order to be effective, a feature test macro must be defined before including any header files. This can be done either in the compilation command (cc -DMACRO=value) or by defining the macro within the source code before including any headers.

### Specification of feature test macro requirements in manual pages

When a function requires that a feature test macro be defined, the manual page docments it in the SYNOPSIS. When an enum or macro requires that a feature test macro be defined, the manual page documents it either in the SYNOPSIS or where the enum or macro first appears in the page.

### List of feature test macros

**WAFFLE\_API\_VERSION** (since waffle 1.3)

This macro controls the API version exposed by Waffle's headers. The value ((*major* \<\< 8) \| *minor*) exposes the API of Waffle *major*.*minor*. For example, the value 0x0103 exposes the API of Waffle 1.3. If this macro is undefined, then the headers expose the API of Waffle 1.2.

**WAFFLE\_API\_EXPERIMENTAL**

This macro exposes experimental features in Waffle's headers. Experimental features may be altered or removed without notice and do not belong to Waffle's stable API.

## ISSUES

Please report bugs or and feature requests to **https://gitlab.freedesktop.org/mesa/waffle/issues**.

## SEE ALSO

[**waffle**(7)](/waffle/7.md)

[**feature\_test\_macros**(7)](/feature_test_macros/7.md)

## AUTHOR

**Chad Versace** \<chad.versace@linux.intel.com\>

Former maintainer

## COPYRIGHT

Copyright © 2013 Intel\

This manual page is licensed under the Creative Commons Attribution-ShareAlike 3.0 United States License (CC BY-SA 3.0). To view a copy of this license, visit **http://creativecommons.org.license/by-sa/3.0/us**.