[jira] [Created] (MSHADE-245) Add optional parameter "createJavadocJar"

["Fabrizio Cucci (JIRA)" <ji...@apache.org>]

Fabrizio Cucci created MSHADE-245:
-------------------------------------

             Summary: Add optional parameter "createJavadocJar"
                 Key: MSHADE-245
                 URL: https://issues.apache.org/jira/browse/MSHADE-245
             Project: Maven Shade Plugin
          Issue Type: Wish
    Affects Versions: 2.4.3
            Reporter: Fabrizio Cucci


According to [this|http://central.sonatype.org/pages/requirements.html#supply-javadoc-and-sources] Sonatype OSS requirement:

bq. Projects with packaging other than pom have to supply JAR files that contain Javadoc and sources. ... If, for some reason (for example, license issue or it's a Scala project), you can not provide -sources.jar or -javadoc.jar , please make fake -sources.jar or -javadoc.jar with simple README inside to pass the checking.

When repackaging some dependency, it's fairly easy to create the -source.jar artifact with the maven-shade-plugin through the *createSourcesJar* optional parameter. 

It would be nice to let the plugin also generate the -javadoc.jar through an analogous optional parameter, e.g. *createJavadocJar*.

So far, I couldn't find an easy way to achieve the above (i.e. aggregate the javadoc of all shaded dependencies) and I've opted for the workaround suggested by the OSS requirement (i.e. fake -javadoc.jar) in order to deploy my artifact on Maven Central.

Please find my solution [here|https://github.com/fabriziocucci/yacl4j/tree/master/yacl4j-repackaged-jackson].



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