Maven 1.x Javadoc Plugin

target/javadoc is empty

Details

  • Type: Wish Wish
  • Status: Open Open
  • Priority: Major Major
  • Resolution: Unresolved
  • Affects Version/s: 1.6.1
  • Fix Version/s: None
  • Component/s: None
  • Labels:
    None
  • Environment:
    windows xp / java sdk 1.4.2 / java component build with maven
  • Number of attachments :
    0

Description

I have just started off with Maven...

I have in the folloing directory structure for my java project:
<projectname>/src/IntegrationTests
<projectname>/src/ServiceLayer

in the folder <projectname>, i have the project.xml that states that the source directory is
<sourceDirectory>
src/ServiceLayer
</sourceDirectory>

and unit test directory as <unitTestSourceDirectory>src/IntegrationTests</unitTestSourceDirectory>

when i run the following maven commands in sequence:

1. maven java:compile
2. maven jar
3. maven site:generate

the folder target/javadoc remains empty

Issues are:

1. Only one leaf folder in the folder ServiceLayer is getting the Javadoc generated, others donot have their javadocs generated
2. Also javadocs are not getting generated for the folder <projectname>/src/IntegrationTests

I have tried with the javadoc plug in version maven-javadoc-plugin-1.6.1

Although i download the latest version 1.7, it still downloads the old version 1.6.1 and apparently uses it.

Please help...

Activity

Ascending order - Click to sort in descending order
Hide
Permalink
Joerg Schaible added a comment -

What's in pom.package ?

Show
Joerg Schaible added a comment - What's in pom.package ?
Hide
Permalink
Anup Jain added a comment -

By changing the pom.package value to a folder which is one rung above, i am able to address point #1,
but i am still not able to generate javadocs as per point #2.

Also, please tell me where i need to change so that maven uses
maven-javadoc-plugin-1.7 instead of maven-javadoc-plugin-1.6.1.

Issues highlighted:
1. Only one leaf folder in the folder ServiceLayer is getting the Javadoc generated, others donot have their javadocs generated
2. Also javadocs are not getting generated for the folder <projectname>/src/IntegrationTests

Show
Anup Jain added a comment - By changing the pom.package value to a folder which is one rung above, i am able to address point #1, but i am still not able to generate javadocs as per point #2. Also, please tell me where i need to change so that maven uses maven-javadoc-plugin-1.7 instead of maven-javadoc-plugin-1.6.1. Issues highlighted: 1. Only one leaf folder in the folder ServiceLayer is getting the Javadoc generated, others donot have their javadocs generated 2. Also javadocs are not getting generated for the folder <projectname>/src/IntegrationTests
Hide
Permalink
Arnaud Heritier added a comment -

Did you install it with the command below ?
maven plugin:download -DgroupId=maven -DartifactId=maven-javadoc-plugin -Dversion=1.7

If you did it manually you must remove the plugin directory in you cache (~.maven/cache/)

Show
Arnaud Heritier added a comment - Did you install it with the command below ? maven plugin:download -DgroupId=maven -DartifactId=maven-javadoc-plugin -Dversion=1.7 If you did it manually you must remove the plugin directory in you cache (~.maven/cache/)
Hide
Permalink
Robin S Levine added a comment -

Also having the same issue. Upgraded to JS2E 1.5 and javadoc plugin stopped working with maven.

Its not throwing any errors however ...

Show
Robin S Levine added a comment - Also having the same issue. Upgraded to JS2E 1.5 and javadoc plugin stopped working with maven. Its not throwing any errors however ...
Hide
Permalink
Arnaud Heritier added a comment -

I didn't yet test it with the jdk 1.5.
Can you run it in debug mode please and send us the log ?

maven -Dmaven.javadoc.debug=true javadoc

Thx

Show
Arnaud Heritier added a comment - I didn't yet test it with the jdk 1.5. Can you run it in debug mode please and send us the log ? maven -Dmaven.javadoc.debug=true javadoc Thx
Hide
Permalink
Arnaud Heritier added a comment -

Wasn't fix in 1.6.1

Show
Arnaud Heritier added a comment - Wasn't fix in 1.6.1
Hide
Permalink
Bernard Durfee added a comment -

I had the same problem, turns out I had renamed my package structure, but not updated the 'package' element in the POM. That fixed it and JavaDoc was generated again. Maybe this issue could be resolved by simply warning the user when the JavaDoc is not going to be created because no classes exist in the pom.package.

Show
Bernard Durfee added a comment - I had the same problem, turns out I had renamed my package structure, but not updated the 'package' element in the POM. That fixed it and JavaDoc was generated again. Maybe this issue could be resolved by simply warning the user when the JavaDoc is not going to be created because no classes exist in the pom.package.

People

Vote (0)
Watch (2)

Dates

  • Created:
    Updated:

Time Tracking

Estimated:
10m
Original Estimate - 10 minutes
Remaining:
10m
Remaining Estimate - 10 minutes
Logged:
Not Specified
Time Spent - Not Specified
Atlassian JIRA (v4.4.3#663-r165197) | Report a problem
Powered by a free Atlassian JIRA open source license for Codehaus. Try JIRA - bug tracking software for your team.