'\" t
.\"     Title: waffle_feature_test_macros
.\"    Author: Chad Versace <chad.versace@linux.intel.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 03/25/2021
.\"    Manual: Waffle Manual
.\"    Source: waffle
.\"  Language: English
.\"
.TH "WAFFLE_FEATURE_TEST_" "7" "03/25/2021" "waffle" "Waffle Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
waffle_feature_test_macros \- Macros to control definitions exposed by Waffle\*(Aqs headers
.SH "SYNOPSIS"
.sp
.nf
\fBWAFFLE_API_VERSION\fR
\fBWAFFLE_API_EXPERIMENTAL\fR
    
.fi
.SH "DESCRIPTION"
.PP
Waffle\*(Aqs feature test macros allow the programmer to control the definitions that are exposed by Waffle\*(Aqs headers when a program is compiled\&. Conversely, the macros allow the programmer to control which Waffle features a program\*(Aqs source relies on\&.
.PP
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\&.
.SS "Specification of feature test macro requirements in manual pages"
.PP
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\&.
.SS "List of feature test macros"
.PP
\fBWAFFLE_API_VERSION\fR (since waffle 1\&.3)
.RS 4
This macro controls the API version exposed by Waffle\*(Aqs headers\&. The value
((\fImajor\fR << 8) | \fIminor\fR)
exposes the API of Waffle
\fImajor\fR\&.\fIminor\fR\&. 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\&.
.RE
.PP
\fBWAFFLE_API_EXPERIMENTAL\fR
.RS 4
This macro exposes experimental features in Waffle\*(Aqs headers\&. Experimental features may be altered or removed without notice and do not belong to Waffle\*(Aqs stable API\&.
.RE
.SH "ISSUES"
.PP
Please report bugs or and feature requests to
\m[blue]\fB\%https://gitlab.freedesktop.org/mesa/waffle/issues\fR\m[]\&.
.SH "SEE ALSO"
.PP
.RS 4
\fBwaffle\fR(7)
.RE
.RS 4
\fBfeature_test_macros\fR(7)
.RE
.SH "AUTHOR"
.PP
\fBChad Versace\fR <\&chad\&.versace@linux\&.intel\&.com\&>
.RS 4
Maintainer
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2013 Intel
.br
.PP
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
\m[blue]\fB\%http://creativecommons.org.license/by-sa/3.0/us\fR\m[]\&.
.sp