You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@openjpa.apache.org by "ASF subversion and git services (JIRA)" <ji...@apache.org> on 2013/08/22 03:50:51 UTC

[jira] [Commented] (OPENJPA-1459) Remove 'heavy' documentation objects from the binary distribution

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

ASF subversion and git services commented on OPENJPA-1459:
----------------------------------------------------------

Commit 1516357 from [~mikedd] in branch 'openjpa/trunk'
[ https://svn.apache.org/r1516357 ]

OPENJPA-1459: Add new archive that doesn't include sources or javadocs
                
> 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
>
> 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