home *** CD-ROM | disk | FTP | other *** search
/ Programmer 7500 / MAX_PROGRAMMERS.iso / PROGRAMS / UTILS / COMPRESS / LZESHELL.ZIP / LZESHELL.DOC next >
Encoding:
Text File  |  1990-03-14  |  5.8 KB  |  114 lines
  1.                                  LZESHELL.EXE
  2.                                   Version 1.0
  3.  
  4.      ┌───────────────────────────────────────────────────────────────────┐
  5.      │  An English language shell program for running Fabrice Bellard's  │
  6.      │   LZEXE file compression utility for EXE files.  Also runs his    │
  7.      │      UPACKEXE program for unpacking EXE files that have been      │
  8.      │     processed with Microsoft's EXEPACK utility, so LZEXE can      │
  9.      │                  achieve maximum compression.                     │
  10.      └───────────────────────────────────────────────────────────────────┘
  11.  
  12.  
  13.  
  14. AUTHOR:  Pete Petrakis, CIS 76555,1175
  15.  
  16.  
  17. DESCRIPTION
  18.  
  19. This program is designed to work only with version 0.91 of LZEXE, a utility
  20. that can compress EXE files substantially while leaving them executable.  The
  21. compressions LZEXE achieves are usually in the range of 30 to 40 percent,
  22. although they are often higher than that.  Programs compressed with LZEXE
  23. decompress themselves when they are run.  The decompression time is negligible.
  24. LZEXE was written by Fabrice Bellard, of Grabels, France and is still under
  25. development.
  26.  
  27.   Version 0.91 of LZEXE overcomes version 0.90's problem of excessive load
  28. memory size for compressed files.  The compressed files now take about the same
  29. amount of memory to load as they did before compression.  For this reason my
  30. previous shell program LZEFIX, which ran Microsoft's EXEMOD header utility
  31. to reduce the excessive load sizes created by version 0.90, should not be used
  32. with version 0.91.  It isn't needed.  In fact it could cause problems
  33. (including having to reboot your system) if you try to use it with this newer
  34. version of LZEXE.  Accordingly, LZESHELL makes no adjustment to the headers of
  35. compressed EXE files.
  36.  
  37.   Unlike the previous version of LZEXE, version 0.91 prompts, in French, for
  38. user input, depending on what it finds out about the file you have asked it
  39. to compress.  LZESHELL translates the prompts into English (the translation
  40. is not literal).  That's not all it does, however.
  41.  
  42.   LZESHELL also automates the use of two of Bellard's utilities:  LZEXE v0.91,
  43. of course, and a new program he has written called UPACKEXE v1.00.  UPACKEXE
  44. unpacks EXE files that have been compressed with Microsoft's EXEPACK utility.
  45. Unpacking such files allows LZEXE to do an even better compression job.
  46.  
  47.   Version 0.91 of LZEXE can detect files that have been EXEPACKed.  When it
  48. does, it tells you so and asks whether it should continue the compression or
  49. quit so you can run UPACKEXE first.  In that situation, you would normally end
  50. up running two programs manually.  When you use LZESHELL, however, you
  51. don't have to quit if you want to use UPACKEXE.  LZESHELL translates the
  52. prompt into English, and if your response is that you want to unpack the file
  53. before compressing it, it immediately runs UPACKEXE.  Then it runs LZEXE to
  54. complete the compression.  In other words, you don't go back to DOS until
  55. both programs have been run.  The effect is to make these two fine utilities
  56. act as a single program.
  57.  
  58.   Both UPACKEXE and LZEXE save source files as backups, changing their names
  59. to *.OLD.  This can create a problem when you run UPACKEXE then run LZEXE.
  60. The *.OLD backup file saved by UPACKEXE will be replaced by the *.OLD file
  61. saved by LZEXE -- you end up losing the EXEPACKed *.OLD file.  LZESHELL
  62. eliminates this problem by immediately renaming the *.OLD file produced by
  63. UPACKEXE to *.OPK.  This leaves you with two backup files -- one for the
  64. original EXEPACKed file (*.OPK) and one for the unpacked file (*.OLD).  The
  65. third file will be your compressed EXE file.  If the compressed file works,
  66. you can remove both backup files from your disk.  Otherwise, you can erase
  67. the compressed EXE file and rename one of the backups to *.EXE (probably the
  68. EXEPACKed one, *.OPK, since it's the original and it's smaller).
  69.  
  70.   LZESHELL also generates English prompts for another situation that LZEXE
  71. v.0.91 detects, namely the use of overlays by the EXE file.  Here you are
  72. given the choice of aborting the compression or continuing it (taking the
  73. chance that the compressed file won't work).  LZEXE v0.91 also detects
  74. "internal overlays" (I'm not sure what those are), but in that situation it
  75. only issues a warning and requires no user choices.  LZESHELL translates the
  76. warning into English.
  77.  
  78.   Finally, LZESHELL readjusts the timestamp on the compressed file so it's the
  79. same as it was in the original file.  When LZEXE is run by itself it always
  80. gives the compressed file the current date, which some people feel is a short-
  81. coming since it obliterates a useful identifier.
  82.  
  83.  
  84. RUNNING THE PROGRAM
  85.  
  86. LZESHELL (v1.0), LZEXE (v.0.91), and UPACKEXE (v1.00), or their directories,
  87. should be on your system's path (use the DOS PATH command to do this,
  88. preferably in an AUTOEXEC.BAT file).  This will allow you move freely from
  89. directory to directory to compress EXE files.  You should always go to the
  90. directory of the file you want to compress.
  91.  
  92.   To run the program type the following at the DOS prompt:
  93.  
  94.               LZESHELL [EXE file to be compressed]
  95.  
  96.   Translated warnings and prompts will appear in a box on your screen.  At the
  97. end of the compression a "scorecard" will appear showing you the file size
  98. before and after compression, the size reduction in bytes, and the percent
  99. reduction.
  100.  
  101.  
  102. DISTRIBUTION 
  103.  
  104. LZESHELL may be freely distributed provided it's not modified and no money
  105. is charged for it. 
  106.  
  107.  
  108. DISCLAIMER 
  109.  
  110. Pete Petrakis accepts no responsibility or liability for any mishap 
  111. resulting from the use of LZESHELL.  To protect yourself against loss of
  112. valuable files you are advised to keep backups in a safe place or to check
  113. the performance of compressed files thoroughly before discarding their backups.
  114.