一份 c++的DoxyGen 的注释模板

看了一些资源,以下是总结出的一份模板:
在最后附效果。


///
///  You should have received a copy of the GNU General Public License         
///  along with OST. If not, see .               
///                                                                            
///  @file     MyClass.h                                                       
///  @brief    这个类的主要作用是...                                                                              
///  @author   krishna_Lee                                                                                                        
///  @version  1.0.0.1                                                
///  @date     2017.01.25                                                                                
///                                                                          
///

#ifndef LIBRARY_NAME_COMPONENT_NAME_H_INCLUDED
#define LIBRARY_NAME_COMPONENT_NAME_H_INCLUDED

/** 
    这是MyClass类的说明
*/
class MyClass
{
public:

    /** 简要说明1 */
    void function1() const noexcept;

    /** 简要说明2

        详细说明2
    */
    void function2() const noexcept;

    /** 简要说明3

        详细说明3
        详细说明3...
    */
    void function3() const noexcept;

    /** 简要说明4

        详细说明4
        详细说明4...

        @param arg1     参数1的说明...
        @param arg2     参数2的说明...
    */
    void function4(bool arg1, bool arg2);

    /** 简要说明5

        详细说明5
        详细说明5...

        @param arg1     参数1的说明...
        @param arg2     参数2的说明...
        @return         返回值的说明...
    */
    int function5(int arg1, int arg2);

    /** 简要说明6

        详细说明6
        详细说明6...

        @param arg1     参数1的说明...
        @param arg2     参数2的说明...
        @return         返回值的说明...
        @see function1  参考(链接function1)
        @note           注释...
        @attention      注意...
        @bug            存在的问题...
        @warning        警告...
    */
    int function6(int arg1, int arg2);

    /** 简要说明MyEnum...

        详细说明MyEnum...
    */
    enum MyEnum
    {
      int EVal1,     ///< 后置简要说明EVal1...
      int EVal2      ///< 后置简要说明EVal2...
    };
protected:
    int value; ///< 后置简要说明value...
}

#endif// LIBRARY_NAME_COMPONENT_NAME_H_INCLUDED

一份 c++的DoxyGen 的注释模板_第1张图片

你可能感兴趣的:(common)