fastjar/README

   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