cups/versioning.h

   1 /*
   2  * "$Id$"
   3  *
   4  *   API versioning definitions for CUPS.
   5  *
   6  *   Copyright 2007-2010 by Apple Inc.
   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,
  23  * _CUPS_API_1_2, _CUPS_API_1_3, _CUPS_API_1_4, _CUPS_API_1_5 - which add
  24  * compiler-specific attributes that flag functions that are deprecated or added
  25  * in particular releases.
  26  *
  27  * On Mac 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.
  30  */
  31
  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 #    define _CUPS_API_1_1_19 AVAILABLE_MAC_OS_X_VERSION_10_3_AND_LATER
  50 #    define _CUPS_API_1_1_20 AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER
  51 #    define _CUPS_API_1_1_21 AVAILABLE_MAC_OS_X_VERSION_10_4_AND_LATER
  52 #    define _CUPS_API_1_2 AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER
  53 #    define _CUPS_API_1_3 AVAILABLE_MAC_OS_X_VERSION_10_5_AND_LATER
  54 #    define _CUPS_API_1_4 AVAILABLE_MAC_OS_X_VERSION_10_6_AND_LATER
  55 #    define _CUPS_API_1_5 AVAILABLE_MAC_OS_X_VERSION_10_7_AND_LATER
  56 #  else
  57 #    define _CUPS_API_1_1_19
  58 #    define _CUPS_API_1_1_20
  59 #    define _CUPS_API_1_1_21
  60 #    define _CUPS_API_1_2
  61 #    define _CUPS_API_1_3
  62 #    define _CUPS_API_1_4
  63 #    define _CUPS_API_1_5
  64 #  endif /* __APPLE__ && !_CUPS_SOURCE */
  65
  66 /*
  67  * With GCC 3.0 and higher, we can mark old APIs "deprecated" so you get
  68  * a warning at compile-time.
  69  */
  70
  71 #  if defined(__GNUC__) && __GNUC__ > 2
  72 #    define _CUPS_DEPRECATED __attribute__ ((__deprecated__))
  73 #  else
  74 #    define _CUPS_DEPRECATED
  75 #  endif /* __GNUC__ && __GNUC__ > 2 */
  76
  77 #  ifndef __GNUC__
  78 #    define __attribute__(x)
  79 #  endif /* !__GNUC__ */
  80
  81 #endif /* !_CUPS_VERSIONING_H_ */
  82
  83 /*
  84  * End of "$Id$".
  85  */