On 01/08/2009, Luc Maisonobe <luc.maison...@free.fr> wrote: > Phil Steitz a écrit : > > > There have been a few comments on the size of the 2.0 binary distro. > > The last RC weighed in at 12mb/17mb gzip/zip. The large size is driven > > by the javadoc, the bundled site and the included javadoc jar. > > Uncompressed, the breakdown is as follows > > > > apidocs .....................32mb > > site minus apidocs ....36mb > > javadoc jar................4.6mb > > source jar....................973k > > binary jar....................759k > > ----------------------------------- > > total ..........................75mb > > > > As Sebb pointed out, the javadoc jar includes line-numbered linked > > source files. I have no idea what value this jar has to users in > > general much less why the linked source is there. I assume some IDEs > > make use of it somehow. Does anyone have strong feelings about the need > > to include it? If not, I propose that we drop it. > > > I think the javadoc jar is useful. It is used by IDEs for instant help > in the java editors. However, embedding the sources there is probably > not useful. > > > > > > The reason to include the site is really just for the userguide. The > > html for the guide itself is only 400k with maybe 200k of required > > images to support it. As Bill pointed out, the bundled site has broken > > links. Does anyone have any clever ideas on how we can extract the > > userguide by itself to bundle in the release? > > > The most difficult part would be to adjust the left menu. This seems to > be templates black magic to me ...
The 2.0 Javadoc link can be fixed by creating a file docs/api-2.0/index.html which does a redirect, for example: <HTML> <HEAD> <meta http-equiv="refresh" content="0;url=../apidocs/index.html" /> </HEAD> </HTML> A similar approach could be taken with other broken links. Or just add a note to say that some links are broken. > > > > Thanks in advance. > > Sorry not to be able to help > > Luc > > > > > > Phil > > > > --------------------------------------------------------------------- > > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > > For additional commands, e-mail: dev-h...@commons.apache.org > > > > > > > --------------------------------------------------------------------- > To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org > For additional commands, e-mail: dev-h...@commons.apache.org > > --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org
