डॉक्सीजन और ऑब्जेक्टिव-सी श्रेणियां

Question

हालांकि डॉक्सिजन claim better handling of Objective-C categories की नवीनतम रिलीज, फिर भी यह मेरे स्रोत कोड में श्रेणियों पर चकित प्रतीत होता है। मैं सोच रहा हूं कि किसी ने इसे दस्तावेज़ श्रेणियों को सही तरीके से प्राप्त कर लिया है।

एक उदाहरण के रूप में, मैं NSString पर एक वर्ग के रूप में परिभाषित किया गया है: एक अंतरफलक NSString_CCFExtensions.h नामक फ़ाइल और कार्यान्वयन फ़ाइल के साथ

@interface NSString (CCFExtensions) 

NSString_CCFExtension.m

Doxygen सुपर क्लास के साथ फ़ाइल का संदर्भ लेंगे ; लेकिन प्रतीत होता है कि वैध डॉक्सिजन सिंटैक्स के बावजूद श्रेणी श्रेणियों में से कोई भी दस्तावेज नहीं है।

उद्देश्य-सी श्रेणियां काम करने के लिए सही स्रोत मार्कअप क्या है?

Answer 1

कुछ प्रतिगमन परीक्षण (और एक छोटे से सामान्य ज्ञान) समाधान करने के बाद:

:

मान लीजिए कि मैं NSObject पर एक वर्ग cat1 है, Doxygen मेरी श्रेणी हैडर फ़ाइल को पार्स करने के लिए, इसे इस तरह मोटे तौर पर देखना चाहिए चलो

#import <Cocoa/Cocoa.h> 

/*! \category NSObject(Cat1) 
    \abstract A category on NSObject 
*/ 

@interface NSObject(Cat1) 
    - (void)foo; 
@end 

और कार्यान्वयन फ़ाइल:

#import "NSObject_Cat1.h" 

@implementation NSObject(Cat1) 

- (void)foo { 
    // do something 
} 

@end 

महत्वपूर्ण रूप से, वर्ग के नाम और श्रेणी के नाम के बीच स्पेस नहीं रख दें।