]>
git.ipfire.org Git - thirdparty/cups.git/blob - cups/versioning.h
f3fe9811483caa36338d4c2653c2e97e4a005b82
4 * API versioning definitions for CUPS.
6 * Copyright 2007-2012 by Apple Inc.
8 * These coded instructions, statements, and computer programs are the
9 * property of Apple Inc. and are protected by Federal copyright
10 * law. Distribution and use rights are outlined in the file "LICENSE.txt"
11 * which should have been included with this file. If this file is
12 * file is missing or damaged, see the license at "http://www.cups.org/".
14 * This file is subject to the Apple OS-Developed Software exception.
17 #ifndef _CUPS_VERSIONING_H_
18 # define _CUPS_VERSIONING_H_
21 * This header defines several constants - _CUPS_DEPRECATED,
22 * _CUPS_API_1_1, _CUPS_API_1_1_19, _CUPS_API_1_1_20, _CUPS_API_1_1_21,
23 * _CUPS_API_1_2, _CUPS_API_1_3, _CUPS_API_1_4, _CUPS_API_1_5, _CUPS_API_1_6,
24 * and _CUPS_API_1_7 - which add compiler-specific attributes that flag
25 * functions that are deprecated or added in particular releases.
27 * On OS X, the _CUPS_API_* constants are defined based on the values of
28 * the MAC_OS_X_VERSION_MIN_ALLOWED and MAC_OS_X_VERSION_MAX_ALLOWED constants
29 * provided by the compiler.
32 # if defined(__APPLE__) && !defined(_CUPS_SOURCE)
33 # include <AvailabilityMacros.h>
34 # ifndef AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER
35 # define AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER __attribute__((unavailable))
36 # endif /* !AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER */
37 # ifndef AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER
38 # define AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER __attribute__((unavailable))
39 # endif /* !AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER */
40 # ifndef AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER
41 # define AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER __attribute__((unavailable))
42 # endif /* !AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER */
43 # ifndef AVAILABLE_MAC_OS_X_VERSION_10_6_AND_LATER
44 # define AVAILABLE_MAC_OS_X_VERSION_10_6_AND_LATER __attribute__((unavailable))
45 # endif /* !AVAILABLE_MAC_OS_X_VERSION_10_6_AND_LATER */
46 # ifndef AVAILABLE_MAC_OS_X_VERSION_10_7_AND_LATER
47 # define AVAILABLE_MAC_OS_X_VERSION_10_7_AND_LATER __attribute__((unavailable))
48 # endif /* !AVAILABLE_MAC_OS_X_VERSION_10_7_AND_LATER */
49 # ifndef AVAILABLE_MAC_OS_X_VERSION_10_8_AND_LATER
50 # define AVAILABLE_MAC_OS_X_VERSION_10_8_AND_LATER __attribute__((unavailable))
51 # endif /* !AVAILABLE_MAC_OS_X_VERSION_10_8_AND_LATER */
52 # ifndef AVAILABLE_MAC_OS_X_VERSION_10_9_AND_LATER
53 # define AVAILABLE_MAC_OS_X_VERSION_10_9_AND_LATER __attribute__((unavailable))
54 # endif /* !AVAILABLE_MAC_OS_X_VERSION_10_9_AND_LATER */
55 # define _CUPS_API_1_1_19 AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER
56 # define _CUPS_API_1_1_20 AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER
57 # define _CUPS_API_1_1_21 AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER
58 # define _CUPS_API_1_2 AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER
59 # define _CUPS_API_1_3 AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER
60 # define _CUPS_API_1_4 AVAILABLE_MAC_OS_X_VERSION_10_6_AND_LATER
61 # define _CUPS_API_1_5 AVAILABLE_MAC_OS_X_VERSION_10_7_AND_LATER
62 # define _CUPS_API_1_6 AVAILABLE_MAC_OS_X_VERSION_10_8_AND_LATER
63 # define _CUPS_API_1_7 AVAILABLE_MAC_OS_X_VERSION_10_9_AND_LATER
65 # define _CUPS_API_1_1_19
66 # define _CUPS_API_1_1_20
67 # define _CUPS_API_1_1_21
68 # define _CUPS_API_1_2
69 # define _CUPS_API_1_3
70 # define _CUPS_API_1_4
71 # define _CUPS_API_1_5
72 # define _CUPS_API_1_6
73 # define _CUPS_API_1_7
74 # endif /* __APPLE__ && !_CUPS_SOURCE */
77 * With GCC 3.0 and higher, we can mark old APIs "deprecated" so you get
78 * a warning at compile-time.
81 # if defined(__GNUC__) && __GNUC__ > 2
82 # if defined(__clang__) && defined(_CUPS_NO_DEPRECATED)
83 # define _CUPS_DEPRECATED __attribute__ ((unavailable))
84 # define _CUPS_DEPRECATED_MSG(m) __attribute__ ((unavailable(m)))
85 # elif !defined(_CUPS_SOURCE) || defined(_CUPS_NO_DEPRECATED)
86 # define _CUPS_DEPRECATED __attribute__ ((deprecated))
87 # define _CUPS_DEPRECATED_MSG(m) __attribute__ ((deprecated(m)))
89 # define _CUPS_DEPRECATED
90 # define _CUPS_DEPRECATED_MSG(m)
91 # endif /* !_CUPS_SOURCE || _CUPS_NO_DEPRECATED */
93 # define _CUPS_DEPRECATED
94 # define _CUPS_DEPRECATED_MSG(m)
95 # endif /* __GNUC__ && __GNUC__ > 2 */
98 # define __attribute__(x)
99 # endif /* !__GNUC__ */
102 #endif /* !_CUPS_VERSIONING_H_ */