Java 주석 가이드

How to Write Doc Comments for the Javadoc Tool

Java 주석 가이드, 자바 코멘트 가이드

1 예시

/**
 * Returns an Image object that can then be painted on the screen. 
 * The url argument must specify an absolute {@link URL}. The name
 * argument is a specifier that is relative to the url argument. 
 * <p>
 * This method always returns immediately, whether or not the 
 * image exists. When this applet attempts to draw the image on
 * the screen, the data will be loaded. The graphics primitives 
 * that draw the image will incrementally paint on the screen. 
 *
 * @param  url  an absolute URL giving the base location of the image
 * @param  name the location of the image, relative to the url argument
 * @return      the image at the specified URL
 * @see         Image
 */
 public Image getImage(URL url, String name) {
        try {
            return getImage(new URL(url, name));
        } catch (MalformedURLException e) {
            return null;
        }
 }

2 같이 보기

• Javadoc 만들기
• Bash 주석 가이드
• Java
• 주석

3 참고 자료

• http://www.oracle.com/technetwork/java/javase/documentation/index-137868.html