gcc/fastjar

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