Maven Javadoc Plugin
  1. Maven Javadoc Plugin
  2. MJAVADOC-325

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

        Hide
        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
        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
        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
        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
        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
        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
        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
          • Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

            • Created:
              Updated:
              Resolved: