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 Thu, 12 Apr 2012 23:39:20 GMT


Robert Muir commented on LUCENE-3977:

at this point in my life, i don't really have an opinion, as long as we include at least one
copy in the bin release

Well I was thinking, the javadocs-all really tries to be what the 'individual modules' version
is! It tries (and fails) to separate packages according to contrib modules that "own" them,
but this is all screwed up, sure o.a.l.index.pruning is marked underneath the pruning module
but the PruningReader is actually in o.a.l.index.

There are many other examples. So it seems to me that if they individual modules javadocs
actually linked to each other correctly, then to the user it really gives us that same result,
but without the duplication. Hell, if that still isn't good enough we could figure out some
way to make 'massive useless class list' that links to all the correct places but I think
thats not useful (thus, the crazy logic in build.xml to try to separate contribs into packages).

oh god yes, i didn't even realize we were building that useless pile of crap

Ok, I don't think this one is controversial: its an easy win, I'll commit it tonight or tomorrow
(even though i still want to nuke the other 80MB from the duplication issue... thats harder)

> 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