gcc/fastjar
DJ Delorie 121cb775c1 Makefile.am (jar.1, grepjar.1): Protect against texi2pod/pod2man failing.
* Makefile.am (jar.1, grepjar.1): Protect against
texi2pod/pod2man failing.
* Makefile.in: Regenerated.

From-SVN: r60653
2002-12-30 16:32:30 -05:00
..
.cvsignore Makefile.in: Rebuilt. 2002-09-12 00:40:12 +00:00
acinclude.m4 Merge basic-improvements-branch to trunk 2002-12-16 18:23:00 +00:00
aclocal.m4 Merge basic-improvements-branch to trunk 2002-12-16 18:23:00 +00:00
AUTHORS fastjar: Imported. 2000-12-08 19:08:23 -08:00
ChangeLog Makefile.am (jar.1, grepjar.1): Protect against texi2pod/pod2man failing. 2002-12-30 16:32:30 -05:00
CHANGES fastjar: Imported. 2000-12-08 19:08:23 -08:00
compress.c re PR bootstrap/5117 (irix6.5 bootstrap failure when using SGI's compiler) 2002-01-03 04:57:56 +00:00
compress.h Warning fixes: 2000-12-14 18:45:35 +00:00
config.h.in jartool.c (add_to_jar): Only compare file to jarfile if jarfile is non-NULL. 2002-11-10 22:04:24 +01:00
configure Merge basic-improvements-branch to trunk 2002-12-16 18:23:00 +00:00
configure.in Merge basic-improvements-branch to trunk 2002-12-16 18:23:00 +00:00
COPYING fastjar: Imported. 2000-12-08 19:08:23 -08:00
dostime.c dostime.c (dos2unixtime): Mask for seconds is 0x1f. 2002-11-11 22:20:56 +00:00
dostime.h dostime.c: Rewrote from scratch. 2002-11-07 14:07:19 +00:00
fastjar.texi gcj.texi: Include Cover Texts in man page. 2002-12-23 21:16:23 +00:00
INSTALL fastjar: Imported. 2000-12-08 19:08:23 -08:00
install-defs.sh.in fastjar: Imported. 2000-12-08 19:08:23 -08:00
install-sh fastjar: Imported. 2000-12-08 19:08:23 -08:00
jargrep.c Merge basic-improvements-branch to trunk 2002-12-16 18:23:00 +00:00
jargrep.h For PR libgcj/5303: 2002-01-09 23:22:20 +00:00
jartool.c Merge basic-improvements-branch to trunk 2002-12-16 18:23:00 +00:00
jartool.h fastjar: Imported. 2000-12-08 19:08:23 -08:00
Makefile.am Makefile.am (jar.1, grepjar.1): Protect against texi2pod/pod2man failing. 2002-12-30 16:32:30 -05:00
Makefile.in Makefile.am (jar.1, grepjar.1): Protect against texi2pod/pod2man failing. 2002-12-30 16:32:30 -05:00
missing fastjar: Imported. 2000-12-08 19:08:23 -08:00
mkinstalldirs fastjar: Imported. 2000-12-08 19:08:23 -08:00
NEWS fastjar: Imported. 2000-12-08 19:08:23 -08:00
pushback.c re PR bootstrap/5117 (irix6.5 bootstrap failure when using SGI's compiler) 2002-01-03 04:57:56 +00:00
pushback.h fastjar: Imported. 2000-12-08 19:08:23 -08:00
README fastjar: Imported. 2000-12-08 19:08:23 -08:00
stamp-h.in fastjar: Imported. 2000-12-08 19:08:23 -08:00
zipfile.h fastjar: Imported. 2000-12-08 19:08:23 -08:00

=======
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