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

Allow Javadoc Jar to contain Maven descriptor

    XMLWordPrintableJSON

    Details

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

      Description

      The javadoc:jar mojo explicitly prevents the Maven descriptor from being added to the produced javadoc.jar file.

      https://github.com/apache/maven-plugins/blob/trunk/maven-javadoc-plugin/src/main/java/org/apache/maven/plugin/javadoc/JavadocJar.java#L299-299

      I could not find an explanation or technical reason why this is done.

      Adding the maven descriptor to the javadoc jar can help expose valuable information about the build that produced it and should be at the discretion of the build process.

      Expected:

      • allow the archiver used to create the javadoc jar to respect the plexus archiver configuration if it is configured to include the Maven descriptor.
      • preserve the default behaviour of not including the Maven descriptor, for (unknown) backwards compatibility reasons only

        Attachments

          Issue Links

            Activity

              People

              • Assignee:
                michael-o Michael Osipov
                Reporter:
                peterlynch Peter lynch
              • Votes:
                0 Vote for this issue
                Watchers:
                5 Start watching this issue

                Dates

                • Created:
                  Updated:
                  Resolved: