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