Maven 2.x Javadoc Plugin

Incorrect -link is generated when its URL contains a comma

Details

  • Type: Bug Bug
  • Status: Closed Closed
  • Priority: Minor Minor
  • Resolution: Fixed
  • Affects Version/s: 2.8
  • Fix Version/s: 2.8.1
  • Labels:
    None
  • Environment:
  • Number of attachments :
    0

Description

I consistently get this error when generating javadoc:

Exit code: 1 - javadoc: error - Illegal package name: ""

I tracked it down to how the plugin's options file is generated. The new Oracle JDK 1.5 javadoc link is this:
http://download.oracle.com/javase/1,5,0/docs/api/

There's a comma between the 1 and the 5. The comma is somehow being used as a separator for the plugin because this gets generated:

-link
'http://download.oracle.com/javase/1
-link
5.0/docs/api'

Bascially, I can't generate 1.5 javadoc with the new Oracle link.

Activity

Ascending order - Click to sort in descending order
Hide
Permalink
Paul Benedict added a comment -

I can verify a spurious -link gets generated for each comma in the <link> element. BTW, I configured my plugin in the <build> section.

Show
Paul Benedict added a comment - I can verify a spurious -link gets generated for each comma in the <link> element. BTW, I configured my plugin in the <build> section.
Hide
Permalink
Herve Boutemy added a comment -

strange: can you give a sample project causing this?

I don't understand how you get these commas since they are points in sources

Show
Herve Boutemy added a comment - strange: can you give a sample project causing this? I don't understand how you get these commas since they are points in sources
Hide
Permalink
Paul Benedict added a comment -

Herve, google "java 1.5 api" and you will see the web links contain a comma.

Show
Paul Benedict added a comment - Herve, google "java 1.5 api" and you will see the web links contain a comma.
Hide
Permalink
Jörg Schaible added a comment -

Oracle uses dots for the official links to the various javadoc versions:
http://www.oracle.com/technetwork/java/javase/documentation/api-jsp-136079.html

Show
Jörg Schaible added a comment - Oracle uses dots for the official links to the various javadoc versions: http://www.oracle.com/technetwork/java/javase/documentation/api-jsp-136079.html
Hide
Permalink
Paul Benedict added a comment - - edited

Well, evidently Oracle is not being consistent. As I said, do the google search. You will see 1 COMMA 5 DOT 0 in the URL. I am not kidding. Aside from this fact, there's a bug in that the plugin is improperly taking commas and breaking apart the URL. That's still an issue to be fixed.

Show
Paul Benedict added a comment - - edited Well, evidently Oracle is not being consistent. As I said, do the google search. You will see 1 COMMA 5 DOT 0 in the URL. I am not kidding. Aside from this fact, there's a bug in that the plugin is improperly taking commas and breaking apart the URL. That's still an issue to be fixed.
Hide
Permalink
Robert Scholte added a comment -

Lowering priority to minor, because there's a workaround for this case: use dots instead of comma's.

Show
Robert Scholte added a comment - Lowering priority to minor, because there's a workaround for this case: use dots instead of comma's.
Hide
Permalink
Robert Scholte added a comment -

Fixed in rev. 1176059

Show
Robert Scholte added a comment - Fixed in rev. 1176059

People

  • Assignee:
    Robert Scholte
    Reporter:
    Paul Benedict
Vote (0)
Watch (2)

Dates

  • Created:
    Updated:
    Resolved: