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