나의 Doxygen Quick Guide

개발하다 보면 문서를 만들긴 만들어야 하지만.. 그래도

나중에 내가 보기 위해서라도 Doxygen을 쓰면 편하다.

Doxygen 을 쓰는법등은 다른 블러그에 많이 나와있고.

내가 Doxygen을 쓰면서 다는 주석방식.. 아래와.. 같네용.. 뭐 보실분들이 있을라마는 ^^;

<< Doxygen Quick Guide >>

*Doxygen 기본 스타일
   /** */

*주석안에 아이템들
 @breif ==> 설명을 쓴다. 여러줄을 쓸때에는 @breif를 쓰고 한줄 띄운다움 계속해서
               쓰면된다.
 @file ==> 파일 이름을 구별할때.
 @return ==> 함수의 리턴값 나타낼때.
 @author ==> 작성자 이름을 나타낼때
 @date ==> 작성날짜를 나타낼때.
 @param ==> 함수 파라메터를 나타낼때
 @see ==> 참고할 함수나 페이지를 지정한다.
 @todo
 @bug
 @code ==>중요 코드를 설명할때 시작 지점 가리킨다.
 @endcode ==> 중요코드 설명할때 종료 지점 가리킨다.
 @exeception
 @mainpage
 @section

 ====클래스 처리===
 @class ==> 클래스명 나타낼때.
 *클래스 멤버에대한 처리
 /// 이렇게 표시한다.(단 멤버 상단에 표시할것!!)
 /**< 내용 */ 이렇게도 표시한다. (멤버 옆에)
 ///< 이렇게도 표시한다.(멤버옆에)
 
 ====enum 타입처리====
*상단에 @brief로 무엇을 하는것인지 나타내고
 각각의 멤버에 대해서는.
 /*!< 내용 */  이렇게 표시한다. (멤버 옆에)
 /**< 내용 */ 이렇게도 표시한다. (멤버 옆에)
 ///< 이렇게도 표시한다.(멤버옆에)

===중요 코드도 주석을 단다.===
@code 로 시작해서
@endcode 로 끝낸다.

 예제)
     /**
      * @brief 예제코드
      *
      *  추가설명
      * @code
        *........
        * @endcode
      */

심플 그자체~~ 이것만 있어도 왠만한 주석은..

참고로 이걸 수작업으로 치시는건.. 참 ㅡ,.ㅡ vc 매크로로 활용하시기 바랍니다. 호응이 있을경우 매크로를 올리죠 ~