lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Robert Muir (Commented) (JIRA)" <>
Subject [jira] [Commented] (LUCENE-3977) generated/duplicated javadocs are wasteful and bloat the release
Date Wed, 18 Apr 2012 05:08:40 GMT


Robert Muir commented on LUCENE-3977:

OK this issue is way worse than i thought originally, in the binary release,
we actually have 3x duplication for each module, lets take 'grouping as an example'

# the grouping javadocs in docs/api/all
# the grouping javadocs in docs/api/grouping
# the lucene-grouping-javadocs.jar

This seems totally unnecessary and overkill to me. I dont think we need to include
the lucene-grouping-javadocs.jar in the binary packaging, since we already provide
it unzipped: it only needs to be in the maven artifacts. Providing it both unzipped
and zipped bloats the release.

As far as the javadocs-all stuff... I'm working on a patch :)

> generated/duplicated javadocs are wasteful and bloat the release
> ----------------------------------------------------------------
>                 Key: LUCENE-3977
>                 URL:
>             Project: Lucene - Java
>          Issue Type: Bug
>          Components: general/javadocs
>            Reporter: Robert Muir
>            Priority: Blocker
>             Fix For: 4.0
> Some stats for the generated javadocs of 3.6:
> * 9,146 files
> * 161,872 KB uncompressed
> * 25MB compressed (this is responsible for nearly half of our binary release)
> The fact we intentionally double our javadocs size with the 'javadocs-all' thing
> is truly wasteful and compression doesn't help at all. Just testing, i nuked 'all'
> and found:
> * 4,944 files
> * 81,084 KB uncompressed
> * 12.8MB compressed
> We need to clean this up for 4.0. We only need to ship javadocs 'one way'.

This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:!default.jspa
For more information on JIRA, see:


To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message