[
https://issues.apache.org/jira/browse/LUCENE-6257?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14327836#comment-14327836
]
Steve Rowe commented on LUCENE-6257:
------------------------------------
bq. Prior to acceptance of a candidate release, the ASF repo mgr does a
"quality check", making sure metadata is present and consistent, required files
are present, etc. I suspect it will auto-reject a release without javadocs
jars. I'll test by posting a fake artifact bundle without a javadoc jar and see
if it passes the quality check.
I tested (via {{ant stage-maven-artifacts}}, after removing javadoc artifact
staging from {{write.stage.maven.build.xml.pl}}) using a fake "5.0.1-test"
release including only analyzers-common, lucene-parent and
lucene-solr-grandparent (last two required for POM resolution), with the
javadoc jar and its GPG signature removed, and I successfully "closed" the
repository on ASF Nexus - that's the process where the quality checks are run.
So at a minimum, we can get past the ASF quality checks without including
javadoc jars.
I'll survey recent releases for other Apache projects to see whether any of
them have gotten away with excluding javadoc jars.
> Remove javadocs from releases (except for publishing)
> -----------------------------------------------------
>
> Key: LUCENE-6257
> URL: https://issues.apache.org/jira/browse/LUCENE-6257
> Project: Lucene - Core
> Issue Type: Improvement
> Reporter: Ryan Ernst
>
> In LUCENE-6247, one idea discussed to decrease the size of release artifacts
> was to remove javadocs from the binary release. Anyone needing javadocs
> offline can download the source distribution and generate the javadocs.
> I also think we should investigate removing javadocs jars from maven. I did
> a quick test, and getting the source in intellij seemed sufficient to show
> javadocs. However, this test was far from scientific, so if someone knows
> for sure whether a separate javadocs jar is truly necessary, please say so.
> Regardless of the outcome of the two ideas above, we would continue building,
> validating and making the javadocs available online.
--
This message was sent by Atlassian JIRA
(v6.3.4#6332)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
