home *** CD-ROM | disk | FTP | other *** search
/ Vectronix 2 / VECTRONIX2.iso / FILES_07 / SPEEDO_2.ZIP / STZIP.DOC < prev    next >
Text File  |  1994-04-27  |  28KB  |  662 lines

  1.  
  2.  
  3.  
  4.   ____________________________
  5.                            _________  ***** ******    ******  *  *****
  6. __________________________           *        *         **   *  *    *
  7.                     _________________ **     *       ***    *  ******
  8.   ________________                     *   *      **      *  *
  9.                     _____________ *****   *      ******  *  *
  10.      ______________________
  11.  
  12.  
  13.  
  14.  
  15.                             STZip version 2.6
  16.                        (c) Vincent Pomey 1990-1994
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.         **************
  25.         * 0 - Prolog *
  26.         **************
  27.  
  28.     STZip is a program that allows you to compress and decompress
  29. files, i.e.  to reduce their lengths. You saves space on your disks and
  30. reduce the transmission time if you send the files by modem. It also
  31. allows you to group several files in one single file, whose extension
  32. in general is ZIP.
  33.  
  34.     STZip uses files that are compatible with PKZip 2.04 on the IBM PC,
  35. and the Unix Info-Zip programs Zip 1.9/Unzip 5.0.
  36.  
  37.     You may copy this program and put it for download on bulletin
  38. boards. Commercial use and distribution (that includes putting STZip or
  39. self extracting files made by STZip on anything that is sold for more
  40. than the cost of the disk and handling charges) is not authorized without
  41. agreement of the author. You use this program at your own risk, there
  42. is no warranty.
  43.     Please avoid to "repackage" STZip, I prefer than the users gets all
  44. the files originally in the distribution.
  45.  
  46.     This is postcardware : if you use it, please register by sending a
  47. postcard to
  48.  
  49. Vincent Pomey
  50. 2 allée Valéry Larbaud
  51. 92260 Fontenay aux roses - France
  52.  
  53.     I inform registered users of new versions if they supply an E-mail
  54. address. Thanks to all users who were kind enough to register !
  55.  
  56.     The program is written in Modula-2 and assembler. For information
  57. on the file format, see the APPNOTE.TXT file distributed with PKZip from
  58. PKWARE. It explains the directory structure of a ZIP file, and the
  59. decompression algorithm.
  60.  
  61.     I can be reached via electronic mail :
  62. Fido  : Vincent Pomey (2:324/101.10)
  63. Email : vincent@stell.frmug.fr.net    (please do not send large mails)
  64.  
  65.     As you will probably see if you read this doc, I'm not a good
  66. technical writer... Sorry for that !
  67.  
  68.  
  69.                               ----oooOooo---
  70.  
  71.  
  72. There are several ways to use STZip:
  73.  
  74.         - double-clicking STZIP.PRG, using the GEM-interface
  75.  
  76.         - installing it as an application in the desktop: click once on
  77. STZIP.PRG, choose from the Desktop's menus the entry "Install 
  78. Application," type ZIP and confirm. After this, you may save the
  79. desktop.  Now, to use ZIP you only have to double-click a file with the
  80. extension  .ZIP and you will find yourself in STZip, with GEM interface
  81. for using that file.
  82.  
  83.         - renaming STZIP.PRG to STZIP.TTP and using it (or ZIPJR.TTP)
  84. with a command  line.
  85.  
  86.         - from a command line interpreter or external program, also using 
  87. a command line.
  88.  
  89.         - with some desktops, it is possible to drag and drop a file to
  90. the STZip icon. If this is a zipfile, it will be opened. If not, a
  91. zipfile with a similar name (e.g. FLAP.ZIP if you dropped FLAP.PRG)
  92. will be opened.
  93.  
  94. The usage with the GEM interface is the easiest. Certain options are 
  95. available only in GEM (the comments for example), while others are only 
  96. present with command-line usage (e.g. excluding files from compression).
  97.  
  98. ZIPJR.TTP is a stripped down version of STZIP : it does not have code
  99. for the GEM interface, but features are exactly the same if you're
  100. using the command line interface. The only advantage is that it is
  101. smaller.
  102.  
  103.  
  104.  
  105.         *********************************
  106.         * I - Usage with a command line *
  107.         *********************************
  108.  
  109. The usage of STZip with a command line is similar to that of ARC or LHArc 
  110. on the Atari, or PKZip on the PC.
  111.  
  112.  
  113.    1 -  A Table
  114.    ------------
  115.  
  116.  
  117.    +--------------------------------------------------------------------+
  118.    |       The syntax is of the form:                                   |
  119.    |                                                                    |
  120.    |    STZip command {options} [path] zipfile {file}                   |
  121.    |                                                                    |
  122.    |                                                                    |
  123.    |  There has to be one single command:                               |
  124.    |                                                                    |
  125.    |    -a      add files                                               |
  126.    |    -d      delete files                                            |
  127.    |    -f      freshen: update files in the zip-file                   |
  128.    |    -u      update: add new files and freshen the ones already      |
  129.    |            present in the zip-file                                 |
  130.    |    -x      extract files                                           |
  131.    |    -s      extract compressed files on the screen                  |
  132.    |    -c      check the zipfile                                       |
  133.    |    -v      list of the files with info                             |
  134.    |    -l      list of the files, just with their names                |
  135.    |    -?      a bit of help                                           |
  136.    |                                                                    |
  137.    |                                                                    |
  138.    |   You can also add a few options:                                  |
  139.    |                                                                    |
  140.    |    -o      overwrite a file without asking for confirmation        |
  141.    |            if the file already exists                              |
  142.    |    -r     `recursive compression: all the files in the             |
  143.    |            sub-directories you selected will also be compressed.   |
  144.    |           `recursive decompression: files compressed from sub-     |
  145.    |            directories will be decompressed in the corresponding   |
  146.    |            folders, which will be created if they don't exist.     |
  147.    |    -p      store pathname: the pathname of the file you have       |
  148.    |            specified in the command line is stored in the zip;     |
  149.    |            automatic with recursive compression                    |
  150.    |    -m      move file: files are deleted after compression          |
  151.    |    -t      the date of the .zip file will be that of the file      |
  152.    |            compressed with the most recent date.                   |
  153.    |    -z      modify the general comment for the zip file             |
  154.    |    -i dir  put the files to be compressed in the subdirectory      |
  155.    |            DIR in the zipfile                                      |
  156.    |    -b dir  use dir when writing tempo files                        |
  157.    |    -g      extract the file FFF.ZIP in the directory FFF           |
  158.    |    -w pw   encrypt the files to be added using pw as password      |
  159.    |            or use pw to decrypt the files to be extracted          |
  160.    |    -nmmddyy add only the files newer than mm/dd/yy (US date format)|
  161.    |    -h      wait for keypress before terminating the program        |
  162.    |    -k      filenames are case insensitive when using MiNT          |
  163.    |    -q      quiet - suppress all output                             |
  164.    |    -e      specifies the compression method:                       |
  165.    |             -es    store, no compression                           |
  166.    |             -eh    shrink, quick compression                       |
  167.    |             -ei    implode, default                                |
  168.    |             -ed    deflate, better compression                     |
  169.    |                                                                    |
  170.    +--------------------------------------------------------------------+
  171.  
  172. Note that you can use the -z option alone, without any command. STZip
  173. will only ask you for the new comment of the file.
  174.  
  175. The -k option is only useful if you use MiNT. Filenames are
  176. case-insensitive if you don't use MiNT.
  177.  
  178.  
  179.    2 - The command line
  180.    --------------------
  181.  
  182.    You can specify the folder that is to be used as a default for all 
  183. operations after the commands and the options: for example d:\texts\.
  184. Note the \ at the end.
  185.  
  186.    Following that, the name of the zipfile, that will contain (or already 
  187. contains) compressed files, must be specified. The extension .ZIP is the
  188. default. You may use wildcards for the zipfile (but be sure that your
  189. shell doesn't expand them because it won't work) : all the matching
  190. zipfiles will be processed .
  191. e.g.  stzip -xg *.zip    this will extract all the zip files in their directory
  192.    or stzip -z *.zip <comment.txt  this will change the zip comments for all
  193.   the zipfiles. (note that -z may now be used alone, without any action
  194.   switch).
  195.  
  196.    After all this, you put the list of files to be processed (i.e.: to be
  197. deleted, compressed or decompressed). It may be a directory name (without
  198. trailing \), all files inside that directory will be processed.
  199.  
  200.  
  201.    You may use the wildcards ? and * in the names of files:
  202.                 ? represents any single character
  203.                 * represents a string of characters
  204.  
  205.    Not specifying any file names is the same as *.* (all files).
  206.  
  207.  
  208.    3 - External list
  209.    -----------------
  210.  
  211.    If a name begins with a @, it means that that file contains a list
  212. of files to be treated. If you have a file list.txt containing for
  213. example:
  214.  
  215.         *.mod
  216.         zip*.txt
  217.         file1.vdt
  218.  
  219.    then stzip -a burp @list.txt         is equivalent to
  220.         stzip -a burp *.mod zip*.txt file1.vdt
  221.  
  222.    stzip -a burp @   will read the names of the file from stdin
  223. (generally keyboard).
  224.  
  225.  
  226.    4 -  Excluding files
  227.    --------------------
  228.  
  229.    If a name begins with a ~, it means that it is NOT to be added. It is 
  230. solely of interest when one uses wildcards; for example, to compress 
  231. all files except .BAK, you have to use something like this: stzip -a burp 
  232. *.* ~*.bak
  233.  
  234.  
  235.    5 - Odds & Ends
  236.    ---------------
  237.  
  238.       An external list may contains another external list, but not ~
  239. file names. The ~ file names of the command line are valid for all
  240. files, including the ones read from external lists.
  241.  
  242.       Matching wildcards goes MS-DOS style, not the Unix way: *.* matches 
  243. all files, and not only those that have a . in their name. Paths using '..' 
  244. are not supported.
  245.  
  246.       The -p switch:
  247. If you run stzip -ap burp folder\alt.txt, the name of the file in the zip 
  248. will be folder\alt.txt, while without the -p switch, it would have been 
  249. alt.txt. The -p switch is automatically invoked during recursive 
  250. compression.
  251.  
  252.       The -b switch:
  253. When updating a zipfile, STZip writes a temporary copy of that zipfile
  254. named __TMP__.ZIP, works on it and then renames it to the original
  255. zipfile. This tempo file is located on the same directory than the
  256. original zip. However, you may want to change that if you're working
  257. on a nearly full partition or on a floppy. Use the -b switch to
  258. change the directory for tempo files.
  259. Note however that seting tempo files to a partition different of the
  260. one of the zipfile introduce delay (file copy is slower than renaming).
  261. This is why environment variables likes TMP or TMPDIR are ignored.
  262.  
  263.     You can set frequently used options in command lines in an
  264. environnement variable named STZIP_OPT. STZip will simply add that
  265. variable at the beginning of the command line.
  266.  e.g.    setenv STZIP_OPT -k
  267.  so that STZip will always be in case insensitive mode.
  268.  
  269.     Using STZip with the command line interface, long filenames
  270. available with alternate filesystems (MiNT feature) are supported, as
  271. well as case sensitive names.
  272.  
  273.     A little trick : suppose you're in directory C:\, want to
  274. create a zipfile C:\BURP.ZIP contained C:\FILES\DEMO\*.TXT, but stored
  275. as DEMO\*.TXT in the zipfile. Use the path feature : 
  276.     stzip -a burp.zip c:\files\ demo\*.txt
  277.  
  278.  
  279.  
  280.     6 - Recursive compression
  281.     -------------------------
  282.  
  283.         If you have entered the -r option for compression, an important 
  284. thing will happen: the files you specify will also be searched for in all 
  285. sub-directories below you.
  286.  
  287.         The second attempt at explaining will be based on examples, the 
  288. first one being incomprehensible without several hours of meditation 
  289. topped off with a bunch of aspirins.
  290.  
  291.     An important thing to note is that if STZip doesn't do want
  292. you want, either compression or extraction, that's probably because
  293. you have forgotten to add the -r switch.
  294.  
  295. (In order to better understand the second attempt, remember that 
  296. folders do not actually exist within a zip-file. It's the path of the
  297. files (stored in the .zip) that contains the names of the folders)
  298.  
  299. fld is a folder.
  300. ...\ stands for any quantity of folders, or even none.
  301.  
  302. * stzip -ar burp
  303.         All the files in the current folder will be compressed, including 
  304. sub-directories.
  305.  
  306. * stzip -ar burp fld
  307.         The files fld\...\*.* will be compressed. The name fld\...\*.* is 
  308. stored in the zip file. To recap: all the files in fld are compressed, 
  309. including all the subdirectories found in fld.
  310.  
  311. * stzip -ar burp fld\*.txt
  312.         The files fld\...\*.txt will be compressed. The names 
  313. fld\...\*.txt are stored in the zip file. To recap: all the files with the 
  314. extension txt in fld are compressed, including all those found in the 
  315. subdirectories found in fld.
  316.  
  317. * stzip -ar burp fld\file.txt
  318.         The files fld\...\file.txt will be compressed. The names 
  319. fld\...\file.txt are stored in the zip file. To recap: all the files with 
  320. the name file.txt in fld are compressed, including all those found in the 
  321. subdirectories found in fld.
  322.  
  323. * stzip -ar burp c:\fld
  324.         The files c:\fld\...\*.* will be compressed. The names \...\*.* 
  325. are stored in the zip file. This means that c:\fld\ will NOT be stored as 
  326. part of the file names of the compressed files, because it is a COMPLETE 
  327. path, different from fld\.
  328.         Also, by using the changing of the working directory (of the kind 
  329. stzip -ar burp c:\fld1\ fld2\*.txt) it is possible to perform all sorts of 
  330. complex manipulations with the names of the files to be compressed. In the 
  331. above example, the files with the extension txt in c:\fld1\fld2 will be 
  332. compressed, but their names in the zip-file will be fld2\*.txt.
  333.  
  334.         No tests are performed EVER on the names of folders.
  335. stzip -ar burp *.txt will search in all directories, not only in those 
  336. with the extension txt!
  337.  
  338.         Some Unix-style shells perform themselves the substitutions of the 
  339. wildcards. STZip does not respond similarly to 
  340. 'stzip -ar burp fld\a.txt fld\b.txt' and
  341. 'stzip -ar burp fld\*.txt' even though for the shell this may be the same. 
  342. In this case, it is therefore necessary to add quotation marks to 
  343. fld\*.txt so that the shell will not substitute the wildcards. Likewise, 
  344. the ~ character may pose problems.
  345.  
  346.  
  347.    7 - Recursive decompression
  348.    ---------------------------
  349.  
  350.         If a zip file contains folders, there are two possibilities:
  351.  - ignore them and decompress to the current working directory (which is 
  352.    the default). This allows for the quick decompression of a specific 
  353.    file without creating lots of folders.
  354.  - or decompress the files to these folders and create the folders when 
  355.    necessary. For this, use option -r.
  356.  
  357. You can always add paths and use wildcards in the filenames. If you 
  358. specify in the parameters a name with a path, for example infra\*.msg, 
  359. then all *.msg files in infra AND in its subdirectories will be extracted.
  360.  
  361.  
  362.     8 - Comments
  363.     ------------
  364.  
  365.         The global comment for the entire zip file (changed with the -z 
  366. switch) is displayed every time the zipfile is accessed. In Gem, it is
  367. also possible to have a comment for each files in the zipfile, it is
  368. displayed when the file is extracted.
  369.  
  370.  
  371.  
  372.       ********************************
  373.       * II - Using the GEM interface *
  374.       ********************************
  375.  
  376.  
  377.    1 - General
  378.    -----------
  379.  
  380. If you started STZip normally from Gem (without parameters, droping or
  381. double-clicking on a zip file), STZip will show you a file selector,
  382. asking for a zipfile. You can select an existing one (for extraction or
  383. update) or a new one, STZip will create it. If you just type Return,
  384. STZip will open DEFAULT.ZIP (or create it if it doesn't exist).
  385.  
  386. The general algorithm is to select files on the disk selector and then
  387. click on the "Compress" button if you want to compress files, and select
  388. files on the zipfile selector and then click on the "Extract" button if
  389. you want to extract files.
  390. If you click on the "Compress" or "Extract" button without having
  391. selected any files, STZip will suggest you to process all the files.
  392.  
  393. You may unselect all the files by clicking on the "Select: 000" button (it
  394. shows the number of selected files).
  395.  
  396. Some text shows you at the botton of the window the size of all
  397. selected files in the zip or disk selector. You can swap from zip
  398. selected size to disk selected size by clicking on that text.
  399.  
  400. To change the zipfile, click on the close-box of the Zip file selector.
  401.  
  402. The "Recurse Subdirs" button:
  403.       during compression, if it is selected, then all subdirectories will 
  404. also be compressed.
  405.       during decompression, if it is selected, then all files will be 
  406. extracted to their original directory : DIR\FILE.TXT will be extracted
  407. in directory DIR (created if it doesn't exist). If not selected,
  408. DIR\FILE.TXT will be extracted as FILE.TXT, in the current directory.
  409.  
  410.  
  411.    2 - Informations/Comments
  412.    -------------------------
  413.  
  414. To get information about the entire zip file, you have to double-click
  415. on name of the zip file.
  416.  
  417. Similarly, you may get information about a specific file in the zip or
  418. on the disk by double-clicking on its name.
  419.  
  420. Information about the zipfile and the compression files contains some
  421. comments, and you may edit them. Zipfile comments are displayed
  422. whenever accessing the zipfile, while comments specific to a compressed
  423. file is displayed when extracting this file. The comments are saved on
  424. disk when you change the zipfile or when you quit STZip. This results in
  425. some disk access.
  426.  
  427. While looking the information of a disk file, you may rename it.
  428.  
  429. In the zipfile contents box, a point just before the file name means that
  430. there is a comment attached to that file.
  431.  
  432.  
  433.    3 - File display
  434.    ----------------
  435.  
  436. While looking the information of a file (compressed or on disk), you
  437. will be able to Display it (by clicking on the Trash button, uhh no,
  438. the Display button). A new window will appear. Then, a few keys are
  439. available :
  440.  
  441.     arrow keys :     Move the text
  442.     Clr-Home :     Goto beginning of the file
  443.     Shift-Clr-Home : Goto end of the file
  444.     Ctrl-V :     Copy the file to the clipboard
  445.     Ctrl-S :     Save the file (will ask for filename)
  446.     Ctrl-C :     Change the font or the font-size used
  447.     Ctrl-F :     Search a string
  448.     Ctrl-G :     Search same string
  449.     Ctrl-P :     Print file
  450.     Ctrl-R :     Print block
  451.     Ctrl-B :     Save block (will ask for filename)
  452.     Ctrl-W :     Copy the block to the clipboard
  453.     ESC :         Quit the display mode
  454.  
  455. It is also possible to get a menus with those options by pressing the
  456. HELP key or by double-clicking in the window.
  457.  
  458. The block is selected by using the mouse : clicking on the first button
  459. sets the beginning of the block, clicking on the second button sets the
  460. end of the block. The block is displayed in bold fonts.
  461.  
  462.  
  463. Picture Display :
  464. STZip will call a picture viewer that support the image format is
  465. one is found.
  466.  
  467.  
  468.    4 - Configuration
  469.    -----------------
  470.  
  471.     The Configuration dialog box lets you choose the compression
  472. method, the sort method for the Zip selector and the Disk selector,
  473.  
  474.     The configuration file STZIP.CFG contains all those choice,
  475. plus the current disk path and list field (the mask for the compressed
  476. files to be listed), as well as the Font ID, Font Size and Tab Size
  477. used while displaying files. It is saved in the home directory of
  478. STZip.
  479.  
  480.     On later call, STZip will go in the directory where you were
  481. when you saved the configuration. That way it will always start listing
  482. the files of the same directory. Since you may not like that, an option
  483. disable this and STZip stays in the current directory ("Go in current dir
  484. rather than saved dir").
  485.  
  486.     Note that the configuration file is used _only_ when using the
  487. GEM interface. It is not read when STZip is called with a command line.
  488.  
  489.     On TOS < 1.4, the configuration file will be loaded and saved
  490. in the current directory. This is not very clever but it is because the
  491. shel_find function doesn't work on old TOS.
  492.     On newer TOS, the configuration file -if it exists- will be
  493. loaded from the directory where STZIP.PRG is, and be written at the
  494. same place. But if there is no configuration file there when you start
  495. STZip, it will be saved in the current directory. That's why there is a
  496. dummy configuration file in the distribution archive : if you put it
  497. with STZIP.PRG, the configuration file will be always written in the
  498. directory where STZIP.PRG is.
  499.  
  500.     The tempo directory is where STZip writes the backup of the zipfile
  501. he is currently updating. If none specified, it is the directory where
  502. the zipfile is. See detailed explanations in section I-5 "-b switch".
  503.  
  504.  
  505.    5 - Odds & Ends
  506.    ---------------
  507.  
  508.     It is possible to create a subdir in the zipfile or on the disk.
  509. The program will ask you what you want when you click on "Create Subdir".
  510. Note that a subdir in a zipfile only exists if you put files in it. If
  511. you do not compress anything in it, the created subdir will not appear
  512. in the zipfile.
  513.  
  514.  
  515.         *****************************
  516.         * III - Third part of the doc
  517.         *****************************
  518.  
  519.  
  520.    1 - Compression method
  521.    ----------------------
  522.  
  523.       The best compression method is _deflating_. It is quite
  524. recent, but is now available in PKZIP 2.04 and upper on PC, and in
  525. Zip 1.9/Unzip 5.0 on Unix (and Amigas etc).
  526.  
  527.       The deflating method has three variants : one that compress
  528. faster but not so good, one medium, and one which compress best but
  529. slowly. There are buttons to select the one you want in Gem (Config
  530. dialog box). Using a command line, -edf gives you the fast one, -edb
  531. the best one, and -ed the medium.
  532.  
  533.     The default compression method is the medium deflating.
  534.  
  535.     _Shrinking_ is an very fast compression method, but not as good
  536. as deflating or imploding. _Storing_ simply stores the files without
  537. compression. You may use that if the files are uncompressible (already
  538. compressed files or compressed pictures such as GIF or JPEG files).
  539.  
  540.     _Imploding_ is an old compression method, now considered as
  541. obsolete since deflating is better. You may still use it if you want that
  542. your files may be extracted using old versions of STZip.
  543.  
  544.     STZip checks if the file to be compressed has been already
  545. compressed using ARC, LHARC, ZIP, ZOO, freeze, compress, PfxPack, Ice
  546. or Atom. That way, you won't loose time or space trying to compress
  547. files that would give bad or no compression at all (not speaking of
  548. growing in size, which is possible with the Implode method).
  549.  
  550.  
  551.    2 - Updating and freshening
  552.    ---------------------------
  553.  
  554.        These options allows to add a file you specified (in the command
  555. line) or selected (in Gem) only if it is needed :
  556.  
  557.  -Freshening : only specified files that are already in the zip and are
  558.         newer than those in the zip will be added.
  559.  -Updating : only specified files that are already in the zip and are
  560.          newer than those in the zip, _AND_ the specified files that are
  561.          not in the zipfile will be added.
  562.  
  563.  -Using a date line : only the files changed after the specified date will
  564.          be added.
  565.  
  566. To use those features in Gem, click on the 'Add Mode' box, and select what you
  567. want.
  568.  
  569. To use those features in a command line,
  570.    freshening is -f : stzip -f backup *.c
  571.    updating is -u   : stzip -u galery *.gif
  572.    date line is -t  : stzip -a -t011692 fip *.prg
  573.       Will add all *.prg files created or changed after Janury 16th 1992.
  574.       Note the US date format !
  575.  
  576.  
  577.    3 - Self extracting files
  578.    -------------------------
  579.  
  580.   You may use ZIP2TOS.PRG to convert a zip file to a .TOS program which
  581. will contains the compressed files and will extract them when launched.
  582.  
  583.   Without parameters, you will be prompted for the file to convert. You may
  584. also calls it with the zipfile names in parameters, from the desktop (drag
  585. a file) or a shell (zip2tos *.zip)
  586.  
  587.   A self extracting file should contains _only_ deflating or stored files. It
  588. will be unable to explode or unshrink files. This is _not_ checked when
  589. ZIP2TOS does the conversion.
  590.  
  591.   A self extracting file may be used as a normal zip file. Using STZip >1.3,
  592. you will be able to change the comments, list, extract, add or delete
  593. compressed files in the self extracting file.
  594.  
  595.   When creating a self extracting file, you may choose if the self
  596. extracting file will overwrite files during extraction without asking.
  597. Answer Yes to the question in Gem, or use the -o switch in command line
  598. if you want that.
  599.  
  600.  
  601.    4 - Encryption
  602.    --------------
  603.  
  604.   A compressed file inside a zip may be crypted. STZip use the same
  605. algorithm as PKZIP, and also support the slighly different method used
  606. in the Unix versions of Zip/Unzip.
  607.  
  608.   You may specify a password using the -w switch when using the command
  609. line interface, or by clicking in the "Crypt box" in the Gem interface.
  610. The files to be compressed will be encrypted using that password.
  611.  
  612.   That password will be also used when extracting files. If you forgot
  613. to specify it and STZip encounter a crypted file, it will prompt you.
  614. (i.e. : if you compress files using password BURP and extract them
  615. without leaving STZip, STZip won't prompt you for the password since it
  616. still has BURP in mind).
  617.  
  618.   STZip is also able to tell you if the password supplied for extracting a
  619. file is wrong. Note that the password is not stored in the file (would be
  620. stupid!), STZip uses some techniques to see if the beginning of the file
  621. extracts correctly with the supplied password.
  622.  
  623.  
  624.    5 - Return codes from command line mode
  625.    ---------------------------------------
  626.  
  627.   1 : not enough memory
  628.   2 : file not found
  629.   3 : illegal option
  630.   4 : two actions specified
  631.   5 : no zip file specified
  632.   6 : no command specified
  633.   7 : error reading
  634.   8 : this file is not a zip file
  635.   9 : error writing
  636.  11 : warning during extraction (read/write error, CRC error ...)
  637.  12 : warning during compression
  638.  13 : error while copying tempo zip file to original zip
  639.       (file __TMP__.ZIP may however be a correct zipfile)
  640. 100 : Function not implemented
  641.  
  642.  
  643.     6 - Limitations
  644.     ---------------
  645.  
  646. The number of files in a zip is maximum 65536.
  647.  
  648.  
  649.     7 - The End
  650.     -----------
  651.  
  652. Thanks to H. Okumura for his help with the 'sliding dictionary' 
  653. compression and to Philippe Regnauld for the STZIP logo in GEM.
  654.  
  655. Have fun using it !
  656.  
  657.  
  658.         Vincent Pomey, 28 April 1990, 13 April 1991.
  659.         Translation by Peter Kocourek, 25 July 1991.
  660.         Updated, 27 December 1992, 13 Febrary 1993, 30 April 1993,
  661.              2 April 1994
  662.