[
https://issues.apache.org/jira/browse/LUCENE-3977?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel
]
Robert Muir updated LUCENE-3977:
--------------------------------
Attachment: LUCENE-3977.patch
Updated patch that improves our docs/api/index.html (the javadocs-index.html
task), to also include the project description (from the ant file).
I also tried to clean up these descriptions and make them useful. I think the
index.html looks much more useful now, and this is really a possible way we can
nuke the manually-maintained forrest index under src/site in the future (but
not here).
> 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
>
> Attachments: LUCENE-3977-triplication.patch, LUCENE-3977.patch,
> LUCENE-3977.patch, LUCENE-3977.patch
>
>
> 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]
