Objective-C 注释

1.类的注释

/**
 * @file    MyDocViewController.h
 * @brief    主页面.
 * @author    [zyl910](http://www.cnblogs.com/zyl910/)
 * @version    1.0
 * @date    2013-06-07
 *
 * update （更新日志）
 *
 * [2013-06-07] <zyl910> v1.0
 *
 * + v1.0版发布.
 *
 */

2.属性注释

@property (nonatomic,assign) NSInteger num;// 数值属性

3.方法的注释

/**
 * @brief 带字符串参数的方法.
 *
 * @param  value 值.
 *
 * @return 返回value.
 *
 * @exception NSException 可能抛出的异常.
 *
 * @see someMethod
 * @see someMethodByInt:
 * @warning 警告: appledoc中显示为蓝色背景, Doxygen中显示为红色竖条.
 * @bug 缺陷: appledoc中显示为黄色背景, Doxygen中显示为绿色竖条.
 */
- (NSString*)someMethodByStr:(NSString*)value;</span>