git://gcc.gnu.org / gcc.git / blame
| Commit | Line | Data |
|---|---|---|
| 971b79c5 GP |
1 | This directory contains the FastJar package, which is not part of GCC but |
| 2 | shipped with GCC as convenience. | |
| 3 | ||
| bd8757b3 APB |
4 | ======= |
| 5 | FastJar 0.90 | |
| 6 | ||
| 7 | 12/6/1999 | |
| 8 | ======= | |
| 9 | ||
| 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. | |
| 16 | ||
| 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! | |
| 25 | ||
| 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. | |
| 29 | ||
| 30 | Please mail any bug reports to burnsbr@ucs.orst.edu. | |
| 31 | ||
| 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. | |
| 35 | ||
| 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... | |
| 38 | ||
| 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. | |
| 42 | ||
| 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 | |
| 54 | ||
| 55 | Unsupported flags: | |
| 56 | ---------------------------- | |
| 57 | -u | update exisiting archive | |
| 58 | ||
| 59 | If you use the "unsupported" flags, nothing bad will happen, but then again | |
| 60 | nothing will happen at all. | |
| 61 | ||
| 62 | ||
| 63 | Unsupported features (in this release): | |
| 64 | --------------------------------------------- | |
| 65 | * updating | |
| 66 | * full manifest support (?) | |
| 67 | ||
| 68 | Order or features for the future: | |
| 69 | -------------------------------------------- | |
| 70 | * archive updating | |
| 71 | * full manifest support | |
| 72 | * filtering | |
| 73 | * dependency checking | |
| 74 | ||
| 75 | ||
| 76 | =========================================================================== | |
| 77 | http://fastjar.sourceforge.net | |
| 78 | toast@users.sourceforge.net |