괜히 즐거움...

/**
  @file     hello.c
  @brief    hello world  소스파일.

  파일여러줄 설명입니다.\n
  진짜 여러줄 입니다.\n
  음.. 하나. 둘. 셋
  넷다섯.
  */

/**
  @mainpage   Hello World 메인페이지
  @section intro 소개
  - 소개      :   프로그램의 기본을 배울수있는 프로그램.
  @section   Program 프로그램명
  - 프로그램명  :   Hello World 프로그램.
  - 프로그램내용    :   화면에 Hello World!을 출력한다.
  @section  INOUTPUT    입출력자료
  - INPUT           :   없음.
  - OUTPUT      :   Hello World 화면출력.
  @section  CREATEINFO      작성정보
  - 작성자      :   infiniterun
  - 작성일      :   2005/04/18
  @section  MODIFYINFO      수정정보
  - 수정자/수정일   : 수정내역
  - infiniterun/2005.0418    :   "Helo World"에 "!"추가
  */

#include <stdio.h>

#define MAX_READ_BUF   1024    /**< 최대 read buffer size      */

short  port;                   /**< Telnet port number */

/**
  @brief buffer structor

  Telnet에서 정송되는 데이터에 대해 프로토콜을 처리해야 하기 위하여,
  효율적으로 데이터를 전송해야 할 입출력 버퍼 structor
  */
struct  buffer
{
    char       *buf;   /**< 데이터를 저장할 주소공간   */
    int        size;   /**< buf에 할당된 메모리 크기   */
    int        head;   /**< buf에 저장된 데이터의 처음 Index   */
    int        tail;   /**< buf에 저장된 데이터의 마지막 index */
    int        count;  /**< buf에 저장된 데이터의 byte 수      */
};

/** @brief TRUE FALSE정의. */
enum BOOLEAN
{
    FALSE=0,        /**< FALSE */
    TRUE            /**< TRUE */
};

/**
  @brief     hello Main 함수.

  긴 설명은 한줄을 넘긴다음 넣어준다. \n
  하나둘. 셋.. 넷..
  다섯.. 여섯.. \n

  @return    성공여부.
  */
int main(
        int    argc,       /**< 인자개수 */
        char * argv[]      /**< 인자 */
        )
{
    printf("Hello World!\n");
    return 0;
}

예전에는 doxygen을 사용하려고 add-in 설정하고 하느라 많은 시간을 보냈었습니다. 근데 오히려 add-in툴을 안쓰는게 더 이해가 쉽군요..

doxygen-1.5.8-setup.exe
graphviz-2.22.2.msi
이렇게만 설치하고 html문서로 만들어내니 간단하고 좋네요...

위는 c 소스에서 doxygen을 위한 작성 요령입니다.