Maven, Javadoc: Нет исходные файлы для пакета

Question

Я пишу Maven package со структурой каталогов

frtex 
    pom.xml 
frtex/src/main/java/some-files.java 
frtex/src/main/java/utils/some-other-files.java 

Изготовление mvn test работает отлично.

Моя проблема заключается в том, что mvn javadoc:javadoc производит правильную документацию для файлов, содержащихся в frtex/src/main/java, но выпуск

[WARNING] javadoc: warning - No source files for package utils 

Вот соответствующая часть моей pom.xml (?):

<plugin> 
    <groupId>org.apache.maven.plugins</groupId> 
    <artifactId>maven-javadoc-plugin</artifactId> 
    <version>2.10.4</version> 
    <configuration> 
     <groups> 
      <group> 
       <title>TI</title> 
       <packages>frtex.*</packages> 
      </group> 
     </groups> 

     <doclet>ch.raffael.doclets.pegdown.PegdownDoclet</doclet> 
     <docletArtifact> 
      <groupId>ch.raffael.pegdown-doclet</groupId> 
      <artifactId>pegdown-doclet</artifactId> 
      <version>1.1</version> 
     </docletArtifact> 
     <useStandardDocletOptions>true</useStandardDocletOptions> 
    </configuration> 
</plugin> 

в project/build/plugins

Что делать, чтобы maven/javadoc нашел файлы в src/main/java/utils?

Answer 1

Проблема не в конфигурации вашего maven.

Для пакета utils вам необходимо указать package-info.java.

Это файл, расположенный по адресу src/main/java/utils/package-info.java, который будет содержать javadoc для пакета, в отличие от javadoc для класса.

Дополнительную информацию о пакете javadocs, you can read the documentation.