Dead
[official-gcc.git] / gomp-20050608-branch / fastjar / README
bloba16a501829d39fefa13e330eb7f2a41a54b1bf17
1 This directory contains the FastJar package, which is not part of GCC but
2 shipped with GCC as convenience.
4 =======
5 FastJar 0.90
7 12/6/1999
8 =======
10 FastJar is an attempt at creating a feature-for-feature copy of Sun's JDK's
11 'jar' command.  Sun's jar (or Blackdown's for that matter) is written entirely
12 in Java which makes it dog slow.  Since FastJar is written in C, it can create
13 the same .jar file as Sun's tool in a fraction of the time.  On my system,
14 Sun's jar takes 50 seconds to create a 10MB jar file, while FastJar only takes
15 a little over a second.  
17 The reason I wrote fastjar is that building .jar files is a regular process
18 of the build where I work.  The way we have it setup, you have to re-create
19 the .jar file everytime you want to test it out, which is about every 5 minutes
20 when I'm busy coding.  The .jar file wasn't -that- big, but it did take about
21 30 seconds to be made, and watching all the garbage collection messages was
22 pretty irritating as well.  I probably wasted a half-hour a day watching
23 Sun's jar tool chug along.  By writing the program in C, I spend much less time
24 banging my head against the monitor waiting for the build to finish.  Yay!
26 FastJar has been tested on Solaris and Linux 2.2.x systems and nothing else. 
27 It should compile/run without any problems on either system, provided you have
28 zlib installed.  
30 Please mail any bug reports to burnsbr@ucs.orst.edu.
32 If you use FastJar and want me to add the rest of the features, send me mail
33 (toast@users.sourceforge.net).  I'll be much more likely to put more work into this
34 if I know other people find it useful other than me.
36 As always, this not being a final release, bugs may exist.  I test each
37 release pretty well, but I can always miss things...
39 Compression will slow things down quite a bit.  A 10MB jar file takes about
40 1 second on my machine without compression, and 9 seconds with it.  If you
41 want fastjar to be fast, use the -0 (zero, not O) flag to turn off compression.
43 Supported flags:
44 --------------------------
45 -c  | create a new archive
46 -v  | verbose output
47 -f  | specify archive file name
48 -m  | specify existing manifest file
49 -M  | don't create manifest
50 -0  | store only
51 -C  | change to dir
52 -t  | list contents
53 -x  | extract contents
55 Unsupported flags:
56 ----------------------------
57 -u  | update exisiting archive
59 If you use the "unsupported" flags, nothing bad will happen, but then again
60 nothing will happen at all.  
63 Unsupported features (in this release):
64 ---------------------------------------------
65   * updating
66   * full manifest support (?)
68 Order or features for the future:
69 --------------------------------------------
70   * archive updating
71   * full manifest support
72   * filtering
73   * dependency checking
76 ===========================================================================
77 http://fastjar.sourceforge.net
78 toast@users.sourceforge.net