0f1c1be196
We have a new policy in place making links to private resources something we try to avoid in source and test files. Normally, we'd organically switch to the new policy rather than make a sweeping change across a project. However, Clang is in a somewhat special circumstance currently: recently, I've had several new contributors run into rdar links around test code which their patch was changing the behavior of. This turns out to be a surprisingly bad experience, especially for newer folks, for a handful of reasons: not understanding what the link is and feeling intimidated by it, wondering whether their changes are actually breaking something important to a downstream in some way, having to hunt down strangers not involved with the patch to impose on them for help, accidental pressure from asking for potentially private IP to be made public, etc. Because folks run into these links entirely by chance (through fixing bugs or working on new features), there's not really a set of problematic links to focus on -- all of the links have basically the same potential for causing these problems. As a result, this is an omnibus patch to remove all such links. This was not a mechanical change; it was done by manually searching for rdar, radar, radr, and other variants to find all the various problematic links. From there, I tried to retain or reword the surrounding comments so that we would lose as little context as possible. However, because most links were just a plain link with no supporting context, the majority of the changes are simple removals. Differential Review: https://reviews.llvm.org/D158071
174 lines
4.7 KiB
Objective-C
174 lines
4.7 KiB
Objective-C
// RUN: rm -rf %t
|
|
// RUN: mkdir %t
|
|
// RUN: c-index-test -test-load-source all -comments-xml-schema=%S/../../bindings/xml/comment-xml-schema.rng -target x86_64-apple-darwin10 %s > %t/out
|
|
// RUN: FileCheck %s < %t/out
|
|
|
|
// Ensure that XML we generate is not invalid.
|
|
// RUN: FileCheck %s -check-prefix=WRONG < %t/out
|
|
// WRONG-NOT: CommentXMLInvalid
|
|
|
|
/**
|
|
* \brief This is a protocol definition
|
|
*/
|
|
@protocol MyProto
|
|
@optional
|
|
/**
|
|
* \brief MethodMyProto method
|
|
* \param[in] anObject input value
|
|
* \param[in] range output value is unsigned int
|
|
* \result return index
|
|
*/
|
|
- (unsigned int)MethodMyProto:(nullable id)anObject inRange:(unsigned int)range;
|
|
/**
|
|
* \brief PropertyMyProto - This is protocol's property.
|
|
*/
|
|
@property (copy, nonnull) id PropertyMyProto;
|
|
/**
|
|
* \brief ClassMethodMyProto
|
|
*/
|
|
+ ClassMethodMyProto;
|
|
@end
|
|
// CHECK: <Declaration>@protocol MyProto\n@end</Declaration>
|
|
// CHECK: <Declaration>- (unsigned int)MethodMyProto:(nullable id)anObject inRange:(unsigned int)range;</Declaration>
|
|
// CHECK: <Declaration>@optional\n@property(atomic, copy, readwrite, nonnull) id PropertyMyProto;</Declaration>
|
|
// CHECK: <Declaration>+ (id)ClassMethodMyProto;</Declaration>
|
|
|
|
/**
|
|
* \brief NSObject is the root class.
|
|
*/
|
|
@interface NSObject {
|
|
/**
|
|
* \brief IvarNSObject
|
|
*/
|
|
id IvarNSObject;
|
|
}
|
|
@end
|
|
// CHECK: Declaration>@interface NSObject {\n id IvarNSObject;\n}\n@end</Declaration>
|
|
// CHECK: <Declaration>id IvarNSObject</Declaration>
|
|
|
|
/**
|
|
* \brief MyClass - primary class.
|
|
*/
|
|
@interface MyClass : NSObject<MyProto>
|
|
{
|
|
/**
|
|
* \brief IvarMyClass - IvarMyClass of values.
|
|
*/
|
|
id IvarMyClass;
|
|
}
|
|
/**
|
|
* \brief MethodMyClass is instance method.
|
|
*/
|
|
- MethodMyClass;
|
|
|
|
/**
|
|
* \brief ClassMethodMyClass is class method.
|
|
*/
|
|
+ ClassMethodMyClass;
|
|
|
|
/**
|
|
* \brief PropertyMyClass - This is class's property.
|
|
*/
|
|
@property (copy) id PropertyMyClass;
|
|
@end
|
|
// CHECK: <Declaration>@interface MyClass : NSObject <MyProto> {\n id IvarMyClass;\n}\n@end</Declaration>
|
|
// CHECK: <Declaration>id IvarMyClass</Declaration>
|
|
// CHECK: <Declaration>- (id)MethodMyClass;</Declaration>
|
|
// CHECK: <Declaration>+ (id)ClassMethodMyClass;</Declaration>
|
|
// CHECK: <Declaration>@property(atomic, copy, readwrite) id PropertyMyClass;</Declaration
|
|
|
|
/**
|
|
* \brief - This is class extension of MyClass
|
|
*/
|
|
@interface MyClass()
|
|
{
|
|
/**
|
|
* \brief IvarMyClassExtension - IvarMyClassExtension private to class extension
|
|
*/
|
|
id IvarMyClassExtension;
|
|
}
|
|
@end
|
|
// CHECK: <Declaration>@interface MyClass () {\n id IvarMyClassExtension;\n}\n@end</Declaration>
|
|
// CHECK: <Declaration>id IvarMyClassExtension</Declaration>
|
|
|
|
|
|
/**
|
|
* \brief MyClass (Category) is private to MyClass.
|
|
*/
|
|
@interface MyClass (Category)
|
|
/**
|
|
* \brief This is private to MyClass
|
|
*/
|
|
- (void)MethodMyClassCategory;
|
|
|
|
/**
|
|
* \brief PropertyMyClassCategory - This is class's private property.
|
|
*/
|
|
@property (copy) id PropertyMyClassCategory;
|
|
@end
|
|
// CHECK: <Declaration>@interface MyClass (Category)\n@end</Declaration>
|
|
// CHECK: <Declaration>- (void)MethodMyClassCategory;</Declaration>
|
|
// CHECK: <Declaration>@property(atomic, copy, readwrite) id PropertyMyClassCategory;</Declaration>
|
|
// CHECK: <Declaration>- (id)PropertyMyClassCategory;</Declaration>
|
|
// CHECK: <Declaration>- (void)setPropertyMyClassCategory:(id)arg;</Declaration>
|
|
|
|
/// @implementation's
|
|
|
|
/**
|
|
* \brief implementation of MyClass class.
|
|
*/
|
|
@implementation MyClass {
|
|
/**
|
|
* \brief IvarPrivateToMyClassImpl.
|
|
*/
|
|
id IvarPrivateToMyClassImpl;
|
|
}
|
|
/**
|
|
* \brief MethodMyClass is instance method implementation.
|
|
*/
|
|
- MethodMyClass {
|
|
return 0;
|
|
}
|
|
|
|
/**
|
|
* \brief ClassMethodMyClass is class method implementation.
|
|
*/
|
|
+ ClassMethodMyClass {
|
|
return 0;
|
|
}
|
|
@end
|
|
// CHECK: <Declaration>@implementation MyClass {\n id IvarPrivateToMyClassImpl;\n id _PropertyMyClass;\n}\n@end</Declaration>
|
|
// CHECK: <Declaration>id IvarPrivateToMyClassImpl</Declaration>
|
|
// CHECK: <Declaration>- (id)MethodMyClass;</Declaration>
|
|
// CHECK: <Declaration>+ (id)ClassMethodMyClass;</Declaration>
|
|
|
|
/**
|
|
* \brief MyClass (Category) is implementation of private to MyClass.
|
|
*/
|
|
@implementation MyClass (Category)
|
|
/**
|
|
* \brief This is private to MyClass
|
|
*/
|
|
- (void)MethodMyClassCategory {}
|
|
/**
|
|
* \brief property getter
|
|
*/
|
|
- (id) PropertyMyClassCategory { return 0; }
|
|
|
|
/**
|
|
* \brief property setter
|
|
*/
|
|
- (void) setPropertyMyClassCategory : (id) arg {}
|
|
@end
|
|
// CHECK: <Declaration>@implementation MyClass (Category)\n@end</Declaration>
|
|
// CHECK: <Declaration>- (void)MethodMyClassCategory;</Declaration>
|
|
// CHECK: <Declaration>- (id)PropertyMyClassCategory;</Declaration>
|
|
// CHECK: <Declaration>- (void)setPropertyMyClassCategory:(id)arg;</Declaration>
|
|
|
|
/**
|
|
* \brief NSObject implementation
|
|
*/
|
|
@implementation NSObject
|
|
@end
|
|
// CHECK: <Declaration>@implementation NSObject\n@end</Declaration>
|