20b2ebd785
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.
llvm-svn: 128127
50 lines
1.2 KiB
Objective-C
50 lines
1.2 KiB
Objective-C
// RUN: %clang_cc1 -fsyntax-only -verify %s
|
|
|
|
__attribute ((unavailable))
|
|
@protocol FwProto; // expected-note{{marked unavailable}}
|
|
|
|
Class <FwProto> cFw = 0; // expected-error {{'FwProto' is unavailable}}
|
|
|
|
|
|
__attribute ((deprecated)) @protocol MyProto1
|
|
@end
|
|
|
|
@protocol Proto2 <MyProto1> // expected-warning {{'MyProto1' is deprecated}}
|
|
+method2;
|
|
@end
|
|
|
|
|
|
@interface MyClass1 <MyProto1> // expected-warning {{'MyProto1' is deprecated}}
|
|
{
|
|
Class isa;
|
|
}
|
|
@end
|
|
|
|
@interface Derived : MyClass1 <MyProto1> // expected-warning {{'MyProto1' is deprecated}}
|
|
{
|
|
id <MyProto1> ivar; // expected-warning {{'MyProto1' is deprecated}}
|
|
}
|
|
@end
|
|
|
|
@interface MyClass1 (Category) <MyProto1, Proto2> // expected-warning {{'MyProto1' is deprecated}}
|
|
@end
|
|
|
|
|
|
|
|
Class <MyProto1> clsP1 = 0; // expected-warning {{'MyProto1' is deprecated}}
|
|
|
|
@protocol FwProto @end // expected-note{{marked unavailable}}
|
|
|
|
@interface MyClass2 <FwProto> // expected-error {{'FwProto' is unavailable}}
|
|
@end
|
|
|
|
__attribute ((unavailable)) __attribute ((deprecated)) @protocol XProto; // expected-note{{marked unavailable}}
|
|
|
|
id <XProto> idX = 0; // expected-error {{'XProto' is unavailable}}
|
|
|
|
int main ()
|
|
{
|
|
MyClass1 <MyProto1> *p1; // expected-warning {{'MyProto1' is deprecated}}
|
|
}
|
|
|