home *** CD-ROM | disk | FTP | other *** search
/ Chip Hitware 3 / Chip_Hitware_Vol_03.iso / chiphit3 / _archiv / packer / diet / diet144.doc < prev    next >
Text File  |  1992-04-29  |  34KB  |  768 lines

  1.                        DIET version 1.44
  2.               ------  by Teddy Matsumoto ---------
  3.            *******************************************
  4.  
  5. 1.0.  OVERVIEW.
  6.  
  7. DIET.EXE reduces the disk-storage space that executable and data
  8. files need WITHOUT giving up immediate access to such files.
  9. DIET is a Freeware Program.
  10.  
  11.   (a)   When DIET compresses an EXECUTABLE file (.EXE or .COM),
  12.         it adds a header that automatically expands the file when
  13.         it is executed.
  14.  
  15.   (b)   DIET reduces the size of the average .EXE & .COM files by
  16.         40%.
  17.  
  18.   (c)   Self-expansion of DIETed .EXE & .COM files is so fast
  19.         that it is difficult to measure the change in the speed
  20.         of file execution.  You certainly won't notice any
  21.         change.
  22.  
  23.   (d)   The self-expanding feature of DIET is similar to PKLITE
  24.         or LZEXE, but DIET also lets you compress overlay files,
  25.         which PKLITE and LZEXE cannot do.
  26.  
  27. What makes DIET unique is its ability to compress DATA Files and
  28. to automatically expand them when you call them into an editor to
  29. read or change them.
  30.  
  31.   (a)   To use that feature, you must load DIET as a TSR file.
  32.  
  33.   (b)   DIET reduces the size of an average Data File by 2/3rd.
  34.  
  35.   (c)   DIET's automatic expansion of Data Files adds a little
  36.         time (about 3 sec. when loading a 100k byte unDIETed text
  37.         file into an editor).  But that is a small price for the
  38.         benefit of being able to keep infrequently-used Data
  39.         Files on your Hard Disk, instead of storing them on
  40.         floppies. And you can optionally set up DIET so that it
  41.         will recompress Data Files when you exit your Editor.
  42.  
  43. This document is the USER'S GUIDE for DIET v.1.44.  To learn
  44. about DIET's internals and changes from version to version, see
  45. DIETAPI.DOC and DIETTECH.DOC  That much more technical document is
  46. of no importance to the average USER of DIET, but is available 
  47. for programmers and the curious. DIETTECH.DOC is not included in
  48. this package, since complete approved documentation in English is
  49. not prepared yet.
  50.  
  51.  
  52. 2.0.  A QUICK INTRODUCTION TO DIET CAN DO.
  53.  
  54.   Familiar filenames of DOS are of three types, roughly speaking.
  55.    Executable Files with Extensions .COM or .EXE.
  56.    Device Drivers with Extensions .SYS or .DRV
  57.    and other
  58.    Data files with various extensions as .DAT,.DOC,.TXT etc.
  59.  
  60.   DIET compresses Executables and Drivers to files of the same
  61.   nature so that you can execute or call from CONFIG.SYS as
  62.   Device Drivers as they were. Let me call these files of type
  63.   Self-eXtracting.
  64.  
  65.   You can DIET other data files too, but you can not use them
  66.   unless you decompress by DIET manually or by TSR DIET auto-
  67.   matically. Let me call these files as Data type.
  68.  
  69.   To compress your files on the current directory, you just type:
  70.       DIET filename
  71.   or with wildcard:
  72.       DIET *.*
  73.   There are some options in DIET, but without any otption,
  74.   Diet compress executables and drivers into SFX type and
  75.   other files into Data type. To see the effect of compression
  76.   type:
  77.       DIET -l.
  78.   You will see all the files in your current directory with those
  79.   compressed filenames in reverse color. To restore your files,
  80.   type
  81.       DIET -r.
  82.   You will note some of the files are left DIETED. They are SFX
  83.   type files. Try some command to assure you that an exectable
  84.   file works as you type the command from the compressed size,
  85.   hence the name Self-eXtracting.
  86.  
  87.   An application package consists of executables and data files
  88.   which are called and used by executables. The simplest use
  89.   of DIET is, you compress only executables and let data files
  90.   stay as they are. You can do this by 'DIET *.*' ,'DIET -r '.
  91.  
  92. 2.1  DIET in Terminate and Stay Resident Mode.
  93.   
  94. We assume you're displaying this file on your console, using the
  95. DOS MORE command, Vernon Buerg's LIST.COM, or your favorite
  96. Editor.  Try the following:
  97.  
  98.   (a)   Return to DOS.
  99.  
  100.   (b)   Execute:
  101.                             DIET DIET144.DOC
  102.         That will compress this file.  If you now try view the
  103.         file with MORE, or read it with LIST or your favorite
  104.         editor, you'll get garbage.
  105.  
  106.   (c)   Now Execute:
  107.                                  DIET -Z
  108.         That will load DIET as a TSR, which allows you to display
  109.         DIET144.DOC with MORE, LIST, or your Editor.
  110.  
  111.   (d)   Remove the DIET TSR by executing:
  112.                                 DIET -ZR
  113.  
  114.   (e)   Finally, unDIET DIET144.DOC by executing:
  115.                           DIET -RA DIET144.DOC
  116.  
  117.  
  118. 3.0.  DIET's BASIC OPTIONS:
  119.  
  120.       The basic DIET command structure is:
  121.                   DIET [options] [file_names].
  122.  
  123.       (You may use either '-' or '/' as the option-prefix)
  124.  
  125.                         (Wildcards are OK in filenames)
  126.  
  127.    Multiple options need a space between them, e.g:
  128.                        DIET -Z -P -TD:\tmp
  129.  
  130.       Options are classified into two categories:
  131.          Basic options to specify DIET functions,
  132.          Auxiliary otpions to control basic options.
  133.  
  134. Summary of Options.
  135.          Main and auxiliarly options are tabulated below.
  136. ------------------------------------------------------------------------------
  137. Option     Function                     Control Optons available.
  138. ------------------------------------------------------------------------------
  139. Nothing    Compression                  -X,-XC,-G,-D,-B,-K,-I,-A
  140.                                         -Oxxxxx.
  141. ------------------------------------------------------------------------------
  142. -R,-RA     Restore                      -Oxxxxx.
  143. ------------------------------------------------------------------------------
  144. -Cxxxxx    Copy with                    -R,-RA,-A 
  145.            compress/decompress
  146. ------------------------------------------------------------------------------
  147. -L         display compressed file.
  148. -H         CRC check of compressed file.
  149. ------------------------------------------------------------------------------
  150. -!         Validation Check of DIET.
  151. -?         Display Help Screen. 
  152. ------------------------------------------------------------------------------
  153. -Z[n]      DIET stay on memory          -P,-W,-N,-M
  154.            state of on memory DIET      -S,-Txxxxxx
  155. ------------------------------------------------------------------------------
  156. -ZD        disable TSR DIET
  157. -ZA        activate TSR DIET
  158. -ZR        remove TSR DIET from memory.
  159. ------------------------------------------------------------------------------
  160. -$         manually compress in 
  161.            automatic mode
  162. ------------------------------------------------------------------------------
  163.  
  164. 3.2.  File Compression/Decompression
  165.  
  166. When Diet is executed without a basic option but with a filename, the
  167. named file will be compressed.
  168.  
  169.       DIET [auxiliary option] filename [filename(s)].
  170.  
  171. You can name options:
  172.    -X     Compress as SFX type.
  173.   -XC     Compress a .COM file as SFX .COM file. If you don't specify
  174.           -XC, you will get an .EXE file out of COM file.
  175.    -G     A large SFX header is created on the top so that you may get
  176.           a Greater speed of decompression
  177.    -D     Compress into Data type.
  178.    -B     DIET compares size in Byte count.
  179.    -K     DIET compresses files upon termination, not while in execution.
  180.    -I     Ignore warning "may be overlay files!"
  181.    -Oxxxx Specify file name or path name of Output.
  182.    -A     Attribute  is readonly.
  183.  No Option  .EXE files and .COM files into SFX type. 
  184.             .SYS files are not compressed.
  185.             Other extensions are compressed as DATA type.
  186.  
  187.     You may specify Data types with Options -D and -X,see below.
  188.  
  189.    -X  As a default, DIET recognizes as device drivers all files
  190.        with the extensions "SYS" or "DRV" and does NOT compress
  191.        them.
  192.        If you want to DIET a Device Driver, you must make it
  193.        self-extracting (because you won't have DIET in memory as
  194.        a TSR until you load it as a TSR in your AUTOEXEC.BAT
  195.        file). You can force DIET to add a self-extracting header
  196.        to any file by using the -T option.  But see also option
  197.        -I, above.
  198.        -X tells DIET to add a self-extracting header regardless
  199.        of filetype extension.  Primary use is to compress Device
  200.        Drivers (e.g., ????.SYS or ????.DRV) so that their DIETed
  201.        versions can be included in the CONFIG.SYS files.
  202.        In the CONFIG.SYS file, you must o
  203.  
  204.    -D  DIET compress every file as a data type, .COM and .EXE
  205.        files, too. If you have DIET on TSR mode, DIET will
  206.        extract original files and will run them. What's the benefit
  207.        you can get?
  208.        First you can compress a file to be loaded high in memory.
  209.        e.g., ADDDRV.exe, which flags for -I options usually, and
  210.        which you can't run even if you succeed with -I option.
  211.  
  212.        There are files with many overlays which normally require
  213.        extra memories to load. You can normally load such files
  214.        by compressing overlays as data files.
  215.  
  216.        This is a minor point, but you may save a little header space
  217.        by compressing as data files.
  218.  
  219.    -G  DIET adds a faster SFX header, some 100 bytes extra, to
  220.        DIETed files. You can get faster decompression by this
  221.        option. If 100 extra bytes would not change the DIETed
  222.        file size, you had better compress with this option.
  223.  
  224.    -XC DIET compresses a xxxx.COM file into xxxx.EXE file.
  225.        This is to make executables to have more robust structure,
  226.        since SFX header is attached to the top of the file.
  227.        However, if you insist on the same name for unDIETed
  228.        and DIETed, you may specify this switch to get .COM file
  229.        out of .COM file.
  230.  
  231.        The size of DIETed .COM file is smaller than .EXE file,
  232.        hence there is certin merit like being loadable into UMB.
  233.        Do not put too much trust on this switch, because the
  234.        behavior of such a .COM file may be unpredictable.
  235.  
  236.    -B  MS-DOS manages files with cluster as a unit. For a High-
  237.        Density 5.25" disk, 1 cluster consists of 1,024 bytes.
  238.        Hence a file with size 10,300bytes and another with
  239.        11,000bytes occupy 11 clusters on a disk space. If DIET
  240.        tried to compress the later and get the former, DIET aborts
  241.        compression since the number of clusters are the same for
  242.        compressed and uncompressed files.
  243.  
  244.        However, there are cases where you archive these files into
  245.        a file with say TAR.exe or LHA.exe with no compress option.
  246.        Then you have chances to get one or more clusters in size of
  247.        the archive.
  248.       
  249.        DIET aborts compression when it meets a file of size less
  250.        than a cluster. Specify -B option to let DIET compares the
  251.        compressed size in Byte size.
  252.           
  253.    -K  Kill temporary Files Only on Quitting Program. DIET's TSR
  254.        opens a temporary file whenever it lets a program like an
  255.        editor open a compressed file.  That temporary file is
  256.        erased when the program closes the file. Some programs
  257.        open, close, and reopen files frequently, e.g. a Help
  258.        Message file.  That can be very time consuming.  To avoid
  259.        that, use the -K option -- then the temporary files will
  260.        be erased ONLY when you quit the main program from which
  261.        the DIETed files were expanded. You may watch -K option
  262.        in action with editors calling child processes or with some
  263.        communication software with overlay protocol files.
  264.  
  265.        An adversary effect of this option is that you have many
  266.        temporary files on your temporary directory. Refer -N, and
  267.        -$ options in autocompression mode.
  268.  
  269.    -I  Ignore warnings.  DIET ordinarily refuses to compress
  270.        files with overlays when the size of the file in EXEHDR
  271.        information is not the same as its actual size, or when
  272.        the file is to be loaded in high memory like ADDDRV.exe.
  273.        And DIET reports 'may be overlay file', or "to be loaded
  274.        high". Since DIET can use compressed overlay files if 
  275.        operated in the TSR mode, the -I option tells DIET to 
  276.        ignore such warnings.  
  277.  
  278.        Do NOT use the -I option if you use DIET in nonresident mode.
  279.     
  280.        Executable file with overlays as MS-WORKS will not behave
  281.        properly if DIET is not active as TSR. I would recommend
  282.        to use -D with -K option, for such files. 
  283.        However, you might be able to run DIETed file with -I option, 
  284.        since DIET suggests 'may be overlays'at the compression.
  285.        You may try this option first if you prefer to use DIET
  286.        non-TSR.
  287.  
  288.        Files to be loaded high as device drivers, flag for -I 
  289.        option. You may DIET them with -I option, but you may often
  290.        lose their proper working area on High Memory Blocks.
  291.        Again you had better use DIET as TSR and DIET them with
  292.        -D option.
  293.  
  294.    -Oxxxx  By default, DIET overwrites the files it compresses 
  295.        (or uncompresses).  If you want to save the uncompressed
  296.        (or compressed) file, use the -O option to put the changed
  297.        file into another directory.  To illustrate:
  298.  
  299.        Example 1. You are NOT logged into DRIVE A:.  You want a
  300.        compressed version of A:ALPHA.DAT in your default
  301.        directory:
  302.                           DIET -O A:alpha.dat.
  303.  
  304.        Example 2. You want to compress ALPHA.DAT in your default
  305.        directory and store the compressed file in directory
  306.        C:\TMP
  307.                         DIET -OC:\tmp\ alpha.dat
  308.                  (note the positions of the spaces and back slashes!!)
  309.  
  310.  
  311.    -A  Set Read-Only Attribute.  This is a safety measure for
  312.        users who do not always keep DIET in memory as a TSR.  If
  313.        you were to call a DIETed file into your editor without
  314.        DIET in memory, it is possible that your editor could lock
  315.        up.  To restart you'd have to reboot, and you could lose
  316.        your DIETed data file. By using the -A option, you make
  317.        any DIETed file Read-Only.  Few users will need to use the
  318.        -A option, but it's there for those who want to be extra
  319.        safe.
  320.  
  321. File Restoration or uncompression.
  322.  General format is:
  323.    DIET -[ R | RA ] [ Option ] Filename [Filename(s)]
  324.  
  325.     -R  decompresses all named files that were compressed as DATA
  326.         files (normally, all files that do NOT have EXE or COM
  327.         extensions).
  328.  
  329.    -RA  restores ALL named files, including files that when
  330.         compressed received a self-extracting header (normally,
  331.         the *.EXE & &.COM files).
  332.  
  333.  By the nature of Data types, you may have to compress/decompress
  334. frequently, while executables and device drivers are seldom needed
  335. to recompression. Especially when DIET is non-resident you have to
  336. restore many files using wild cards. Design of -R and -RA option
  337. is done to decrease the number of manual operations in non-TSR mode.
  338.  
  339.  
  340. 3.2   USING DIET FOR COPYING FILES COMPRESSED/DECOMPRESSED
  341.  To copy files as Compressed, or be compressed, General format is:
  342.  
  343.     DIET -Cxxxx [option] filename [filename(s)]
  344.  
  345.  Available options are the same as with the case of compression.
  346.  
  347.  This function is similar to -Oxxxx, but difference lies in the
  348.  fact that uncompressed files are compressed, already compressed
  349.  files are copied as they are, and files DIET failed to compress
  350.  are copied as they are.
  351.  
  352.  When DIET finds a file with the same name, DIET compares the
  353.  Time Stamp and overwrite existing file if it older and abort 
  354.  if it is newer than the specified file.
  355.  
  356.  Recommended use of this function is to expand an application
  357.  package on High Speed Device from your floppy disks, and  to
  358.  restore the package to the original storage with some of the
  359.  files transacted.
  360.  
  361.  To copy files with decompression, the general format is:
  362.  
  363.       DIET -R -Cxxxx  filename [ filename(s)]
  364.       DIET -RA -Cxxxx filename [ filename(s)].
  365.  
  366.  Specified files are expanded in the specified directory xxxx
  367.  with unDIETed. You may copy and expand files in a low speed
  368.  device like a floppy disk, to a highspeed device, as a ramdisk
  369.  with this command.
  370.  
  371.    -C  Copying DIETed files with DIET's TSR in memory takes extra
  372.        time because DIETed files are automatically decompressed
  373.        before copying and recompressed after copying.  You can
  374.        suppress that by using DIET with the -C option to copy
  375.        files. The syntax is:
  376.                     DIET -C<destination> <FILENAMEs>
  377.  
  378.        Example 1.  To copy all files (including compressed files)
  379.        in the current directory of C:\ to Drive A:
  380.                            DIET -CA:\ C:\*.*
  381.  
  382.        Example 2.  To copy compressed files in drive A: to Drive
  383.        C:\ and simultaneously decompress them:
  384.                          DIET -RA -CC:\ A:\*.*
  385.        (But see also DIETOFF Environment Variable, below)
  386.  
  387.  
  388. 3.3   USING DIET TO VIEW DIETED AND UNDIETED FILES.
  389.  
  390.    -L  presents a directory listing for the default disk, with
  391.        the DIETed files in reverse color.  An "*" means the file
  392.        has a self-extracting header, and a "#" means it is a
  393.        compressed DATA files.  Wildcard filenames are OK, e.g.,
  394.  
  395.              DIET -L *.dat *.txt
  396.  
  397.        When you want to specify a directory, put an extra '\' at
  398.        the end of the path name like:
  399.  
  400.              DIET -L c:\dos\
  401.  
  402.        which is the same with
  403.  
  404.              DIET -L c:\dos\*.*
  405.  
  406.        with -L option.
  407.  
  408.    -!  makes a self-check of DIET.EXE's internal integrity.
  409.  
  410.    -H  checks the CRC for file integrity, and presents data about
  411.        DIETed files, i.e., Original File Size and Type, & reports
  412.        if the -K option was used.
  413.  
  414.    -J  If you have DOS/V 5.0 from IBM Japan and can read Japanese,
  415.        this options gives you data your disk's health status.  If
  416.        not, ignore this option.
  417.  
  418.    -?  Display the list of options.
  419.  
  420.  
  421.  
  422. 3.4.  USING DIET AS A TSR FOR AUTOMATIC DECOMPRESSION.
  423.  
  424.  General syntax for making DIET Terminate and Stay Resident is:
  425.  
  426.    DIET -Z   [options]
  427.    DIET -Z0  [options]
  428.    DIET -Z1  [options]
  429.    DIET -Z2  [options].
  430.  
  431.  Available options are:
  432.        -P     automatated recompression of DIETed file.
  433.        -W     automated compression of newly created file.
  434.        -N     disable automated [re]compressions.
  435.        -M     suppress messages in automated compression.
  436.        -S     display decompressed file size.
  437.        -Txxxx specify temporary file directory.
  438.        
  439.      DIET -Z loads DIET into memory as a TSR. When there is a space
  440.              in UMB, DIET first tries to stay there. Whenever XMS
  441.              memory is availabel, DIET will load itself in extended
  442.              memory with DOS 5.00. 'DIET -Z' is the same with 'DIET -Z1'
  443.  
  444.      DIET -Z[n] tells DIET how to use Expanded Memory, if present. 
  445.           -Z0 do not use Expanded Memory (same as -Z alone)
  446.           -Z1 use Expanded Memory for DIET's temporary files.
  447.           -Z2 use Expanded Memory for both DIET's temporary files
  448.               and for most of DIET's resident code, too.  If you
  449.               have enough Expanded Memory, -Z2 uses only about 1.6k
  450.               bytes of conventional memory.
  451.              
  452.               When DIET has already been resident, only the auxiliarly
  453.               options have meaning. Z[n] does nothing to TSR DIET.
  454.  
  455.                  Notes:  If you compress COMMAND.COM or some overlay
  456.                  files, you must make DIET resident in memory.
  457.                          Regular users of DIET should include DIET -Z
  458.                  in their AUTOEXEC.BAT file.
  459.                          You can also load DIET as a Device Driver, e.g.,
  460.                                   DEVICE=DIET.EXE -Z2 -P -K
  461.                  That uses a few additional bytes of memory, but allows
  462.                  you to DIET Device Drivers (to save disk space).  If you
  463.                  have large or many Device Drivers, that may be useful.
  464.  
  465.         -ZD   disables DIET in memory, but leaves it loaded.
  466.         -ZA   restores DIET after -ZD has been used.
  467.         -ZR   removes DIET from memory.  But don't do that if you loaded
  468.               other TSR's after DIET.
  469.  
  470.               Note:  DIET's TSR function may be disabled if you use
  471.               ^C or ^Break while DIET is executing, or by certain
  472.               interrupts.  If DIET's TSR function disappears for an
  473.               unknown cause, try  DIET -ZA to restore it.
  474.  
  475.  
  476.    -P   DIET's default mode does not re-compress data files that
  477.        are changed after being into loaded and manipulated by a
  478.        program such as an Editor or a Spreadsheet.  DIET\ \%-P
  479.        enables automatic recompression.
  480.        But whether or not DIET can automatically recompress such
  481.        data file files depends on the internal workings of your
  482.        Editor or other program. It does work with ???.WQ1 files
  483.        in QUATTRO.  It does not work for ???.DBF files in dBASE
  484.        (in fact, dBASE 
  485.       
  486.    -W  will automatically DIET all newly-created files, including
  487.        any temporary files that your programs may create.  That
  488.        can be useful but can also waste a lot of time.  To assure
  489.        this option does not become a nuisance, use the NODIET
  490.        Environmental Variable to suppress DIETing of files like
  491.        *.OBJ, *.LZH, etc. Or use -N otpion together, and later
  492.        issue the command
  493.  
  494.           DIET -$
  495.        
  496.        See the option -$.
  497.        In the CONFIG.SYS file, you must of course give the
  498.        driver's full name, e.g.,
  499.           DEVICE=?????.SYS).
  500.  
  501.    -M  If you don't want DIET to give you a message about what it
  502.        is doing to your file, suppress the message with -M
  503.    
  504.    -N  With -P or -W options specified, DIET automatically
  505.        compress newly created files and decompressed files
  506.        opened with READ and Write mode. You are not aware of
  507.        the time and types of these compressed files. By specying
  508.        this option, you may restrain DIET from auto-compression
  509.        and with -$ option, compress them later with the same time
  510.        stamp as TSR DIET tried to compress them.
  511.        
  512.        With -P option SFX or Data type inherit those of the originals
  513.        and with -W option, you may specify types by switches.
  514.    
  515.  
  516.    -S  Some application programs read in a specified amount of
  517.        data from overlay files, and get confused if those
  518.        overlays have been DIETed.  By specifying the -S option
  519.        when dieting such overlays, that confusion is avoided.
  520.  
  521.    -T  In its default mode, DIET stores in the default directory
  522.        certain temporary files that it creates and needs . If you
  523.        use the Environment Variable  TMP=???, DIET will attempt
  524.        to store its temporary files in the directory that you've
  525.        defined as ???. -T option overrides the TMP environmental
  526.        variable. You may define the directory in AUTOEXEC.BAT by:
  527.            DIET -Z2 -P -K -TD:\tmp1\
  528.        DO NOT FORGET THE LAST "\" IN THIS OPTION.
  529.        
  530.        I strongly recommend you to define temporary directory
  531.        especially when you have a high speed device like a
  532.        Ramdisk.
  533.  
  534. USING DIET as a DEVICE DEIVER.
  535.  DIET.exe is an executable program and is a device driver at
  536.  the same time. You may load DIET as a DEVICE DRIVER in your
  537.  config.sys as:
  538.  
  539.    DEVICE = DIET.EXE  -Z   [ options ]
  540.    DEVICE = DIET.EXE  -Z0  [ options ]
  541.    DEVICE = DIET.EXE  -Z1  [ options ]
  542.    DEVICE = DIET.EXE  -Z2  [ options ]
  543.  
  544. or in your AUTOEXEC.BAT as:
  545.  
  546.    DIET.EXE  -Z   [ options ]
  547.    DIET.EXE  -Z0  [ options ]
  548.    DIET.EXE  -Z1  [ options ]
  549.    DIET.EXE  -Z2  [ options ]
  550.  
  551.  
  552.  
  553. 3.5.  Environment Variables.
  554.  In DOS versions 3.xx or above, DIET uses the following
  555.  environment variable strings, if they are present.  You create
  556.  them (usually from your AUTOEXEC.BAT file) as follows:
  557.                      SET NameOfEnvVar = data
  558.  
  559.  
  560.  
  561. DIETOPT  allows you to define the options you want to use as a
  562.        default, e.g.,
  563.                            SET DIETOPT=-D -K
  564.        will use option -D and -K whenever a file is DIETed.
  565.        
  566.        Options you can set are: -J,-I,-D,-G,-K,-P,-W,-N,and -S.
  567.  
  568. DIETOFF This is the unique variable TSR DIET refers.
  569.        TSR DIET has versatile abilities which consequently has
  570.        some adversary effect in use. Take copy command e.g.,
  571.        the command line entry  'copy file1 file2'
  572.        first decompresses file1 to file2.tmp and then compresses
  573.        it to file2. You may type 'DIET OFF' to disable DIET
  574.        temporarily, which is time consuming. If you register
  575.        COMMAND.COM among DIETOFF string, you can avoid this manual
  576.        typing.
  577.  
  578.        For some programs you may prefer to disable DIET, e.g.,
  579.        to speed up file copying without having to use Option -C
  580.        (see above).  By including an environment string as below,
  581.        you tell DIET's TSR not to do what it usually would do
  582.        with DIETed files:
  583.            SET DIETOFF=COMMAND.COM;FC.COM;DUMP.EXE;XCOPY.EXE;LHA.EXE
  584.        You don't need to specify a Path for the files -- DIET is
  585.        concerned only with the programs' names.
  586.  
  587. NODIET  You should suppress DIETing of some files, e.g., archives
  588.        like *.LZH and *.ZIP, and temporary intermediate files
  589.        created by some application programs.  You can also tell
  590.        DIET to ignore all files in specified directories -- if
  591.        your NODIET string ends with a Directory name, be sure to
  592.        append a "\".  There is a limit of 10 NODIET entries.
  593.        Example:
  594.             SET NODIET=*.LZH;*.ZIP;*.OBJ;C:\TMP\;c:\c600\
  595.        will suppress DIETing of all *.LZH, *.ZIP, *.OBJ files,
  596.        and of all files in director C:\TMP and C:\C600.
  597.  
  598.   TMP  Define storage area for DIET's Temporary Files by putting
  599.        into your AUTOEXEC.BAT a line like:
  600.                           SET TMP=E:y\DirName
  601.        See also Option -T.
  602.  
  603.        NOTE: When you use DIET in resident mode, it creates and
  604.        use  TMP  Define storage area for DIET
  605.        uses temporary files with names such as __DIET__.??? Such
  606.        files are automatically erased when DIET finishes its
  607.        tasks, but if you boot your system or stop DIET's
  608.        execution by Ctrl-Break, those files may remain on your
  609.        disk.  You may erase any such files.
  610.  
  611.  
  612.  
  613. 4.0. Hints for Effective Use of DIET.
  614.   Don't allow DIET to be memory-resident when using programs
  615. like SPEEDDSK, OPTIMIZE, DOG, or other HardDisk managers.
  616. Disable DIET by executing DIET -ZD when you use such programs!!
  617. In fact, you're always best off by clearing ALL TSRs before using
  618. such programs.
  619.  
  620.  
  621. 4.1. DIET in non-Resident Mode.
  622.  There are no special things you have to remember when you use DIET.
  623.  Register filenames you don't want to compress in NODIET variable to
  624.  gain speed, *.LZH and *.ZIP must be in your list. Do not try to
  625.  compress file with -I otption if DIET flag for overlays. You had
  626.  better have a batch file such as APP.bat when APP.exe and APP.HLP
  627.  are DIETED in you storage:
  628.   "
  629.    rem Auto-decompression and execution of APP.exe
  630.    echo DO not forget to recompress APP.HLP 
  631.    diet -r APP.HLP
  632.    APP
  633.   ."
  634.  
  635.  When you have a high-speed device such as a RAMDISK, you had better
  636.  copy your applications decompressing and run your program on RAMDISK.
  637.  Suppose you have an application package in a Floppy Disk A:, and
  638.  You have a sufficient space in your RAMDISK D:.
  639.      DIET -R -CD: A:*.*
  640.  Then after you quit running, you type:
  641.      DIET -CA: D:*.*
  642.  to copy all of your aplication program while compressing to A:
  643.  as DIETing is carried on. New Data files and revised files will
  644.  be stored on the diskette in the disk drive A:.
  645.  
  646.  Laptop Users, you are the target of this software. The file overwriting
  647.  mode of DIET is designed for you to make most of your limited storage
  648.  space. Try to leave a room for decompressed files, and design your own
  649.  batch file to use the minimum amount of your files decompressed.
  650.  
  651.     
  652. 4.2. DIET in Resident Mode.
  653.  
  654.  Specify TMP environmental string always if you have a high-speed
  655.  RAMDISK to decrease the number of disk accesses if available. You
  656.  must, also, know that you have a sufficient space for the temporary
  657.  files to be made by DIET.
  658.  
  659.  When you see a message like: "Can't find abc.exe" even though the 
  660.  file exists.  This is usually the result of DIET being unable to find 
  661.  enough space in your temporary directory for its temporary files. 
  662.  Check your space if you see this message.
  663.  
  664.  DIETOPT variables will refrain DIET to make some adverary effects
  665.  like copying after decompression and compressing after copying.
  666.  Well, if you set DIETOPT=COMMAND.COM, they you can't type a
  667.  DIETED file unless you put and SFX header to the date file.
  668.  You must take a balance for yourself. Please make experiments
  669.  on -P, -W and -K options, and choose the combination fit you best.
  670.  
  671.  A word processor ordinarily takes the raw file formatted into
  672.  a form you like. And it makes auxiliary files for formatting or
  673.  for controling your printer. Everytime you change a line or two
  674.  wordprocessor must compress and decompress these files if you
  675.  don't specify -K option. With this option set, these temporary
  676.  formatting files are DIETed once for all.
  677.  
  678.  If you have a sufficient room for the temporary directory, you
  679.  have to set -K all the time. If you don't have enough room,
  680.  you have to choose carefully the filenames for which K option
  681.  works.
  682.  
  683.  -P option is a must if you have DIET as TSR. With a suitable
  684.  combination with -K option, you can always have compressed file
  685.  automatically re-compressed. You will see there DIET on action.
  686.  You will love to see it or you may suppress DIET messages with -M.
  687.  Sometimes DIET start working when you call the program again,
  688.  but this is not a BUG.
  689.  
  690.  Executable file in Overlay mode can be run if DIET is in TSR active.
  691.  I would recommend -D option with -K, rather than -I.
  692.  
  693.  The state of DIET options can be seen by "DIET ON" command.
  694.  Or you may use DOS MEM.exe or PMAP.exe by Chris Dunford as follows:
  695.      PMAP /e
  696. ---------------
  697. pmap 2.03 Copyright (C) 1986-1990 by The Cove Software Group/C.J.Dunford
  698. Addr  Program   Parent    Parameters         Han Blks  Size   Vectors
  699. ----  -------  -------- ---------------      --- ---- ------- -------
  700. 1068  command  command  /e                     1    2    3888 22 23 24 2E FF
  701. 13CC  diet     n/a      diet a(p--n--)ver1.44  1    1    1744 21
  702.         active options insdie (......).
  703. ---------------------------------------------------------------
  704. When you have loaded DIET as a device driver, PMAP /v shows only the
  705. place and size.
  706.  
  707.  
  708.  
  709. 4.3. Things to Avoid in TSR mode.
  710.  
  711.  As is described before, some program returns a message like:
  712.  "Can't find abc.exe" even though the file exists.  This is usually 
  713.  the result of DIET being unable to find enough space in your 
  714.  temporary directory for its temporary files. 
  715.  
  716.  There are some files which is accessed not by its file-handle. DIET
  717.  has been revised several times to enhance tracing ability of filenames
  718.  in file open and close, however, in certain rare cases, DIET fails
  719.  to access exiting file.
  720.  
  721.  Do not try to run programs which rewrites FAT of Disk or DOS
  722.  buffers. The so-called HDD optimizing programas are of this type.
  723.  Please disable TSR DIET before the use of such programs.
  724.  
  725.  DIET tries to trace filenames even with task-swapping of DOS 5.00
  726.  or Windows in its enhnaced mode. However, among the many application
  727.  programs you might find some with which DIET fails to trace tasks
  728.  swapped. Please take due precautions with task swappings.
  729.  
  730.  
  731.  
  732. 5.0. DISTRIBUTION AND COPYRIGHTS
  733.  
  734. Our Distribution Policy.  The program together with the other
  735. packaged documents is copyrighted by Teddy Matsumoto. The package
  736. consists of DIET.EXE, DIET144.DOC, DIETTECH.DOC(not included in this
  737. package ask to distributor for English document), DIETAPI.DOC and
  738. HISTORY.DOC( sorry for Japanese version ).  However, he does not claim the 
  739. copyright of a program DIETED afterward. You may copy, distribute 
  740. and use this program free of charge, but:
  741.  
  742.           You must use DIET for personal purposes. Anyone who
  743.           wants to use the restricted storage space of ones
  744.           hardware may use this software free of charge. 
  745.           
  746.           You must not charge for copying or distributions, other
  747.           than a nominal charge for materials and postage.
  748.  
  749.           If you distribute DIET, you must distribute the entire
  750.           package without modification, and you should be
  751.           prepared to distribute up-dates and fixes as they are
  752.           released. This applies especially when you distribute
  753.           on large BBS or in a Diskette. The author would appreciate
  754.           the report of such distribution.
  755.  
  756.  
  757. CONTACTING THE AUTHOR.
  758. In Japan, Email to Teddy Matsumoto at GBG00230 on Nifty Serve.
  759. Overseas Users may contact K.Okubo at one of the following:
  760.                     74100.2565@compuserve.com
  761.                     GEnie:      K.Okubo
  762.                     INTERNET:   okubo@tansei.cc.u-tokyo.ac.jp
  763.                                       
  764.  
  765.           This English Version of DIET144.doc was prepared by
  766.           Eric O. Stork, STORK on GEnie, and K.Okubo.
  767.           Load UMB function is available only from ver.145.
  768.