Javadoc 만들기 | Javadoc 옵션 지정 | -author 옵션

-author 옵션은 생성된 문서에 @author 태그로 지정된 저자를 출력하도록 지정한다. “-author” 옵션이 지정되지 않을 경우 @author 태그가 주석에 작성이 되어 있어도 생성되는 문서에 저자는 출력되지 않는다.

※ @author 태그에 대해서는 @author 태그 페이지를 참조하길 바란다.

사용법은 다음과 같다.

$ javadoc -author [대상 파일]

예를 들어 다음과 같이 실행합니다.

$ javadoc -author Sample.java

실습

간단한 예를 실습해 보도록 하겠다.

/**
 * Javadoc 테스트용 클래스
 *
 * @author devkuma
 */
public class Sample05_1 {

    /**
     * 사이즈 설정
     *
     * @param width 폭
     * @param height 높이
     */
    public void setSize(int width, int height) {

    }
}

위에 소스 코드를 “Sample05_1.java"라는 파일명으로 저장하고 저장된 디렉토리에서 다음과 같이 실행한다.

$ javadoc -d doc -author Sample05_1.java

생성된 “doc"디렉토리에 있는 “Sample05.html” 파일을 브라우저로 확인해 보자.

위와 같이 작성자에 대해 @author 태그에서 지정한 저자가 표시된다.

그럼 동일한 소스 파일로 -author 옵션을 지정하지 않고 다음과 같이 실행해 보자.

$ javadoc -d doc Sample05_1.java

생성된 “doc"디렉토리에 있는 “Sample05_1.html” 파일을 브라우저로 다시 확인해 보자.

이번에는 @author 태그가 작성이 되어 있어도 작성자는 표시되지 않는다.