home *** CD-ROM | disk | FTP | other *** search
/ Shareware Supreme Volume 6 #1 / swsii.zip / swsii / 071 / ZCM12.ZIP / CE.DOC next >
Text File  |  1992-03-27  |  40KB  |  1,065 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.                              Zip CommentMaster 1.2
  12.  
  13.                                  Copyright 1992
  14.  
  15.                               All Rights Reserved
  16.  
  17.                           New-Ware Shareware Products
  18.                                8050 Camino Kiosco
  19.                               San Diego, CA 92122
  20.                                  (619) 455-6225
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.                                  Contents
  34.  
  35.  
  36.           1  Disclaimer  . . . . . . . . . . . . . . . . . . . . . . .  2
  37.           2  What is ZIP CommentMaster?  . . . . . . . . . . . . . . .  2
  38.           3  Programs Needed to Operate ZCM  . . . . . . . . . . . . .  2
  39.           4  About Shareware . . . . . . . . . . . . . . . . . . . . .  3
  40.           5  How To Register . . . . . . . . . . . . . . . . . . . . .  4
  41.           6  The New-Ware BBS  . . . . . . . . . . . . . . . . . . . .  5
  42.           7  System Requirements . . . . . . . . . . . . . . . . . . .  5
  43.           8  Distribution Files  . . . . . . . . . . . . . . . . . . .  6
  44.              8.1  Version History  . . . . . . . . . . . . . . . . . .  6
  45.              8.2  Running ZCM  . . . . . . . . . . . . . . . . . . . .  6
  46.           9  The User Interface  . . . . . . . . . . . . . . . . . . .  7
  47.              9.1  Primary Commands . . . . . . . . . . . . . . . . . .  7
  48.              9.2  Mouse Interface  . . . . . . . . . . . . . . . . . .  7
  49.              9.3  On-line Help . . . . . . . . . . . . . . . . . . . .  8
  50.           10  Configuring ZCM  . . . . . . . . . . . . . . . . . . . .  8
  51.              10.1  Check Boxes . . . . . . . . . . . . . . . . . . . .  8
  52.                 10.1.1  [X] Sort The Dir Tree  . . . . . . . . . . . .  8
  53.                 10.1.2  [X] Split File Names . . . . . . . . . . . . .  8
  54.                 10.1.3  [X] Use Beeps  . . . . . . . . . . . . . . . .  9
  55.                 10.1.4  [X] Rename PKFIXED.ZIP . . . . . . . . . . . .  9
  56.                 10.1.5  [X] Mouse 1st Click  . . . . . . . . . . . . .  9
  57.                 10.1.6  [X] Clear On 1st Char  . . . . . . . . . . . .  9
  58.              10.2  Text Edit Fields  . . . . . . . . . . . . . . . . .  9
  59.                 10.2.1  Temp Dir . . . . . . . . . . . . . . . . . . .  9
  60.                 10.2.2  Log Dir  . . . . . . . . . . . . . . . . . . . 10
  61.                 10.2.3  Password . . . . . . . . . . . . . . . . . . . 10
  62.                 10.2.4  Browser  . . . . . . . . . . . . . . . . . . . 10
  63.              10.3  Dialong Exit  . . . . . . . . . . . . . . . . . . . 10
  64.           11  System Navigation  . . . . . . . . . . . . . . . . . . . 11
  65.              11.1  Changing Drives . . . . . . . . . . . . . . . . . . 11
  66.              11.2  Changing Directories  . . . . . . . . . . . . . . . 11
  67.              11.3  The New-Ware Tree Catalog Strategy  . . . . . . . . 11
  68.           12  Editing ZIP Comments . . . . . . . . . . . . . . . . . . 12
  69.              12.1  The ZIP File Viewer . . . . . . . . . . . . . . . . 12
  70.              12.2  Comment Editing     . . . . . . . . . . . . . . . . 12
  71.                 12.2.1  Individual File Editing  . . . . . . . . . . . 12
  72.                 12.2.2  Main File Comment  . . . . . . . . . . . . . . 13
  73.              12.3  Saving All Comments . . . . . . . . . . . . . . . . 14
  74.           13  Searching ZIP Files For Comments   . . . . . . . . . . . 14
  75.  
  76.  
  77.  
  78.                                        i
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.           14  ZIP Main Comment Batch Mode  . . . . . . . . . . . . . . 15
  86.           15  Editing The Default Main Comment . . . . . . . . . . . . 15
  87.           16  List To File . . . . . . . . . . . . . . . . . . . . . . 15
  88.           17  Editing Commands . . . . . . . . . . . . . . . . . . . . 16
  89.           18  Credits  . . . . . . . . . . . . . . . . . . . . . . . . 16
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.                                        ii
  137.  
  138.  
  139.  
  140.  
  141.  
  142.   1  Disclaimer
  143.  
  144.  
  145.        New-Ware hereby disclaims all warranties relating to this product,
  146.   whether express or implied, including without limitation any implied
  147.   warranties of merchantability or fitness for a particular purpose. New-Ware
  148.   cannot and will not be liable for any special, incidental, consequential,
  149.   indirect or similar damages due to loss of data or any other reason, even if
  150.   New-Ware or an authorized New-Ware agent has been advised of the possibility
  151.   of such damages.  In no event shall the liability for any damages ever
  152.   exceed the price paid for the license to use software, regardless of the
  153.   form and/or extent of the claim.  The user of this program bears all risk as
  154.   to the quality and performance of the software.
  155.  
  156.  
  157.   2  What is ZIP CommentMaster?
  158.  
  159.  
  160.        The PKWare ZIP file compression system is the most widely used of all
  161.   available systems.  One of the features that the ZIP system supports is user
  162.   addition and modification of a 60 character comment for each file residing
  163.   in a ZIP file library.  ZIP also supports a user specified comment that is
  164.   applicable to the entire ZIP file.
  165.  
  166.        As nice as having comments for ZIP compressed files is, the manner in
  167.   which these comments are added or modified is quite clumsy.  So clumsy, in
  168.   fact, as to mitigate against using comments at all.  That's where the ZIP
  169.   CommentMaster (known hereafter as ZCM) comes in.
  170.  
  171.        ZCM is slick utility that permits a ZIP system user to rapidly and
  172.   easily manipulate comments.  A full-featured string editor is provided to
  173.   edit and store individual comment strings and a full-featured text editor is
  174.   provided to manipulate a main ZIP file comment.  In addition, ZCM allows
  175.   using a file browser such as Vernon Buerg's famous LIST to view the contents
  176.   of compressed ZIP files and to execute PKware's PKZIPFIX utility on any ZIP
  177.   or SFX (self-extracting) EXE file.
  178.  
  179.        ZCM has been thoroughly tested using version 1.10 of the PKWare ZIP
  180.   system.  ZCM works with normal ZIP files, encrypted ZIP files, and ZIP files
  181.   containing files created with the PKWare Authenticity Verification envelope
  182.   (AV).
  183.  
  184.  
  185.   3  Programs Needed to Operate ZCM
  186.  
  187.  
  188.        You will need to acquire either the Shareware distribution version or
  189.   the registered version of PKWare's ZIP compression system.  As of this
  190.  
  191.  
  192.  
  193.                                      - 2 -
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.   writing, the current version is 1.10 and is usually distributed in a file
  201.   name PKZ110.EXE (or ZIP).  You can contact PKWare at the address below:
  202.  
  203.             PKWARE Inc.
  204.             7545 North Port Washington Road
  205.             Suite 205
  206.             Glendale, WI 53217-3422
  207.  
  208.        You can also find this marvelous system on just about any computer
  209.   bulletin board system (BBS) or commercial on-line access system such as
  210.   Compuserve Information Service (CIS) or Genie.  PKZ110.EXE may be accessed
  211.   from the New-Ware BBS.  Please see the chapter on the New-Ware BBS in this
  212.   document.
  213.  
  214.        The files in this package that may be called by ZCM are PKZIPFIX.EXE,
  215.   ZIP2EXE.EXE, and PKUNZIP.EXE.  PKZIPFIX is used in those rare cases where a
  216.   ZIP file has a problem, ZIP2EXE is used to convert a ZIP file to a self-
  217.   extracting EXE file, and PKUNZIP is used to decompress files for viewing.
  218.   ZCM does not require any of the ZIP system files for manipulation and
  219.   listing of ZIP files comments.
  220.  
  221.        New-Ware strongly recommends Vernon Buerg's famous LIST file browser
  222.   for use with ZCM.  Contact:
  223.  
  224.             Vernon D. Buerg
  225.             139 White Oak Circle
  226.             Petaluma, CA  94952
  227.  
  228.  
  229.   4  About Shareware
  230.  
  231.  
  232.        ZCM is Shareware.  PKZIP and LIST are also Shareware.  Shareware is NOT
  233.   free.  It is computer software offered for sale at a set price and the only
  234.   real difference between Shareware and other commercial software products is
  235.   the method of distribution and the important "try before you buy" feature.
  236.   With Shareware you are normally licensed by the owner/author of the program
  237.   to operate the Shareware distribution copy on a trial basis.  Then if you
  238.   like it and make regular use of it, you are bound to pay for it.
  239.  
  240.        Registered users are those users that elect to pay for ZCM ($20) and
  241.   register that payment with New-Ware.  By virtue of registration and payment
  242.   for the program, registered users are granted a license to continue to
  243.   utilize the program on their personal computer for as long as they choose.
  244.   This license authorizes the user to use the program on any personal computer
  245.   system he or she may own so long as the program is operated on only one
  246.   computer system at a time.
  247.  
  248.  
  249.  
  250.  
  251.                                      - 3 -
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.        Site licenses for use of ZCM on multiple computers are available upon
  259.   request at a reduced fee that is based on the number of single machines
  260.   licensed for use.
  261.  
  262.  
  263.   5  How To Register
  264.  
  265.  
  266.        There is no functional difference between the Shareware distribution
  267.   version of AM and the registered version save the absence of the opening and
  268.   closing Shareware screens in the registered version.
  269.  
  270.        The price of ZCM is $20.00. you may register ZCM in one of three ways:
  271.  
  272.        1) By mail with check or money order to:
  273.  
  274.                            New-Ware
  275.                            8050 Camino Kiosco
  276.                            San Diego, CA 92122-1820
  277.  
  278.        2) By telephone with Visa/Mastercard to:
  279.  
  280.                            New-Ware
  281.                            (619) 455-6225
  282.                            8 a.m. to 5 p.m. PST
  283.                            Monday - Friday
  284.  
  285.        3) Electronically through the New-Ware BBS:
  286.  
  287.                  New-Ware Shareware Products BBS
  288.  
  289.                  (619) 450-3257 - Node #1 1200/2400/9600 (HST)
  290.                        455-5226 - Node #2 1200/2400
  291.  
  292.        Special site license rates for licensing multiple copies are available.
  293.   Please call for rate schedule information.
  294.  
  295.        Foreign (non-US/Canada) orders must include a $2.00 special handling
  296.   fee in addition to the $20.00 registration fee.  Also, no checks on banks
  297.   located outside the United States will be accepted.
  298.  
  299.        California residents MUST include state sales tax with their order.
  300.  
  301.        This Shareware version of ZCM may be freely copied and passed on to
  302.   other individual users for their evaluation.  Disk vendors and/or
  303.   distributors that desire to distribute ZCM must adhere to the guidelines
  304.   presented in VENDOR.DOC.
  305.  
  306.  
  307.  
  308.  
  309.                                      - 4 -
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.        Press Alt+R from the main ZCM display or from the closing Shareware
  317.   screen to display the registration window.  Prompts will be issued for the
  318.   pertinent information and you will have the option of printing the
  319.   registration form when the form is completed.
  320.  
  321.        Upgrades to later versions are available to registered users on the
  322.   New-Ware BBS at no cost.  Access to the BBS is a privilege granted by New-
  323.   Ware that may be revoked at any time for any reason.  Those who request
  324.   upgrades via telephone or mail must remit a $5.00 charge for an upgrade.
  325.  
  326.  
  327.   6  The New-Ware BBS
  328.  
  329.  
  330.                  New-Ware Shareware Products BBS
  331.  
  332.                  (619) 450-3257 - Node #1 1200/2400/9600 (USR      HST)
  333.                        455-5226 - Node #2 1200/2400
  334.  
  335.        The New-Ware Shareware Products BSS operates 24 hours per day, 7 days
  336.   per week.  Node #1 is dedicated to registered users only.  Nodes #2 is open
  337.   to all callers.  Users registering via the BBS receive access to the latest
  338.   registered version within 1 day after leaving their credit card data.  Users
  339.   who register by mail or phone may also access the registered version by BBS,
  340.   but you MUST log on and leave a comment to the sysop to the effect that you
  341.   are a registered user and desire access.  The author can also be contacted
  342.   on CIS via PPN 71535,665 (please use EASYPLEX).
  343.  
  344.        The latest versions of all programs that are supported or used by ZCM
  345.   may be obtained via the BBS.  The BBS also serves as an avenue for product
  346.   support.  You may report problems or ask questions about the operation of
  347.   ZCM via the message facility of the BBS.
  348.  
  349.  
  350.   7  System Requirements
  351.  
  352.  
  353.        ZCM may be operated on any IBM PC/XT/AT/PS2 or compatible running under
  354.   DOS 2.0 and above.  Limitations include 500 ZIP/EXE files per directory, 350
  355.   directories per drive, and 500 files per archive.  Individual ZIP compressed
  356.   file comments are limited to 60 characters in length and the main ZIP
  357.   comment is limited to 32,760 characters.  ZCM may be operated in the
  358.   DESKQView and Windows 3.0 environments.
  359.  
  360.        All monitor and graphics cards are supported, including "composite" (2
  361.   color) monitors and backlit laptop screens.  Full mouse support is
  362.   automatically provided if a mouse driver is present in the system.  Any dot
  363.   matrix or laser printer may be used for printing file and directory tree
  364.  
  365.  
  366.  
  367.                                      - 5 -
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.   directory listings.  The printer must be capable of printing IBM line draw
  375.   characters if the directory tree is to be legibly printed.
  376.  
  377.        CE is designed primarily for use with one or more hard drives.
  378.   Starting and operating ZCM from a 5 1/4" 360K drive is not recommended
  379.   because of the possible lack of disk space for temporary files, etc.  A
  380.   multiple 3 1/2" 720K/1.4M or 5 1/4" 1.2M system will probably be okay, but a
  381.   hard drive is the best way to go.
  382.  
  383.  
  384.   8  Distribution Files
  385.  
  386.  
  387.        The following files are included in AM distribution package:
  388.  
  389.                  CE.EXE         - Main program
  390.                  CE.OVR         - Overlay file
  391.                  CE.HLP         - Help file
  392.                  CE.DOC         - Operating manual
  393.                  EDITCMDS.DOC   - Text & Line Editor Commands
  394.                  PATHINFO.TXT   - DOS PATH information
  395.                  VENDOR.DOC     - Disk vendor info
  396.                  WHAT'S.NEW     - Latest product info (if needed)
  397.  
  398.        New-Ware prohibits the modification of any of these files in any way,
  399.   shape, or form except by the individual evaluator or purchaser.
  400.  
  401.   8.1  Version History
  402.  
  403.   1.1  - Initial release.
  404.  
  405.   1.2  - Removed the ZIP directory list sort.  If the target ZIP file had a
  406.          directory list that was unsorted, the comments added by ZCM would
  407.          get out of synchronization with the file names.
  408.  
  409.   8.2  Running ZCM
  410.  
  411.        To access ZCM from anywhere in your system, place CE.EXE and CE.OVR in
  412.   a directory that is identified in your DOS path string.  If you are not
  413.   familiar with the DOS path string, please read PATHINFO.TXT.  To operate CE,
  414.   simple type CE and press the Enter key.  CE will then load and display all
  415.   the ZIP and EXE files in the current directory.  If you desire to operate on
  416.   a different directory, enter the full directory path name as a command line
  417.   parameter.  For example, suppose you wish to operate CE in a a valid
  418.   directory named E:\DATA\ZIPFILES.  Simply type CE E:\DATA\ZIPFILES and CE
  419.   will begin operation displaying ZIP and EXE files from the specified
  420.   directory.
  421.  
  422.  
  423.  
  424.  
  425.                                      - 6 -
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.   9  The User Interface
  433.  
  434.  
  435.        The ZCM user interface has been carefully designed to provide a set of
  436.   commands and controls that maximize the program's utility for both straight
  437.   keyboard and mouse users.  The interface employs a "point and shoot" file
  438.   manipulation function via file name lists with scrolling cursor bars.  All
  439.   ZCM functions are available through function keys or mouse clicks.  The
  440.   program can be exited to DOS by pressing Esc key, the mouse, or by pressing
  441.   Alt+X.  Alt+X exits immediately while the Esc key issues a prompt before
  442.   exiting.
  443.  
  444.   9.1  Primary Commands
  445.  
  446.        The main ZCM screen displays all the ZIP and EXE files found in the
  447.   active directory.  ZCM can automatically detect whether an EXE file is a
  448.   PKZIP SFX file nor not when the Enter key is pressed to view the file's
  449.   directory.
  450.  
  451.        In addition to using the mouse or the Enter key to view the contents of
  452.   a ZIP file, nine program functions are available from the main display.
  453.             On-line help                       F1
  454.             Configure ZCM                      F2
  455.             Change drive                       F3
  456.             Run PKZIPFIX                       F4
  457.             Change directory                   F5
  458.             Rebuild directory tree             F6
  459.             Individual comment search          F7
  460.             Main comment search                F8
  461.             Edit default comment file         F10
  462.             Send listing to file           Ctrl+L
  463.             Tag/Untag all files            Ctrl+T
  464.             Quit to DOS                       Esc
  465.  
  466.   These functions will be explained in detail later in this document.
  467.  
  468.        The Esc key is always used to abort a function or to leave a display.
  469.   The Enter key is used active a function or a feature.  The cursor keypad is
  470.   used to move the cursor or cursor bar.
  471.  
  472.   9.2  Mouse Interface
  473.  
  474.        CE provides full mouse support.  The mouse cursor is always visible and
  475.   movable.  The left mouse button acts as an "action" signal and it usually
  476.   emulates the Enter key.  The right button usually emulates the Esc key.
  477.   Nearly all ZCM displays have descriptive labels that can be clicked with the
  478.   mouse.  For example, the main display has a text box containing labels for
  479.   all the ZCM commands.
  480.  
  481.  
  482.  
  483.                                      - 7 -
  484.  
  485.  
  486.  
  487.  
  488.  
  489.  
  490.        The mouse can be configured to operate immediately upon the first
  491.   click.  This feature is most apparent when operating with a file list.  If
  492.   this option is not on, a click of the mouse when the mouse is not pointing
  493.   to an item under the cursor bar will move the cursor bar to that position.
  494.   If this option is on, a click of the mouse will instantly move the cursor
  495.   bar to that item and emulate a press of the Enter key.
  496.  
  497.   9.3  On-line Help
  498.  
  499.        Brief descriptions of all AM functions are available from the main ZCM
  500.   display and most other pop-up windows and dialog windows by pressing the F1
  501.   key or clicking the left mouse button on the "Help" string in one of the
  502.   window  borders.  Calling help from the main window will pop-up a help topic
  503.   menu.  Calling help from any other ZCM function will open a help window
  504.   appropriate to the program function from which help was called.
  505.  
  506.  
  507.   10  Configuring ZCM
  508.  
  509.  
  510.        ZCM maintains user specified configuration data in a file named CE.CFG.
  511.   This file will be created automatically the first time you configure ZCM and
  512.   elect to save that configuration.
  513.  
  514.        ZCM employs a dialog window as a user-interface for configuring the
  515.   program.  Press F2 at the main display to activate the configuration dialog.
  516.   A window will pop-up that contains a group of check boxes, five text field
  517.   editors, and an "Ok" push button box.  You can move from each of these
  518.   dialog areas with the mouse, the Tab Key (Shift+Tab to reverse), or the
  519.   Enter key.
  520.  
  521.   10.1  Check Boxes
  522.  
  523.        The check box area contains 6 checkable items.  When this area is
  524.   active, you may check or uncheck an item with the Space Bar, mouse, or the
  525.   "+" key.  If an item is checked, it is active.
  526.  
  527.   10.1.1  [X] Sort The Dir Tree
  528.  
  529.        If this item is checked, ZCM will always sort the directory tree when
  530.   scanning the disk.  If not checked, no sort occurs.
  531.  
  532.   10.1.2  [X] Split File Names
  533.  
  534.        ZCM can display file names in the conventional manner, e.g., as
  535.   FILENAME.EXT or in a split fashion as in FILE     EXT.  This option affects
  536.   both the main file display and the ZIP file view display.
  537.  
  538.  
  539.  
  540.  
  541.                                      - 8 -
  542.  
  543.  
  544.  
  545.  
  546.  
  547.  
  548.   10.1.3  [X] Use Beeps
  549.  
  550.        This option determines whether ZCM will emit a beep when certain
  551.   messages and warnings are issued.
  552.  
  553.   10.1.4  [X] Rename PKFIXED.ZIP
  554.  
  555.        This is an interesting option.  When PKZIPFIX is run against a ZIP
  556.   file, it creates a new file named PKFIXED.ZIP.  This file is a repaired
  557.   version of the target ZIP file.  If this option is on, ZCM will
  558.   automatically delete the target ZIP file and rename PKFIXED.ZIP to the name
  559.   of the target ZIP file.  If an SFX EXE file is involved, ZCM will
  560.   automatically convert PKFIXED.ZIP to PKFIXED.EXE using ZIP2EXE.  It is very
  561.   important that you have PKZIPFIX and ZIP2EXE located in a directory that is
  562.   in your DOS path.
  563.  
  564.   10.1.5  [X] Mouse 1st Click
  565.  
  566.        If this affects the behavior of ZCM when the left mouse button is
  567.   pressed (clicked) when browsing file lists or menus.  If this option is off
  568.   and the mouse cursor is over an item that is not under the cursor bar when
  569.   the left mouse button is pressed, the cursor bar will move to that item.  If
  570.   the left button is then pressed with the mouse cursor over the highlighted
  571.   item, ZCM treats the click as if the Enter key were pressed.  If this option
  572.   is on, then the cursor bar is moved immediately and the action is
  573.   interpreted instantly as a press of the Enter key.
  574.  
  575.   10.1.6  [X] Clear On 1st Char
  576.  
  577.        This option affects the line editor used to edit individual compressed
  578.   file comments.  If a comment already exists, it is loaded into the line
  579.   editor for you.  If this option is on, the entire line will be cleared if
  580.   you type any standard alphabetic character first.   If you press the
  581.   Backspace or Del key first, then the line clearing never takes place
  582.   automatically.
  583.  
  584.   10.2  Text Edit Fields
  585.  
  586.        There are five text edit fields.  Each is a served by same line editor
  587.   that is used elsewhere in the program.  After entering or editing the text
  588.   as desired, you can move on to the next field via the Tab key, by pressing
  589.   Enter, or by pressing Alt+k where k = highlight letter of the field title.
  590.  
  591.   10.2.1  Temp Dir
  592.  
  593.        This field provides ZCM with a temporary directory to use.  A valid DOS
  594.   directory must be entered here.  If nothing is entered, ZCM will created and
  595.   delete its own temporary directory as needed.
  596.  
  597.  
  598.  
  599.                                      - 9 -
  600.  
  601.  
  602.  
  603.  
  604.  
  605.  
  606.   10.2.2  Log Dir
  607.  
  608.        This directory is important to the New-Ware directory tree catalog
  609.   strategy.  If you enter a valid directory name here (C:\LOG is good), then
  610.   all accesses to the directory tree structures of your system will be greatly
  611.   speeded up.  ZCM will store the tree data for each drive it accesses in
  612.   files with the name of the form NEW-WARE.X, NEW-WARE.Y where X and why
  613.   connote drive designators.
  614.  
  615.   10.2.3  Password
  616.  
  617.        Entry of a password is important only if you are going to be using a
  618.   file browser to view compressed files.  When you are in the ZIP contents
  619.   viewer and press Ctrl+Enter to view a compressed file, ZCM does several
  620.   things.  The first action it takes is to call PKUNZIP to decompress the
  621.   target file to the temporary directory.  If the file you are viewing is
  622.   compressed and you have entered a password in this field, the password will
  623.   be passed to PKUNZIP.  If the file is encrypted and you have not configured
  624.   for a password, ZCM will not decompress the file because PKUNZIP will refuse
  625.   to decompress without the password.
  626.  
  627.   10.2.4  Browser
  628.  
  629.        This field is for configuration of the file browser you wish to use.
  630.   Most of you will undoubtedly use the ZCM default, which is LIST.  Be sure to
  631.   just enter the file name with NO extension, i.e., LIST and not LIST.COM.
  632.   ZCM does NOT pass the /M (use mouse) switch to LIST to force it into using
  633.   the mouse so if you intend to use LIST with ZCM be sure to run LIST
  634.   independently with the /M switch and then clone it.
  635.  
  636.   10.3  Dialong Exit
  637.  
  638.        If you desire to leave the configuration dialog without saving any
  639.   changes, just press the Esc key or mouse click the appropriate label.  If
  640.   you desire to keep your changes, you may mouse click the Ok box, press
  641.   Alt+k, move to the Ok box and press Enter, or mouse click the appropriate
  642.   label.  At this point the dialog window will clear and a window prompting
  643.   you for a place to save CE.CFG will appear.  You may not wish to save to
  644.   disk at this point in favor of using your configuration changes just for the
  645.   current session.  Or you may wish to save to disk.  It's your choice.
  646.  
  647.        It's important to understand that the location of CE.CFG is important.
  648.   If the only copy is in a directory that is not in the same directory from
  649.   which CE is executed or is not in the DOS path, CE will fail to find it and
  650.   it will not be loaded.  Best advice is to put both CE.EXE and CE.CFG in the
  651.   same directory and ensure that directory is in the DOS path so that you can
  652.   call this useful program from anywhere in your system.
  653.  
  654.  
  655.  
  656.  
  657.                                      - 10 -
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.   11  System Navigation
  665.  
  666.  
  667.        You can operate on any drive:\directory in your system via the main
  668.   display F3 and F5 commands.
  669.  
  670.   11.1  Changing Drives
  671.  
  672.        Pressing F3 will pop-up a list of drives from which to select.  Move
  673.   the cursor bar to the desired drive letter and press Enter, press the letter
  674.   key for the desired drive, or click on the desired drive to change to
  675.   another drive.  Press Esc to abort with no action.  A director tree for the
  676.   new drive will appear immediately after effecting the drive change with the
  677.   cursor bar over the currently active directory for that drive.
  678.  
  679.   11.2  Changing Directories
  680.  
  681.        Use the F5 command to change directories.  A window will pop up that
  682.   displays a graphical representation of the directory tree for the current
  683.   drive.  Move the cursor bar (or use the mouse) to the desired directory and
  684.   press the Enter key.  ZCM will then display all ZIP and EXE files found in
  685.   the designated directory.
  686.  
  687.   11.3  The New-Ware Tree Catalog Strategy
  688.  
  689.        Like many other New-Ware products, ZCM employs a strategy that greatly
  690.   speeds up display and use of the directory tree for a give drive.  The data
  691.   for each drives tree is maintained in a file residing in a user-specified
  692.   directory.  You must configure ZCM to use a valid system directory for this
  693.   strategy to be used.
  694.  
  695.        If you use this strategy, ZCM will build and maintain a catalog file in
  696.   the specified directory named NEW-WARE.X, where X indicates the letter of
  697.   the drive.  If you are not already using this strategy via another New-Ware
  698.   product, ZCM will scan the current drive to build the tree the first time it
  699.   is executed.  Access to the tree thereafter is much faster than scanning the
  700.   drive each time.
  701.  
  702.        There is one small drawback to using the catalog file strategy.  ZCM
  703.   will not know when directories are added or removed from a drive and you
  704.   will have to use the F6 command to re-scan the drive when this occurs.  This
  705.   necessity is a very minor drawback since most systems are fairly stable and
  706.   are not changed much.
  707.  
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.                                      - 11 -
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.   12  Editing ZIP Comments
  723.  
  724.  
  725.        This is what ZCM is all about - editing ZIP file comments.  This
  726.   section will address in detail just how easy this is with ZCM.
  727.  
  728.   12.1  The ZIP File Viewer
  729.  
  730.        Those of you that use ArcMaster will find the ZIP file viewer to be
  731.   like an old friend.  To activate the viewer, simply place the cursor bar
  732.   over a ZIP or SFX EXE file and press the Enter key.  The file viewer window
  733.   will replace the main display and will contain the list of files residing in
  734.   the target ZIP file.
  735.  
  736.        There are two display modes.  The default display shows each file in
  737.   the list as a line that contains the file name, date, time, size, compressed
  738.   size, compression type, and the ZIP version to extract.  If the file has a
  739.   PKWare Authenticity Verification (AV) envelope, an "AV" will appear at the
  740.   end of the file line.  The comment mode shows each file as the file name
  741.   and, if one exists, it's comment.  You can toggle back and forth between
  742.   these modes by using the F6 key.
  743.  
  744.   12.2  Comment Editing
  745.  
  746.   12.2.1  Individual File Editing
  747.  
  748.        You can edit file comments in either display mode.  Pressing the Enter
  749.   key will place you in the comment edit mode.  In this mode, the file name
  750.   for the comment being edited will remain visible and a 60 character line
  751.   edit field will be displayed adjoining the file name.  The commands
  752.   available for editing the comment are available via the F1 (help) key.
  753.  
  754.        You do not need to exit the edit mode (Esc key) in order to edit other
  755.   comments.  Pressing the Up or Down Arrow keys will move the edit field up or
  756.   down the list as desired and any edits made will be retained as the field
  757.   moves up or down.  You may also press the Enter key to move down the list.
  758.   The Esc key will exit the edit mode without retaining any edits made.
  759.  
  760.        You can restore the original contents of the an edit field at any time
  761.   prior to leaving it by pressing the Ctrl+R key.
  762.  
  763.        When you are finished editing comments you can save all your edits to
  764.   the target ZIP file by pressing the F5 key.  More about this later.  Use the
  765.   Esc key to exit the ZIP file viewer WITHOUT saving any edits.
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.                                      - 12 -
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.   12.2.2  Main File Comment
  781.  
  782.        The PKWare ZIP system permits the storage of one variable length
  783.   comment for each ZIP file.  ZCM provides a powerful, full-featured text
  784.   editor with which to create/edit ZIP main comments.
  785.  
  786.        Enter the ZIP file comment editor by pressing the F7 key.  The editor
  787.   screen will replace the ZIP viewer screen and any existing comment will
  788.   appear in the editor.  At this point you can begin editing the existing
  789.   comment or entering new comment text.  Reference to the many text editor
  790.   commands is available via the F1 (help) key.  This discussion will address
  791.   the main editor functions only.
  792.  
  793.        Note that there is an editor status line on line 2 of the display that
  794.   looks like this:
  795.  
  796.   FILENAME.TMP  Line: 1     Col: 1     2110/32766  Insert Smart Indent Wrap
  797.  
  798.   This line dynamically reports the status of the assigned file name, line and
  799.   column position of the cursor, used/available buffer space, insert mode
  800.   (insert or overwrite), indent mode, and whether word wrap is active.  If
  801.   word wrap is active, you can reformat entire paragraphs via the Ctrl+B
  802.   command.
  803.  
  804.        It is important to note that the editor is never automatically cleared
  805.   unless done so by a specific command or by returning all the way to the main
  806.   display level.  You may enter some text, press Esc to return to the ZIP file
  807.   viewer and return to the editor via the F7 key without losing any changes.
  808.   To manually clear the editor, press the F10 key.  Even when this is done, it
  809.   is not too late to restore the original ZIP comment, if one existed.  This
  810.   can be accomplished with the F9 key.  In fact, you can always restore the
  811.   original ZIP comment up until the time you use the F5 command in the ZIP
  812.   viewer to save all comments.
  813.  
  814.        ZCM also supports loading external text files into the comment editor
  815.   and it supports saving the text in the editor to a disk file.  To load a
  816.   file into the editor, press the F3 key.  ZCM will then prompt you (top line)
  817.   to enter a file specification.  If the file you wish to load is in the
  818.   currently active directory, just type in the file name and press Enter. If
  819.   not, you must enter the full DOS path name for the file as in:
  820.   F:\TEXTFILE\MYCOMM.ASC.  ZCM will then discard the text currently in editor
  821.   and load in the text from the specified file.
  822.  
  823.        It is important to note that the first time you enter the main ZIP
  824.   comment editor, ZCM assigns a file name to the editor even though the text
  825.   is from the existing ZIP comment.  This file name is built from the target
  826.   ZIP name and the default extension .TMP.  Thus, for a target file named
  827.   MYDATA.ZIP, the editor will have a file named MYDATA.TMP assigned.  Note
  828.  
  829.  
  830.  
  831.                                      - 13 -
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.   also that the current file name is displayed on line 2 of the display.  This
  839.   means that you can immediately save the contents of the ZIP file comment to
  840.   the default file name by pressing Ctrl+K+S or F2.  If you wish to save the
  841.   current editor contents and switch to a new file, press Ctrl+K+N.
  842.  
  843.        You may also mark text with the F7/Ctrl+K+B and F8/Ctrl+K+K keys and
  844.   then save the marked block of text to a file by pressing the Ctrl+K+W key.
  845.   Similarly, you can import a text file into a marked block by moving the
  846.   editor cursor to the desired position and pressing the Ctrl+K+R key.
  847.  
  848.        Other block commands include block move (Ctrl+K+V), block copy
  849.   (Ctrl+K+C), and block delete (Ctrl+K+Y).  You can also toggle the case from
  850.   upper to lower case and back with the Ctrl+O+O command.  Other powerful
  851.   editing commands are also available.
  852.  
  853.   12.3  Saving All Comments
  854.  
  855.        All comments can be saved to the target ZIP file by pressing the F5 key
  856.   while in the ZIP file viewer mode.  Since ZCM operates only that portion of
  857.   the ZIP file that contains the Central Directory, no permanent damage can
  858.   occur to the actual ZIP compressed files.  In the most unlikely event of
  859.   Central Directory corruption of ZCM, you can completely recover the ZIP file
  860.   through the use of PKZIP fix.  New-Ware has successfully truncated a ZIP
  861.   file at the beginning of the Central Directory and successfully restored the
  862.   file via PKZIPFIX.  All that is lost in this case are the file and ZIP main
  863.   comment.
  864.  
  865.  
  866.   13  Searching ZIP Files For Comments
  867.  
  868.  
  869.        There are two modes of comment search.  Both modes search all ZIP and
  870.   ZIP SFX files on the current drive.  The first mode, activated by the F7
  871.   key, searches for a user specified individual file comment.  The second
  872.   mode, activated by the F8 key, searches each ZIP main comment for a user-
  873.   specified target string.  When F7 or F8 is pressed, ZCM will first ask if
  874.   you desire a case-sensitive search.  If you answer Yes, then the upper case
  875.   characters are treated as different from lower case.  For example, an "F"
  876.   will not match an "f".  If you answer No, the case of both the target and
  877.   search strings will be ignored.  Note that a case sensitive search is faster
  878.   but more rigorous.
  879.  
  880.        If ZCM finds a match, a message will appear on the top line of the
  881.   display.  You will have the opportunity to [V]iew the ZIP/EXE file,
  882.   [C]ontinue the search, or [H]alt the search.  If you choose to view the
  883.   file, ZCM will do one of two things.  If you are searching for an individual
  884.   file comment (F7), you will be placed in the ZIP file view mode with the
  885.   cursor bar over the file name with the comment that matched the search
  886.  
  887.  
  888.  
  889.                                      - 14 -
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.   target.  If you are searching main ZIP comments, you will be placed in the
  897.   main comment editor with the cursor at the beginning of the matched string.
  898.  
  899.  
  900.   14  ZIP Main Comment Batch Mode
  901.  
  902.  
  903.        This functions permits you to add the currently configured default main
  904.   ZIP comment file to all tagged ZIP/EXE files.  Note that any existing
  905.   comments in the tagged files will be replaced by the text in the default
  906.   comment file.  Simple tag the files you wish to operate on and press the F9
  907.   key.
  908.  
  909.  
  910.   15  Editing The Default Main Comment
  911.  
  912.  
  913.        ZCM makes it easy to retrieve, edit, and retrieve the active default
  914.   main ZIP comment file.  This is the file that will be used for adding a
  915.   single main comment to a group of tagged ZIP/EXE files in the batch mode (F9
  916.   command).  Just press the F10 key and you will be placed immediately into
  917.   the main comment editor.  If the file (named in the configuration dialog)
  918.   does not exist, ZCM will create it, otherwise it will be loaded into the
  919.   editor.
  920.  
  921.  
  922.   16  List To File
  923.  
  924.  
  925.        The list to file function is activated by pressing Ctrl+L.  This
  926.   command acts upon tagged files and when you press Ctrl+L, you will be
  927.   prompted to enter a file name into which ZCM will place the listing.  ZCM
  928.   will create the file and process each tagged ZIP/EXE file.  The following
  929.   text is a sample of the text that is written to the specified file.  Note
  930.   that each file name is listed and any existing comments are also listed.
  931.   The main ZIP comment appears just after its file name and before the
  932.   compressed file listing.
  933.  
  934.   Created 02/27/1992 2:26 pm by ZIP CommentMaster
  935.   ----------------------------------------------------------------------------
  936.   C:\TEST\ONECLONE.ZIP
  937.  
  938.   Main ZIP comment test line.
  939.   One more line for test
  940.  
  941.   AM.BAK        this is #1
  942.   AMARCOPS.BAK  this is #2
  943.   AMARJOPS.BAK  this will be #3 and a bit longer
  944.  
  945.  
  946.  
  947.                                      - 15 -
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.   AMCHECK.BAK   123456789012334567890123456789012345678990
  955.   AMCOPY.BAK
  956.   AMDEC.BAK
  957.   AMEXTRA.BAK
  958.   AMFILES.BAK   this is later
  959.   AMINIT.BAK
  960.   AMLHAOPS.BAK
  961.   AMMAIN.BAK    and much later
  962.   AMPAKOPS.BAK
  963.   -------------------------------------------------------------------------
  964.   C:\TEST\TEST.ZIP
  965.  
  966.   ╔════════════════════════════════════════════════════════════╗
  967.   ║                   SUPER DUPER BBS NAME                     ║
  968.   ║     7 Nodes                                  1200/19200    ║
  969.   ╟────────────────────────────────────────────────────────────╢
  970.   ║         This file tested for virus and integrity on        ║
  971.   ║  8,000 files        10-10-1988  04:58 pm     Net Mail      ║
  972.   ╚════════════════════════════════════════════════════════════╝
  973.  
  974.      AMPATH.BAK    A comment line here for this file.
  975.      AMSETSYS.BAK  2nd file comment here
  976.  
  977.        The file created by ZCM is a straight text file that can be edited with
  978.   any text editor.
  979.  
  980.  
  981.   17  Editing Commands
  982.  
  983.  
  984.        ZCM employs a line editor for editing individual file comments and
  985.   configuration dialog text fields.  A full-screen text editor is employed to
  986.   edit main ZIP comments.  Both editor command sets are based upon the
  987.   venerable and popular WordStar command set.
  988.  
  989.        The ZCM context sensitive on-line help feature provides a summary of
  990.   the editor commands for referral during program operation.  In addition, the
  991.   ZCM distribution package contains a file named EDIT.CM which contains
  992.   command definitions for both editors.
  993.  
  994.  
  995.   18  Credits
  996.  
  997.  
  998.        PKWare Inc. holds copyright and patent rights to the computer programs
  999.   known as PKZIP, PKUNZIP, PKZIPFIX, and ZIP2EXE.   There just isn't any
  1000.   better file compression system in existence on this planet.
  1001.  
  1002.  
  1003.  
  1004.  
  1005.                                      - 16 -
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.        Once again, tribute is paid to Sammy Mitchell of Sem-Ware for the
  1013.   inestimable value of his QEDIT text editor.
  1014.  
  1015.        Thanks to the following:
  1016.  
  1017.             - Tom Kellen, Sysop of The Paradigm BBS [404-671-1581]
  1018.  
  1019.             - Chip North, Sysop of The Source BBS [310-371-3737]
  1020.  
  1021.             - TurboPower Software, source of Object Professional
  1022.  
  1023.   ----------------------------------------------------------------------------
  1024.  
  1025.   Copyright 1992, all rights reserved
  1026.  
  1027.   New-Ware
  1028.   8050 Camino Kiosco
  1029.   San Diego, CA 92122
  1030.  
  1031.  
  1032.  
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.  
  1062.  
  1063.                                      - 17 -
  1064.  
  1065.