Uploaded image for project: 'Maven Javadoc Plugin'
  1. Maven Javadoc Plugin
  2. MJAVADOC-162

javadocExecutable unusable

    XMLWordPrintableJSON

Details

    • Bug
    • Status: Closed
    • Major
    • Resolution: Fixed
    • 2.3
    • 2.5
    • None
    • None
    • Windows XP and non-Windows

    Description

      AbstractJavadocMojo tries to be smart by seeing if the file indicated by javadocExecutable exists, but this is actually quite problematic. If you put the following in your config:

      <javadocExecutable>blahblahblah${file.separator}javadoc</javadocExecutable>

      then you'll get an error on Windows since the file is actually javadoc.exe, which is a pain since it's perfectly acceptable to omit the .exe when executing a command.

      If you put .exe in the config, then it won't work on non-Windows platforms since the files doesn't have .exe.

      Forcing users to add hackery to their POMs to add .exe in some cases and leave it off in others is onerous.

      Methinks it's much preferable to simply use the path provided by the config. If it doesn't exist, let CommandLineUtils.executeCommandLine (or something else) throw an exception.

      Attachments

        1. javadoc-executable.patch
          1 kB
          Benjamin Bentmann

        Activity

          People

            bentmann Benjamin Bentmann
            bfs8fsbn Greg Thompson
            Votes:
            1 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: