openjpa-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Michael Dick (JIRA)" <>
Subject [jira] [Resolved] (OPENJPA-1459) Remove 'heavy' documentation objects from the binary distribution
Date Thu, 22 Aug 2013 01:52:53 GMT


Michael Dick resolved OPENJPA-1459.

       Resolution: Fixed
    Fix Version/s: 2.2.3

Fixed in trunk. A new binary was created that doesn't include the javadoc and sources. The
size for me was 15M.

It's arbitrarily named suffixed with 'just-binaries' for now, but I'd propose that we change
it to -binaries, and rename the old -binaries to -full, or -all. 
> Remove 'heavy' documentation objects from the binary distribution 
> ------------------------------------------------------------------
>                 Key: OPENJPA-1459
>                 URL:
>             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 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]

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:

View raw message