Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

javadoc 툴을 이용하여 javadocs 를 생성해주는 plugin.

 


Goals

사용

Project report 에서 javadoc

...

정의

Code Block
languagexml
 <reporting>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2<version>3.91.1<0</version>
        <configuration>

        </configuration>
      </plugin>
    </plugins>
  </reporting>

mvn site 실행시 javadoc 도 같이 생성된다.

...

Build 태그에서 javadoc

...

정의

Code Block
languagexml
title설정
<build>
    <plugins>
      <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-javadoc-plugin</artifactId>
        <version>2<version>3.91.1<0</version>
        <configuration>
             <show>private</show>
             <nohelp>true</nohelp>
        </configuration>
      </plugin>
    </plugins>
  </build>

...

Code Block
<configuration>
    <excludePackageNames>com.mycompany.myapp.package1.*:com.mycompany.myapp.package2:*.util.*</excludePackageNames>
</configuration>

 


Javadoc 을 remote 에 upload 하기

 

Java 8 의 Doclint 중지하기

Java 8 은 Javadoc 에 대해서도 lint 를 수행하므로 잘못된 doc이 있을 경우 warning이 아닌 error로 처리해서 javadoc 생성을 중지한다. 장기적으로는 정확한 javadoc 을 작성하는게 좋겠지만 error 로 인해 생성이 안 될 경우 다음 설정으로 예전처럼 warning으로 처리할 수 있다.

Code Block
<configuration>
   <doclint>none</doclint>
</configuration>


Ref

...