projects / thirdparty / cups.git / blame
| Commit | Line | Data |
|---|---|---|
| e94d2f10 MS |
1 | /* |
| 2 | * "$Id$" | |
| 3 | * | |
| aaf19ab0 | 4 | * API versioning definitions for CUPS. |
| e94d2f10 | 5 | * |
| f3c17241 | 6 | * Copyright 2007-2012 by Apple Inc. |
| e94d2f10 MS |
7 | * |
| 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/". | |
| 13 | * | |
| 14 | * This file is subject to the Apple OS-Developed Software exception. | |
| 15 | */ | |
| 16 | ||
| 17 | #ifndef _CUPS_VERSIONING_H_ | |
| 18 | # define _CUPS_VERSIONING_H_ | |
| 19 | ||
| 20 | /* | |
| 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, | |
| a469f8a5 MS |
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. | |
| 749b1e90 | 26 | * |
| f3c17241 | 27 | * On OS X, the _CUPS_API_* constants are defined based on the values of |
| 749b1e90 | 28 | * the MAC_OS_X_VERSION_MIN_ALLOWED and MAC_OS_X_VERSION_MAX_ALLOWED constants |
| e94d2f10 MS |
29 | * provided by the compiler. |
| 30 | */ | |
| 31 | ||
| 32 | # if defined(__APPLE__) && !defined(_CUPS_SOURCE) | |
| 749b1e90 MS |
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 */ | |
| 7cf5915e MS |
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 */ | |
| 85dda01c MS |
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 */ | |
| a469f8a5 MS |
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 */ | |
| 749b1e90 MS |
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 | |
| 7cf5915e | 61 | # define _CUPS_API_1_5 AVAILABLE_MAC_OS_X_VERSION_10_7_AND_LATER |
| c41769ff MS |
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 | |
| e94d2f10 MS |
64 | # else |
| 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 | |
| c7017ecc | 71 | # define _CUPS_API_1_5 |
| 85dda01c | 72 | # define _CUPS_API_1_6 |
| a469f8a5 | 73 | # define _CUPS_API_1_7 |
| 5bd77a73 | 74 | # endif /* __APPLE__ && !_CUPS_SOURCE */ |
| e94d2f10 MS |
75 | |
| 76 | /* | |
| 77 | * With GCC 3.0 and higher, we can mark old APIs "deprecated" so you get | |
| 78 | * a warning at compile-time. | |
| 79 | */ | |
| 80 | ||
| a469f8a5 | 81 | # if defined(__GNUC__) && __GNUC__ > 2 |
| c1420c87 MS |
82 | # ifndef __has_extension |
| 83 | # define __has_extension(x) 0 | |
| 84 | # endif /* !__has_extension */ | |
| 85 | # if __has_extension(attribute_unavailable_with_message) && defined(_CUPS_NO_DEPRECATED) | |
| a469f8a5 MS |
86 | # define _CUPS_DEPRECATED __attribute__ ((unavailable)) |
| 87 | # define _CUPS_DEPRECATED_MSG(m) __attribute__ ((unavailable(m))) | |
| 88 | # elif !defined(_CUPS_SOURCE) || defined(_CUPS_NO_DEPRECATED) | |
| 89 | # define _CUPS_DEPRECATED __attribute__ ((deprecated)) | |
| 90 | # define _CUPS_DEPRECATED_MSG(m) __attribute__ ((deprecated(m))) | |
| 91 | # else | |
| 92 | # define _CUPS_DEPRECATED | |
| 93 | # define _CUPS_DEPRECATED_MSG(m) | |
| 94 | # endif /* !_CUPS_SOURCE || _CUPS_NO_DEPRECATED */ | |
| e94d2f10 MS |
95 | # else |
| 96 | # define _CUPS_DEPRECATED | |
| a469f8a5 MS |
97 | # define _CUPS_DEPRECATED_MSG(m) |
| 98 | # endif /* __GNUC__ && __GNUC__ > 2 */ | |
| e94d2f10 | 99 | |
| aaf19ab0 MS |
100 | # ifndef __GNUC__ |
| 101 | # define __attribute__(x) | |
| 102 | # endif /* !__GNUC__ */ | |
| 103 | ||
| e94d2f10 MS |
104 | #endif /* !_CUPS_VERSIONING_H_ */ |
| 105 | ||
| 106 | /* | |
| 107 | * End of "$Id$". | |
| 108 | */ |