Maven 1.x Javadoc Plugin

• Type: Bug
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 1.7
• Fix Version/s: 1.8
• Component/s: None
• Labels:

  None
• Environment:

  Solaris 9 x86, Windows XP Professional, javac 1.5.0-beta2.

In version 1.5 of the javadoc plugin it was possible to specify:

maven.javadoc.additionalparam=-sourcepath /usr/java/src

so that you could include source paths where you had used the {@inheritDoc} tag. Unfortunately this is broken in version 1.7. A look at the jelly source shows that 1.7 uses <ant:sourcepath> to define where the compiled source files live. It does not seem possible to now define other paths to be set for sourcepath. Note that javadoc only allows one -sourcepath argument (it complains if you give more), and since this is controlled by the plugin you cannot extend it.

It would be good if there was a:

maven.javadoc.extrasourcepath=path1;path2;...

setting that would append to the javadoc -sourcepath argument. Without some sort of modification I cannot see how {@inheritDoc} tags can work (esp. since Sun fixed them up in 1.5).

• Assignee:

  Unassigned

  Reporter:

  Bernard Marshall

• Created:

  08/Feb/05 10:20 PM

  Updated:

  16/Dec/05 1:10 PM

  Resolved:

  16/Dec/05 1:10 PM