home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / database / zwiz12.zip / ZWIZAT.DOC < prev    next >
Text File  |  1990-11-21  |  35KB  |  817 lines
  1.  
  2.                    INSTALLATION AND INSTRUCTION DOCUMENT
  3.  
  4.                              ZWiz (ZIP Wizard)
  5.  
  6.                               AT Version 1.2
  7.  
  8.                        Copyright 1990 Robert S. King
  9.  
  10.                          Published by Wordsetters
  11.                                P. O. Box 709
  12.                            Winterville, GA 30683
  13.  
  14. Introduction
  15.  
  16.      ZWiz is a set of WordPerfect 5.1 macros integrated as a full-featured
  17. shell for PKWARE's popular ZIP archive program.  ZWiz allows for easy ZIPing
  18. and unZIPing of files while still in WordPerfect.  Special features include
  19. multiple command line options and the ability to retrieve a file from inside
  20. a ZIP into WordPerfect.  The program is menu-driven and is thus easy to use,
  21. though you should read this document in its entirety before executing ZWiz. 
  22. You may wish to customize some of ZWiz's routines to fit your specific needs. 
  23. Alteration of these macros is permitted, though distribution of your custom-
  24. ized version is strictly prohibited.
  25.      In any event, please keep backups of your original documents.  Neither
  26. the author nor Wordsetters will be held responsible for any damages resulting
  27. from any use of this program whatsoever.
  28.      One other note on customization:  WordPerfect Corporation is constantly
  29. changing its program.  This version of ZWiz has been tested on the June 29,
  30. 1990 release of WP 5.1.  Each new release requires slight modifications to
  31. the macros.  The latest ZWiz will always be available for download from The
  32. Express Line BBS (FidoNet 1:370/20)--node 1: (404) 742-8313 for first-time
  33. callers, 2400 baud; node 2: (404) 742-7736, 9600 baud.  Or you may receive a
  34. copy through the mail by sending a self-addressed, stamped disk mailer with
  35. floppy disk to the address shown above.
  36.  
  37.  
  38. System Requirements
  39.  
  40.      To run ZWiz you should have the following at minimum:
  41.  
  42.      MS-DOS version 2.0 or greater
  43.      640K RAM
  44.      Hard Disk Drive C with at least 1 megabyte free
  45.      WordPerfect 5.1
  46.      PKZ110.EXE (Phil Katz's archive program containing PKZIP, PKUNZIP, etc.)
  47.      FV.COM (Vernon Buerg's archive file viewer, included in the ZWiz
  48.           archive--but see Acknowledgements/Disclaimers below for important
  49.           information).
  50.  
  51.  
  52. Testing
  53.  
  54.      Zwiz has been tested on several 80286 and 80386 machines, and it has
  55. performed, in terms of elapsed time, comparably to other popular shells, such
  56. as ArcMaster and Shez.  ZWiz has also been tested on a 4.77 MHz PC, and it
  57. has performed predictably slower.  Users of such machines will have to
  58. determine for themselves the program's suitability for their needs.
  59.  
  60.  
  61. Automatic Installation
  62.  
  63.      Execute the macro ZWSETUP.WPM and follow the prompts.  It's the easiest
  64. game in town!
  65.  
  66.  
  67. Manual Installation
  68.  
  69.      The distribution disk (or the archive file, if you downloaded ZWiz from
  70. a bulletin board) contains two internal ZIP files.  The complete list of
  71. files is as follows:
  72.  
  73. ZWIZXT.ZIP, in which are found:
  74.  
  75.      FV.COM         Vernon Buerg's File Viewer (see Acknowledge-
  76.                     ments/Disclaimers below)
  77.      FV.DOC         Documentation for FV
  78.      ZWTAG.WPM      Allows tagging of individual files within ZIP
  79.      ZWTAG2.WPM     Allows tagging of files within ZIP; shows file comments
  80.      ZWUZ.WPM       Main macro for unZIPing files
  81.      ZWZ.BAT        General batch file for ZIPing files
  82.      ZWIZ.WPM       Main ZWiz macro
  83.      ZWSAVE.WPM     File saving routines
  84.      ZWZ2.WPM       Controls new target directory selection for ZIPing files
  85.  
  86. ZWIZAT.ZIP, in which are found:
  87.  
  88.      FV.COM         see above   ╔═══════════════════════════╗
  89.      FV.DOC         see above   ║ Note: The coding of these ║
  90.      ZWTAG.WPM      see above   ║ duplicate files differs   ║
  91.      ZWTAG2.WPM     see above   ║ dramatically from the     ║
  92.      ZWUZ.WPM       see above   ║ above.                    ║
  93.      ZWIZ.WPM       see above   ╚═══════════════════════════╝
  94.      ZWSAVE.WPM     see above
  95.      ZWTASKS.WPM    File handling routines
  96.  
  97. Separately in the main archive are:
  98.  
  99.      README.1ST     Setup info and version history for ZWiz
  100.      ZWIZXT.DOC     ZWiz XT complete documentation, ASCII version
  101.      ZWIZXT.DOK     ZWiz XT complete documentation, WordPerfect 5.1 version
  102.      ZWIZAT.DOC     ZWiz AT complete documentation, ASCII version
  103.      ZWIZXT.DOK     ZWiz AT complete documentation, WordPerfect 5.1 version
  104.      ZWSETUP.WPM    ZWiz installation macro
  105.  
  106. All WPM files should be copied into the directory where you keep your macros
  107. (press Shift-F1, then 6 [location of files] to determine where these files
  108. should go).  FV.COM should be copied to a directory specified in your boot-up
  109. path statement (see AUTOEXEC.BAT file)--usually the root directory (C:\). 
  110. (Also, PKZIP & PKUNZIP must be in your path statement.)  ZWiz will not
  111. operate unless those files are properly placed!
  112.      Once all files are copied, I recommend that you rename or copy the main
  113. executable macro, ZWIZ.WPM, to a shorthand name, such as ALTZ.WPM.  This
  114. method will allow quick execution of ZWiz.  Alternatively, you may wish to
  115. assign ZWIZ.WPM to your favorite keyboard (WPK).
  116.  
  117.  
  118. Files Used by ZWiz
  119.  
  120.      As needed, ZWiz creates two temporary files, ZW{ZIP}.SET and
  121. ZW{CAT}.SET, in the directories affected by the command line options select-
  122. ed.  It also creates a temporary document in Document 2 containing options
  123. and file list information.  Do not delete or move these files while ZWiz is
  124. running.
  125.  
  126.  
  127. Memory Caveats
  128.  
  129.      ZWiz macros operate by shelling to DOS and calling PKZIP.EXE,
  130. PKUNZIP.EXE or FV.COM, as required.  If you have a lot of TSRs (stay-resident
  131. programs), there may be insufficient memory to run external programs.  To get
  132. an idea of how much memory you have available after WordPerfect is loaded,
  133. press Shift-F1, C (for DOS command), then CHKDSK (assuming this program is in
  134. your path statement).  The amount of free memory will be shown in CHKDSK's
  135. report.  If it is less than 140K, you may have difficulty running ZWiz.  If
  136. such is the case, the only alternative is either to remove some/all of the
  137. TSR programs or to use one of WordPerfect's start-up option commands to limit
  138. the amount of work-space allotted to WordPerfect.
  139.      If you have expanded memory, your options are more flexible, particular-
  140. ly if you are using an expanded memory manager, such as QEMM, which allows
  141. TSRs and device drivers to be loaded into high memory, thus freeing up more
  142. conventional memory.  Even with expanded memory, you may benefit from
  143. limiting WordPerfect's work-space.  I recommend the following command line to
  144. load WordPerfect:
  145.  
  146.                WP/w=120,*
  147.  
  148. This limits WordPerfect's conventional memory work-space to 120K but allows
  149. it to use all available expanded memory.  See the WordPerfect manual for
  150. other start-up options.
  151.      Finally, if you are using a WPK file (keyboard macros) and its contents
  152. are large, there will be less memory available for ZWiz's use.  One trick in
  153. this case is to edit the individual keyboard definitions so that they execute
  154. the needed macros rather than contain all the macro code itself.  According-
  155. ly, to reduce keyboard memory overhead, perform the following steps:
  156.  
  157.           1.   Press Shift-F1 (Setup Menu)
  158.           2.   Press K (Keyboard Layout)
  159.           3.   Press 7 (Edit--assuming the cursor rests on the keyboard you
  160.                wish to edit)
  161.           4.   Move the cursor to whatever entry you wish to change and press
  162.                A (Action).  If the screen appearing next contains the com-
  163.                plete macro (i.e., the entry does not already simply call
  164.                another macro), this definition is a prime candidate for
  165.                change.
  166.           5.   Press F7 to get back to the list of key definitions.
  167.           6.   With the cursor on the desired entry, press S (Save).  You
  168.                will be prompted for a macro name.  Enter whatever name you
  169.                wish.
  170.           7.   Press A (Action) again to edit the contents.
  171.           8.   Hold down the Del key until all the macro code is deleted. 
  172.                (If the macro is very long, you may go back to the definition
  173.                list, delete the item from the menu and simply create it
  174.                anew.)
  175.           9.   Press Alt-F10, enter the name of the macro you just saved. 
  176.                Finally, press Ctrl-V ENTER.  As an example, suppose we had
  177.                just saved the contents to a macro called NEWMAC.WPM.  Your
  178.                screen should now show the following string:
  179.  
  180.                     {Macro}newmac{Enter}
  181.  
  182.                This short string requires less memory but the needed macro is
  183.                still available from the same keystrokes.
  184.  
  185.  
  186. ZIP Wizard Error Handling
  187.  
  188.      Every effort has been made to make ZWiz safe to operate.  If you will
  189. follow the prompts, you will have no problem.  Nevertheless, a few pitfalls
  190. should be mentioned up-front:
  191.  
  192.      1.   Do not press any keys that aren't called for in the prompts,
  193.           especially when in a file list display.  Even though a lot of error
  194.           handling code has been programmed into ZWiz, there are a few
  195.           situations in which WordPerfect inhibits the ability to handle
  196.           error situations.
  197.  
  198.      2.   If, for any reason, ZWiz aborts an operation, leaving text on the
  199.           screen, simply delete the text and start anew.
  200.  
  201.      3.   Again, keep backups of your files, especially until you are thor-
  202.           oughly familiar with the way ZWiz operates.
  203.  
  204.      4.   A maximum of three files at a time can be tagged for extraction
  205.           while in the contents list of any ZIP file (however, files tagged
  206.           for deletion may be any number).  This is not the author's limita-
  207.           tion.  The limit is imposed by WordPerfect, which will allow only
  208.           59 characters on the "DOS Commands" command line; it is also a
  209.           limit of the PKUNZIP program (which, unlike PKZIP, does not allow
  210.           the creation of an ASCII file containing a list of files to
  211.           process).
  212.  
  213.  
  214. Keystroke Rules
  215.  
  216.      In all ZWiz prompts for ZIP filename entry, whether for ZIP or unZIP,
  217. there is never any need to type the ZIP extension.  This is understood by the
  218. program.
  219.      IMPORTANT!  Turn your CAPS LOCK off!  ZWiz will accept only lower case
  220. letters for its menu options.
  221.  
  222.  
  223. Zip Wizard Operation
  224.  
  225.      Assuming all installation is complete:  To begin ZIPing or unZIPing
  226. files, execute ZWIZ.WPM (or whatever name you've given it).  ZWiz will first
  227. verify that Document 2 is empty.  If not, you are shown the following message:
  228.  
  229.                Document 2 must be empty to run ZWiz.      
  230.                Please save or remove file from memory     
  231.                and restart macro. Press ENTER to continue.
  232.  
  233. When the above condition is satisfied, the file list of the current directory
  234. displays with the ZWiz initial menu, a typical sample of which is shown in
  235. figure 1:
  236. ▓▓▓▓▓Go new DIR; Enter new target DIR; Listmask; UnZIP options; ZIP options▓▓▓▓▓
  237. ▓▓▓▓▓ Cursor Movement:  Arrow keys;  PgUp-PgDn;  Find File.  3. File Tasks ▓▓▓▓▓
  238. ▓▓▓▓▓ ENTER views file; 6 Looks;    Help;    Exit ZWiz;        F1 cancels. ▓▓▓▓▓
  239.  .    Current    <Dir>                  │ ..   Parent     <Dir>
  240.  FV      .COM    7,293  09-03-90 01:33a │ FV      .DOC    6,707  09-03-90 01:33a
  241.  ZWATALL .DOC  138,869  11-07-90 10:16a │ ZWIZ    .DOC   17,488  11-07-90 10:05a
  242.  ZWIZ10  .ZIP  126,055  11-11-90 11:51a │ ZWIZAT10.ZIP   22,662  11-11-90 11:50a
  243.  ZWIZXT10.ZIP   22,077  11-07-90 02:22p │ ZWSAVE  .DOC      885  11-07-90 10:01a
  244.  ZWSETUP .WPM    5,875  11-07-90 04:10p │ ZWTAG   .DOC    9,857  11-07-90 10:02a
  245.  ZWTAG2  .DOC   10,265  11-07-90 10:02a │ ZWTASKS .DOC   10,566  11-07-90 10:02a
  246.  ZWUZ    .DOC   35,250  11-07-90 10:04a │ ZWZ     .DOC   33,041  11-07-90 10:03a
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257. ▓▓▓▓▓  ZWiz (ZIP Wizard), version 1.0.  Copyright 1990 by Robert S. King  ▓▓▓▓
  258. ▓▓▓▓▓  Published by Wordsetters, P. O. Box 709, Winterville, GA 30683.    ▓▓▓▓
  259.  
  260.               Figure 1.  Initial ZWiz Menu and Directory Display.
  261.  
  262.  
  263. The options shown at the top of the screen are generally available, with some
  264. differences, in other ZWiz menu structure, such as UnZIP options.  These are
  265. discussed in detail in the sections following. The initial menu is intended
  266. primarily as a shell to the Options menus.
  267.  
  268.  
  269.                                   ZIPing Files
  270.  
  271.      If you press z at the menu shown in Figure 1, the ZIP menu immediately pops
  272. up, as in the following example (figure 2):
  273. ▓▓▓ Go DIR; New target DIR; 1. Path; 2. UnZIP menu; 3. File Tasks. Begin ZIP.▓▓▓
  274. ▓▓▓ Movement: Arrow keys; PgUp-PgDn; Find File.   Help;  Exit/F1;   Listmask.▓▓▓
  275. ▓▓▓ ENTER views ZIP; 6 Looks; * tags; Alt-F5 tags all; - untags under cursor.▓▓▓
  276.  .    Current    <Dir>                  │ ..   Parent     <Dir>
  277.  FV      .COM    7,293  09-03-90 01:33a │ FV      .DOC    6,707  09-03-90 01:33a
  278.  ZWATALL .DOC  138,869  11-07-90 10:16a │ ZWIZ    .DOC   17,488  11-07-90 10:05a
  279.  ZWIZ10  .ZIP  126,055  11-11-90 11:51a │ ZWIZAT10.ZIP   22,662  11-11-90 11:50a
  280.  ZWIZXT10.ZIP   22,077  11-07-90 02:22p │ ZWSAVE  .DOC      885  11-07-90 10:01a
  281.  ZWSETUP .WPM    5,875  11-07-90 04:10p │ ZWTAG   .DOC    9,857  11-07-90 10:02a
  282.  ZWTAG2  .DOC   10,265  11-07-90 10:02a │ ZWTASKS .DOC   10,566  11-07-90 10:02a
  283.  ZWUZ    .DOC   35,250  11-07-90 10:04a │ ZWZ     .DOC   33,041  11-07-90 10:03a
  284.  
  285.  
  286.  
  287.  
  288.  
  289.  
  290.  
  291.  
  292.  
  293. ▓▓▓ a. add; c. comment files; d. delete w/comments; s. delete w/o comments; ▓▓▓
  294. ▓▓▓ f. freshen; k. keep same date; m. move; o. set to latest; u. update;    ▓▓▓
  295. ▓▓▓ v. view w/comments; z. ZIP comment;  y. Reset options/files; 4. Make SX ▓▓▓
  296.  
  297.            Figure 2.  ZIP Options Menu and Directory Display.
  298.  
  299.  
  300.  
  301. ZIP Menu Options
  302.  
  303. Top Menu
  304.  
  305.      Go DIR:  Pressing G will allow you to change the file directory and will
  306. show the following prompt:
  307.  
  308. ▓▓▓▓▓            Enter drive letter to change to:            ▓▓▓▓▓
  309.  
  310. Then you are asked to type in the directory name:
  311.  
  312. ▓▓▓▓▓ Enter directory to change to (omit \), press ENTER ▓▓▓▓▓
  313.  
  314. Important!  When this prompt appears, do not type the leading \ character
  315. before the main directory name.  The necessary backslash characters are
  316. already in the program.  However, if you wish to log onto a subdirectory, you
  317. would type that character between directory and subdirectory.  The following
  318. examples demonstrate the proper syntax:
  319.  
  320.      For changing to a new directory on a hard disk:
  321.  
  322.      Incorrect:     \wpfiles
  323.                     \wpfiles\letters
  324.  
  325.      Correct:       wpfiles
  326.                     wpfiles\letters
  327.  
  328.      Exception to the rule:  If the prompt requests full pathname, then the
  329.      \ character should be included.
  330.  
  331.      For changing to a floppy disk, simply press ENTER when the prompt for
  332. directory appears.
  333.  
  334.      New Target DIR:  This sets the drive and directory into which the ZIP
  335. file will go.  For example, it is possible to tag files in the current
  336. directory and place the resulting ZIP file in another directory.  After
  337. pressing e, you are shown the following prompt:
  338.  
  339. ▓▓▓▓▓▓▓▓▓···········Please·choose·a·number:···············▓▓▓▓▓▓▓▓▓
  340. ▓▓▓▓▓▓▓▓▓·1.·Type·in·full·pathname·(e.g.,·D:\ARCHIVE)·····▓▓▓▓▓▓▓▓▓
  341. ▓▓▓▓▓▓▓▓▓·2.·Look·at·directories,·then·type·full·pathname·▓▓▓▓▓▓▓▓▓
  342.  
  343. If you choose 1, you are prompted for drive and directory.  If you choose 2,
  344. you are given the following:
  345.  
  346. ▓▓▓▓▓▓·Use·arrow·&·return·keys·to·move·around·directories,·▓▓▓▓▓▓
  347. ▓▓▓▓▓▓·press·F7·when·ready·to·choose·target·directory······▓▓▓▓▓▓
  348.  
  349. A few words of caution are in order regarding change of target directory: 
  350. Common sense must be used.  If, for example, you wanted to "view comments,"
  351. you would not want the target directory changed, as this option will view,
  352. not extract files.  Likewise, you would not change the target directory if
  353. you wanted to delete files from a ZIP archive.
  354.      This document assumes you are already familiar with PKZIP command
  355. parameters.  If not, you would be wise to review them.  Of course, you may
  356. routinely need only a few of the ZIP (or unZIP) options.  Most users will
  357. stick to ZIP options a, f, s, and m; and to unZIP options a, n, and o
  358. (discussed later).
  359.  
  360.      1. Path:  temporarily removes the top menu and shows your current
  361. drive/directory:
  362.  
  363.                You·are·here:·=============>
  364.                                       
  365.                Press·ENTER·to·continue
  366.  
  367.      2. UnZIP Menu:  takes you to the UnZIP options menu (figure 5 below).
  368.  
  369.      3. File Tasks:  When called, this menu will allow basic file handling
  370. such as copy/move/delete, etc. (see File Tasks section below).
  371.  
  372.      Begin ZIP:  This is the key to make it go!  Once you have selected all
  373. the options and tagged all the files you need, press this key to begin the
  374. ZIP operation.
  375.  
  376.      Movement:  Arrow keys; PgUp-PgDn:  These function exactly in the same
  377. manner as the normal WordPerfect keys.
  378.  
  379.      Find File:  Pressing i will allow you to move the cursor quickly to the
  380. needed file in the directory list.  The following prompt appears:
  381.  
  382.            Type name to search for, press ENTER
  383.  
  384.      Help:  Allows you to search for the topic you need help with (online
  385. help not available in the shareware version, though the DOK & DOC files
  386. included in the ZWiz archive contain complete information).
  387.  
  388.      Exit/F1:  Pressing either the x or F1 keys will exit ZWiz.  Please note
  389. also that the F1 (cancel) key can be used at any point in ZWiz to cancel the
  390. current operation.
  391.  
  392.      Listmask:  Sometimes you will not want to wade through a long file list. 
  393. You may, through the use of wildcards (*), select the file specifications you
  394. need to see.  Pressing l will first give you the following options:
  395.  
  396. ▓▓▓ Please choose filename pattern:                                ▓▓▓
  397. ▓▓▓ 1. *.zip 2. *.doc 3. *.txt 4. *.wpm 5. *.* 6. Other (you type) ▓▓▓
  398.  
  399.      ENTER views ZIP:  To view a ZIP file, simply move the cursor to the file
  400. and press ENTER.  The directory of the ZIP will promptly display.
  401.  
  402.      6 Looks:  To view a non-ZIP file, move the cursor to the file and press
  403. 6.
  404.  
  405.      * tags:  To tag a file for ZIPing (do not tag a file with the ZIP
  406. extension unless you want it added to the archive), move the cursor to the
  407. file and press *.  The file will be added to a list for processing (which may
  408. be reviewed at any time--see Bottom Menu, item y below).  Note that only the
  409. last file you tagged will appear with the * in the directory list, but all
  410. tagged files will be shown in the y options display.
  411.  
  412.      Alt-F5 tags all.  This assumes that you want every file in the current
  413. directory added to a ZIP file.  Before selecting this operation, be sure to
  414. choose the needed option(s) (see Bottom Menu below).
  415.  
  416.      - untags under cursor.  If you wish to untag a file from the processing
  417. list, move the cursor to the file and press -.
  418.  
  419.  
  420. Bottom Menu
  421.  
  422.      A brief synopsis of the ZIP Options shown at the bottom of the directory
  423. display (figure 2) is as follows:
  424.  
  425.      a. add:  Will add all tagged files to the designated ZIP file.  If the
  426. ZIP file already exists in the current directory, all non-ZIP files will be
  427. placed in that ZIP archive.
  428.  
  429.      c. comment files:  Will prompt you to add new comments, or to change old
  430. ones, to each file within the designated ZIP archive.  This is different from
  431. the z option, which adds a comment to the general ZIP file name, not to its
  432. individual files.
  433.  
  434.      d. delete w/comments:  Pressing d prompts you for a filename and then
  435. retrieves the directory of the designated ZIP file, asking you (figure 3) to
  436. tag the file(s) you wish to delete from the archive.  This is the same as s
  437. below, except the directory of the ZIP file is displayed with comments, if
  438. any, which you have attached to the files within the archive.  Please note
  439. that if the ZIP archive contains many files, it could take up to 25 seconds
  440. (depending on your computer's speed) before you see the directory display. 
  441. A sample screen is shown below:
  442.  
  443. 1      FV.COM       Vernon Buerg's archive file viewer         ╔═══════════════╗
  444. 2      FV.DOC       Documentation for FV.COM                   ║Type one of the║
  445. 3      ZWIZ.WPM     Main ZWiz macro                            ║highlighted    ║
  446. 4      ZWSAVE.WPM   ZWiz file saving routines                  ║commands below ║
  447. 5      ZWTAG.WPM    ZWiz file tagging, part 1                  ║press:    ENTER║
  448. 6      ZWTAG2.WPM   ZWiz file tagging, part 2                  ╠═══════════════╣
  449. 7      ZWTASKS.WPM  ZWiz file handling                         ║To select file ║
  450. 8      ZWUZ.WPM     ZWiz unZIP macro                           ║(maximum 3 to  ║
  451. 9      ZWZ.WPM      ZWiz ZIP macro                             ║unZIP, no max  ║
  452. ...............................................................║to delete),    ║
  453.                                                                ║type its Number║
  454.                                                                ╟───────────────╢
  455.                                                                ║When done,     ║
  456.                                                                ║press         D║
  457.                                                                ╟───────────────╢
  458.                                                                ║Move down one  ║
  459.                                                                ║screen:       +║
  460.                                                                ╟───────────────╢
  461.                                                                ║Move up one    ║
  462.                                                                ║screen:       -║
  463.                                                                ╚═══════════════╝
  464.  
  465.                   Figure 3.  Sample File Tagging Screen.
  466.  
  467.      s. delete w/o comments: Retrieves the directory of the designated ZIP
  468. file and prompts you (figure 3) to tag the file(s) you wish to delete from
  469. the archive. This is the same as d, except that the comments column will not
  470. appear (this method is thus a little quicker).
  471.  
  472.  
  473.      f. freshen:  Unlike other ZWiz functions, it is not necessary to tag
  474. files before selecting this option.  Freshening updates files that already
  475. exist in the ZIP file with same-named files with later times and dates.  When
  476. f is pressed, the following prompts displays:
  477.  
  478.              Type name of file to freshen, press ENTER
  479.  
  480.      k. keep same date:  The current ZIP file date is kept no matter what the
  481. dates of the files added to it are.
  482.  
  483.      m. move: The tagged files are deleted from disk after being compressed
  484. and copied into the ZIP archive.
  485.  
  486.      o. set to latest: The ZIP file date is set to the date of the newest
  487. file within it.
  488.  
  489.      u. update: The existing ZIP file will be updated with files only if they
  490. are not currently in the ZIP file, or if they are dated later than those with
  491. the same name already in the ZIP file.
  492.  
  493.      v. view w/comments: Unlike pressing ENTER to view a ZIP, this option
  494. displays the directory of the chosen archive file(s) and also shows any
  495. comments written for those files.  It is possible to view more than one file
  496. from a single directory by typing an asterisk (*) when prompted for a
  497. filename.  Do not include the ZIP extension.
  498.  
  499.      z. ZIP comment:  Adds a comment to the general ZIP file, not to the
  500. files contained within.
  501.  
  502.      y. Reset options/files:  Pressing y will immediately display the current
  503. tagged file list, the options chosen, and show you the target directory.  You
  504. will also see a menu at the bottom which allows you to reset options and
  505. files.  A sample screen is shown below (figure 4):
  506.  
  507.  
  508. Options:  -m 
  509. Files:
  510. TEXT1.DOC
  511. TEXT2.DOC
  512. TEXT3.DOC
  513.  
  514.  
  515.  
  516.                                  Target destination is c:\document
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.                        Please choose a number:
  525. 1. Reset options;  2. Reset file list;  3. Reset both;  4. Leave as is
  526.  
  527.                  Figure 4.  Reset Options/Files Menu.
  528.  
  529.  
  530.      4. Make SX:  This option converts an existing ZIP file to an EXE file
  531. (self-extracting archive).  It is not necessary to tag the ZIP filename; you
  532. are prompted for the name immediately after pressing 4.
  533.  
  534.  
  535. Sample ZIP Session
  536.  
  537. First let's assume we have a file (TRASH.CAN) in the current directory
  538. (C:\JUNK) which we want to add to the ZIP file (OZONE.ZIP) located in another
  539. drive and directory (D:\RECYCLE):
  540.  
  541.           ZWIZ.WPM is executed and the menu in figure 2 displays (with a
  542. different file list, of course).
  543.  
  544. Use the arrow keys to move to the file TRASH.CAN.
  545.  
  546. Press *
  547.  
  548.           The file is tagged and placed in the Files list (as in figure ?),
  549.           after which the directory is redisplayed.
  550.  
  551. Press a
  552.  
  553.           This places the proper PKZIP option parameter in the Options list
  554.           (as in figure 4).
  555.  
  556.           NOTE:  Sometimes the letter shown in the Options field will differ
  557.           from the letter you pressed at the Options Menu.  This is because
  558.           of conflicts between PKZIP parameters and the available ZWiz menu
  559.           options.  You need only know that ZWiz will issue the proper
  560.           command to PKZIP or to PKUNZIP, as the case may be.
  561.  
  562. Press e
  563.  
  564.           The prompt appears (figure ?)
  565.  
  566.  
  567. Press 1
  568.  
  569. Press d   (to enter the drive letter)
  570.  
  571. Type recycle
  572.  
  573. Press ENTER
  574.  
  575. Press b   (to begin the ZIP operation)
  576.  
  577. Type ozone
  578.  
  579. Press ENTER
  580.  
  581.           The ZIP operation will begin.
  582.  
  583.  
  584.                               unZIPing Files
  585.  
  586.      Pressing u from the initial ZWiz menu (figure 1) or 2 from the ZIP
  587. options menu (figure 2) will take you to the UnZIP options menu, as in the
  588. following example (figure 5):
  589. ▓▓▓ Go DIR; New target DIR; 1. Path; 2. ZIP menu; 3. File Tasks. Begin unZIP.▓▓▓
  590. ▓▓▓ Movement: Arrow keys; PgUp-PgDn; Find File.   Help;  Exit/F1;   Listmask.▓▓▓
  591. ▓▓▓ ENTER views ZIP; 6 Looks; * tags; Alt-F5 tags all; - untags under cursor.▓▓▓
  592.  .    Current    <Dir>                  │ ..   Parent     <Dir>
  593.  ZWIZ10  .ZIP  126,055  11-11-90 11:51a │ ZWIZAT10.ZIP   22,662  11-11-90 11:50a
  594.  ZWIZXT10.ZIP   22,077  11-07-90 02:22p
  595.  
  596.  
  597.  
  598.  
  599.  
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.  
  607.  
  608.  
  609. ▓▓▓▓ a. UnZIP w/ask; d. Create DIRs; n. Extract only newer; o. overwrite; ▓▓▓▓
  610. ▓▓▓▓ q. Retrieve w/o comments; r. Retrieve w/comments; t. Test integrity; ▓▓▓▓
  611. ▓▓▓▓ u. Tag w/comment; w. Tag w/o comment; y. Reset opts/files;  4. Do SX ▓▓▓▓
  612.  
  613.   Figure 5. Initial UnZIP Options Menu (w/option to change target directory).
  614.  
  615.  
  616.  
  617. Top Menu
  618.  
  619. Again, the options on the Top Menu are the same as for the ZIP menu.  Like
  620. the ZIP options menu, pressing b begins the archive operation (see Top Menu
  621. under ZIPing Files above).
  622.  
  623.  
  624. Bottom Menu
  625.  
  626. The unZIP options (bottom menu) are explained as follows (see PKUNZIP
  627. documentation for greater detail):
  628.  
  629.      a. UnZIP w/ask:  All files are extracted to the target directory; the
  630. original ZIP file remains.  If a file already exists in the target directory,
  631. you are prompted to overwrite.
  632.  
  633.      d. Create DIRS:  allows recursive unZIPing; i.e., if the ZIP file stored
  634. the complete path information of the original files, the directories will be
  635. recreated upon extraction.
  636.  
  637.      n. Extract only newer:  Only files newer than the ones of the same
  638. name(s) already in the target directory will be extracted.
  639.  
  640.      o. Overwrite: All files in the ZIP are extracted to the target directory
  641. without confirmation for overwriting any existing files of the same name.
  642.  
  643.      q. Retrieve w/o comments:  Unlike r below, this is for a quick display
  644. of the ZIP files contents.  Only one file at a time may be processed.  When
  645. the file list displays, the screen displays as in figure 3 above.
  646.  
  647.      r. Retrieve w/comments:  This is the same as q above, except that the
  648. ZIP file's directory is displayed with file comments in the second column, if
  649. any.  This method of retrieval is noticeably slower than q, but is helpful in
  650. identifying potential file deletions.
  651.  
  652.      t. Test integrity:  checks the designated ZIP file to ensure it is not
  653. corrupt.  You may check more than one ZIP file simply by tagging each file
  654. you wish to test.
  655.  
  656.      u. Tag w/comment:  Same as s, but shows file comments, if any. This
  657. displays the contents of the chosen ZIP file and prompts you to tag the
  658. file(s) you wish to extract (see figure 3).
  659.  
  660.      w. Tag w/o comment: Same as u above, but does not show comments.
  661.  
  662.      y. Reset opts/files:  Exactly the same as y on the ZIP options menu (see
  663. above).
  664.  
  665.      4. Do SX:  Any self-extracting archive may be unZIPed using this option.
  666.  
  667. That's all there is to it!
  668.  
  669.  
  670.                                 File Tasks
  671.  
  672. Pressing 3 either from the initial ZWiz menu or from the ZIP or unZIP options
  673. menus takes you to a file handling menu from which you may do routine copy/
  674. move/delete tasks.  This is generally the same as WordPerfect's own menu and
  675. is included in ZWiz only for convenience.  For example, if you have been in
  676. the ZIP options menu and have tagged files for processing, you may go to the
  677. File Tasks menu without erasing the work you've done.
  678. Shareware versus Registered Version
  679.  
  680.      The registered version of ZWiz contains the following added features:
  681.  
  682.      1.   Online help screen
  683.      2.   More ZIP & unZIP options.
  684.  
  685.  
  686. Registration
  687.  
  688.      Basic registration of ZWiz is $15.00 + $2.50 postage and handling.  That
  689. amount entitles you to future upgrades of the program for only a nominal
  690. handling cost.  On receipt of initial payment, you will be mailed the
  691. registered version.  Thereafter, you may receive any upgrade by sending a
  692. self-addressed, stamped disk mailer with floppy disk to the address shown on
  693. the order form at the end of this document.  You can determine if a new
  694. version has been released by calling the Express Line BBS--see third
  695. paragraph under Introduction above. The Shareware and Registered versions
  696. follow the same numbering scheme--e.g., ZWIZ10.ZIP, ZWIZ11.ZIP (version 1.0,
  697. 1.1, etc.).
  698.      I hope you find ZWiz useful, and I thank you in advance for your
  699. support.
  700.  
  701.  
  702. Future Plans
  703.  
  704.      ZWiz will be expanded or improved as interest dictates.  If enough
  705. WordPerfect users want versions compatible with other archive formats, such
  706. as PAK, ARC, LZH, ZOO, etc., those revisions will be offered.
  707.      User input/suggestions are always encouraged and considered.
  708.  
  709.  
  710. Acknowledgements/Disclaimers
  711.  
  712.      PKZIP and PKUNZIP are products of Phil Katz's PKWARE, Inc., which in no
  713. way is affiliated with Wordsetters.  Users are expected to abide by the terms
  714. and conditions of product use and registration stipulated in the PKZIP110
  715. documentation files.
  716.      Likewise, FV.COM is a product of Vernon Buerg who has kindly granted
  717. permission to Wordsetters to include his fine program in our ZWiz distri-
  718. bution archive.
  719.      If you use any of these products, you are required to register them, and
  720. we strongly encourage you to support shareware.
  721. Also available from Wordsetters:
  722.  
  723. PASSKEY is a menu-driven productivity platform that runs under WordPerfect.
  724. A few of PASSKEY's features are a time-saving, fully customizable generic
  725. style platform that helps novice word processors input type like pros; easy
  726. input of all Latin alphabet-based languages and the foundation for working
  727. with other commonly needed symbols and languages like Russian and Japanese;
  728. tools such as a simple fraction generator, width calculator, error cleanup
  729. routines (including access to DocDoc, below); quick setup of variable storage
  730. keys; and much more!
  731.  
  732. Author:  Diane Kistner.  Registration price per copy: $15.00
  733.  
  734.  
  735. DOCDOC (Document Doctor) is an integrated set of WordPerfect 5.1 macros
  736. designed to facilitate cleanup and formatting of documents imported from
  737. other systems and/or other "typists."  It provides for menu-driven or
  738. automatic operation.  Special features include stripping and conversion of
  739. codes into generally accepted typesetting formats.
  740.  
  741. Author:  Robert S. King.  Registration price per copy: $15.00
  742.  
  743.  
  744. WPMKEYS is a macro-making keyboard for WordPerfect 5.1.  It provides a quick
  745. means of macro coding while running WordPerfect's internal macro editor.  It
  746. includes coding for all WordPerfect macro commands (as of the 6/29/90
  747. release) and is included free of charge in any Wordsetters distribution disk.
  748.  
  749. Author:  Robert S. King.  Registration price:  none, Freeware.
  750.  
  751.  
  752.  
  753.      We are always working on enhancements to the above products as well as
  754. on new ones.  Send self-addressed, stamped envelope for current product
  755. information to
  756.  
  757.                     Product Updates
  758.                     Wordsetters
  759.                     P. O. Box 709
  760.                     Winterville, GA 30683
  761.                              Registration Form
  762.  
  763.                          Wordsetters Macros Series
  764.  
  765. Last Name: ________________________________________
  766.  
  767. First Name: _______________________________________  MI: ________
  768.  
  769. Street address: _________________________________________________
  770.  
  771.                 _________________________________________________
  772.  
  773.                 _________________________________________________
  774.  
  775. City: __________________________________________ 
  776.  
  777. State: ________________________________________  ZIP: ___________
  778.  
  779. Day voice phone: ______________________________ (optional)
  780.  
  781. Evening voice phone: __________________________ (optional)
  782.  
  783. Data phone, if any: ___________________________
  784.  
  785. Network address, if any (e.g., FidoNet): ______________________
  786. ******************************************************************
  787. Please check product(s) you wish to order:
  788.  
  789.     A.  Single copies, $15.00/ea:  DocDoc ______  Passkey ______
  790.  
  791.                                    ZWiz ______
  792.  
  793.     B.  Package deal:   $25.00 for any two checked above _______
  794.  
  795.                         $35.00 for all three ______
  796.  
  797. How did you learn of these products? ____________________________
  798.  
  799. _________________________________________________________________
  800.  
  801. Comments/suggestions: ___________________________________________
  802.  
  803. _________________________________________________________________
  804.  
  805. _________________________________________________________________
  806.  
  807. _________________________________________________________________
  808.  
  809. _________________________________________________________________
  810.  
  811. Amount enclosed:                          $_____________
  812.  
  813. ******************************************************************
  814. MAIL CHECK PAYABLE TO         Wordsetters
  815.                               P. O. Box 709
  816.                               Winterville, GA 30683
  817.