[
https://issues.apache.org/jira/browse/LUCENE-3977?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13252972#comment-13252972
]
Robert Muir commented on LUCENE-3977:
-------------------------------------
{quote}
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
{quote}
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).
{quote}
oh god yes, i didn't even realize we were building that useless pile of crap
{quote}
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: https://issues.apache.org/jira/browse/LUCENE-3977
> 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:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
