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