mirror of
https://github.com/llvm/llvm-project.git
synced 2025-04-27 19:56:06 +00:00
5ec0c7536a
Doxygen manual claims that multiple \brief or \returns commands will be merged together, but actual behavior is different (second \brief command becomes a part of a discussion, second \returns becomes a "Returns: blah" paragraph on its own). Anyway, it seems to be a bad idea to use multiple \brief or \returns commands in a single command. llvm-svn: 161325
94 lines
2.6 KiB
Objective-C
94 lines
2.6 KiB
Objective-C
// RUN: %clang_cc1 -fsyntax-only -Wno-objc-root-class -Wdocumentation -Wdocumentation-pedantic -verify %s
|
|
|
|
@class NSString;
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@interface Test1
|
|
// expected-warning@+2 {{empty paragraph passed to '\brief' command}}
|
|
/**
|
|
* \brief\author Aaa
|
|
* \param aaa Aaa
|
|
* \param bbb Bbb
|
|
*/
|
|
+ (NSString *)test1:(NSString *)aaa suffix:(NSString *)bbb;
|
|
|
|
// expected-warning@+2 {{parameter 'aab' not found in the function declaration}} expected-note@+2 {{did you mean 'aaa'?}}
|
|
/**
|
|
* \param aab Aaa
|
|
*/
|
|
+ (NSString *)test2:(NSString *)aaa;
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@property int test3; // a property: ObjCPropertyDecl
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@property int test4; // a property: ObjCPropertyDecl
|
|
@end
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@interface Test1()
|
|
@end
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@implementation Test1 // a class implementation : ObjCImplementationDecl
|
|
+ (NSString *)test1:(NSString *)aaa suffix:(NSString *)bbb {
|
|
return 0;
|
|
}
|
|
|
|
+ (NSString *)test2:(NSString *)aaa {
|
|
return 0;
|
|
}
|
|
|
|
@synthesize test3; // a property implementation: ObjCPropertyImplDecl
|
|
@dynamic test4; // a property implementation: ObjCPropertyImplDecl
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
NSString *_test5;
|
|
@end
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@interface Test1(Test1Category) // a category: ObjCCategoryDecl
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
+ (NSString *)test3:(NSString *)aaa;
|
|
@end
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@implementation Test1(Test1Category) // a category implementation: ObjCCategoryImplDecl
|
|
+ (NSString *)test3:(NSString *)aaa {
|
|
return 0;
|
|
}
|
|
@end
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@protocol TestProto1 // a protocol: ObjCProtocolDecl
|
|
@end
|
|
|
|
int a;
|
|
|
|
// expected-warning@+1 {{empty paragraph passed to '\brief' command}}
|
|
/// \brief\author Aaa
|
|
@interface Test4
|
|
@end
|
|
|
|
int b;
|
|
|
|
@interface TestReturns1
|
|
/// \returns Aaa
|
|
- (int)test1:(NSString *)aaa;
|
|
|
|
// expected-warning@+1 {{'\returns' command used in a comment that is attached to a method returning void}}
|
|
/// \returns Aaa
|
|
- (void)test2:(NSString *)aaa;
|
|
@end
|
|
|