]> granicus.if.org Git - clang/commit
Implement a new 'availability' attribute, that allows one to specify
authorDouglas Gregor <dgregor@apple.com>
Wed, 23 Mar 2011 00:50:03 +0000 (00:50 +0000)
committerDouglas Gregor <dgregor@apple.com>
Wed, 23 Mar 2011 00:50:03 +0000 (00:50 +0000)
commit0a0d2b179085a52c10402feebeb6db8b4d96a140
treee97aeca336472a81235e8bd034f648b034094e81
parent9a8ad9b28d54a3adc4cb8061d564f99f80144e30
Implement a new 'availability' attribute, that allows one to specify
which versions of an OS provide a certain facility. For example,

  void foo()
  __attribute__((availability(macosx,introduced=10.2,deprecated=10.4,obsoleted=10.6)));

says that the function "foo" was introduced in 10.2, deprecated in
10.4, and completely obsoleted in 10.6. This attribute ties in with
the deployment targets (e.g., -mmacosx-version-min=10.1 specifies that
we want to deploy back to Mac OS X 10.1). There are several concrete
behaviors that this attribute enables, as illustrated with the
function foo() above:

  - If we choose a deployment target >= Mac OS X 10.4, uses of "foo"
    will result in a deprecation warning, as if we had placed
    attribute((deprecated)) on it (but with a better diagnostic)
  - If we choose a deployment target >= Mac OS X 10.6, uses of "foo"
    will result in an "unavailable" warning (in C)/error (in C++), as
    if we had placed attribute((unavailable)) on it
  - If we choose a deployment target prior to 10.2, foo() is
    weak-imported (if it is a kind of entity that can be weak
    imported), as if we had placed the weak_import attribute on it.

Naturally, there can be multiple availability attributes on a
declaration, for different platforms; only the current platform
matters when checking availability attributes.

The only platforms this attribute currently works for are "ios" and
"macosx", since we already have -mxxxx-version-min flags for them and we
have experience there with macro tricks translating down to the
deprecated/unavailable/weak_import attributes. The end goal is to open
this up to other platforms, and even extension to other "platforms"
that are really libraries (say, through a #pragma clang
define_system), but that hasn't yet been designed and we may want to
shake out more issues with this narrower problem first.

Addresses <rdar://problem/6690412>.

As a drive-by bug-fix, if an entity is both deprecated and
unavailable, we only emit the "unavailable" diagnostic.

git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@128127 91177308-0d34-0410-b5e6-96231b3b80d8
45 files changed:
include/clang/AST/ASTContext.h
include/clang/AST/Attr.h
include/clang/AST/Decl.h
include/clang/AST/DeclBase.h
include/clang/Basic/Attr.td
include/clang/Basic/DiagnosticGroups.td
include/clang/Basic/DiagnosticParseKinds.td
include/clang/Basic/DiagnosticSemaKinds.td
include/clang/Basic/TargetInfo.h
include/clang/Basic/VersionTuple.h [new file with mode: 0644]
include/clang/Parse/Parser.h
include/clang/Sema/AttributeList.h
include/clang/Sema/Sema.h
include/clang/Serialization/ASTReader.h
include/clang/Serialization/ASTWriter.h
lib/AST/ASTContext.cpp
lib/AST/DeclBase.cpp
lib/AST/ExprConstant.cpp
lib/Basic/CMakeLists.txt
lib/Basic/TargetInfo.cpp
lib/Basic/Targets.cpp
lib/Basic/VersionTuple.cpp [new file with mode: 0644]
lib/CodeGen/CGObjCMac.cpp
lib/CodeGen/CodeGenModule.cpp
lib/Parse/ParseDecl.cpp
lib/Parse/Parser.cpp
lib/Sema/AttributeList.cpp
lib/Sema/CodeCompleteConsumer.cpp
lib/Sema/SemaDeclAttr.cpp
lib/Sema/SemaDeclObjC.cpp
lib/Sema/SemaExpr.cpp
lib/Sema/SemaExprCXX.cpp
lib/Sema/SemaObjCProperty.cpp
lib/Sema/SemaOverload.cpp
lib/Serialization/ASTReader.cpp
lib/Serialization/ASTWriter.cpp
test/CodeGenObjC/attr-availability.m [new file with mode: 0644]
test/Parser/attr-availability.c [new file with mode: 0644]
test/Sema/attr-availability-ios.c [new file with mode: 0644]
test/Sema/attr-availability-macosx.c [new file with mode: 0644]
test/Sema/attr-availability.c [new file with mode: 0644]
test/SemaCXX/attr-unavailable.cpp
test/SemaObjC/protocol-attribute.m
test/SemaObjC/special-dep-unavail-warning.m
tools/libclang/CIndex.cpp