[jira] [Created] (MJAVADOC-431) allow javadoc jar to contain Maven descriptor

["Peter lynch (JIRA)" <ji...@apache.org>]

Peter lynch created MJAVADOC-431:
------------------------------------

             Summary: allow javadoc jar to contain Maven descriptor
                 Key: MJAVADOC-431
                 URL: https://issues.apache.org/jira/browse/MJAVADOC-431
             Project: Maven Javadoc Plugin
          Issue Type: Bug
    Affects Versions: 2.10.3
            Reporter: Peter lynch


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



--
This message was sent by Atlassian JIRA
(v6.3.4#6332)