openjpa-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Michael Dick (JIRA)" <j...@apache.org>
Subject [jira] [Commented] (OPENJPA-1459) Remove heavy documentation objects from the binary distribution
Date Wed, 28 Aug 2013 23:55:51 GMT

    [ https://issues.apache.org/jira/browse/OPENJPA-1459?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13753051#comment-13753051
] 

Michael Dick commented on OPENJPA-1459:
---------------------------------------

Hi Kevin,

Well, I'm confused. If this is resolved I'll be happy to revert the changes, but I see different
results. I just downloaded OpenJPA-2.2.2-binary.zip, and it has ~ 100MB of docs (mainly javadoc).
A local build of 2.3.0-SNAPSHOT has roughly the same. Could the zip you're looking at have
been built without the javadoc-profile enabled? 
                
> Remove heavy documentation objects from the binary distribution 
> ----------------------------------------------------------------
>
>                 Key: OPENJPA-1459
>                 URL: https://issues.apache.org/jira/browse/OPENJPA-1459
>             Project: OpenJPA
>          Issue Type: Improvement
>          Components: build / infrastructure
>    Affects Versions: 1.2.3, 1.3.0, 2.0.0
>            Reporter: Michael Dick
>            Assignee: Michael Dick
>            Priority: Minor
>             Fix For: 2.2.3
>
>
> Per Kevin's comment in the OpenJPA 1.2.2 release vote [1] our binary distribution contains
a large amount of documentation files (roughly 90% of the archive is docs). Kevin posed the
question of whether other Apache projects include docs in their distributions.
> So I took a random (and small) sampling : 
> * HTTPServer only delivers binaries for Windows as a .msi file - I'm not sure whether
the docs are included there or not. 
> * Ant 1.8.0-RC1 includes documentation in the binary distribution.
> * Derby 10.5.3.0 includes documentation in the binary distribution
> * OpenEJB 3.1.2 does not include documentation in the binary distribution
> The results don't show a clear trend (maybe a larger sample size would reveal one), but
it looks like we have leeway here to include or omit documentation in our releases. 
> Also FWIW OpenEJB and Derby's binary distributions are roughly the same size as OpenJPA
1.2.2 (around 18MB), Ant is a bit smaller (around 7 MB). 
> Removing all docs would put the size around 5.8 MB, removing just the javadoc (the larger
portion of documentation) puts the size around 11 MB. 
> [1]  http://markmail.org/message/gqlt25vpdgba3glq

--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators
For more information on JIRA, see: http://www.atlassian.com/software/jira

Mime
View raw message