                       Main ZCE window

ZCE has four main window areas.

The Top Banner lists the ZCE version, the current System Date and Time, 
the amount of Disk Space, Drive Letter and Volume Label of the specified 
drive and path, and also the Video Monitor type detected. 

Below the Top Banner is the file list window. Pick Box Commands  

The Bottom window lists the current comment text.  Text Editor Commands  

The Bottom Banner lists some of the possible commands for the current 
window. 

 On Line Help       Help Index       About ZCE 2.0  

[ZCE HELP INDEX]

File Commands      Comment Commands       ZCE Option Commands  
       Help               Edit               Status 
       Save               Copy               Display 
       New filespec      Write              Format  
       Import             Tag Current        Refresh  
       Volume Label       Tag All           Configuration  
       Dos Shell          Tag Empty 
       Rename            Search  
      Open Zip           Next Tagged  
       Unzip 
       Exit 

 Main Window Commands       Pull Down Menu           Trademarks 
 Command Line Options       Dialog Box Commands      Acknowledgements 
 About ZCE 2.0              Pick Box Commands 
 Command Summary            Full Screen Commands      
                           Text Editor Commands  



                        On Line Help System <F1>

This help system is context sensitive which means it will try to
provide help for the current program operation.  Help is available at
all times by pressing F1.  After reading help you return to the
program by pressing ESC or clicking the right mouse button.

Certain words within the help text may appear in different colors.
These highlighted words are links to other screens which provide
related information.

To view a linked screen, all you have to do is highlight the link you
are interested in and press RETURN.  There are several ways to highlight
a link.  You may use the cursor keys to move the highlight or you may
press the first letter of the link you want.  If there are several links
that start with the same first letter just keep pressing it until the
desired link is highlighted.  If you use a mouse just click on a link
name to select it and display the linked screen.

                                                                 PgDn...

This help system remembers the order in which you view the help screens
and allows you to retrace your steps by displaying previously viewed
screens.  To back up and view a previous screen you just press PgUp.
The program will remember the last 64 screens that were displayed.  On
the top right of the help window a small up arrow will be displayed if
there are any previous screens that may be viewed.

You may also see a small down arrow at the bottom right of the help
window.  This indicates that there is another screen that goes with the
current screen.  Just press PgDn to view it.  Clicking either arrow with
the mouse will display the desired screen.

                      Save Comments Command <F3>

The Save Comments command checks each file for comment changes.  If a
comment has changed a file size check is performed comparing the
original size with the current size to ensure against file corruption.
If the check passes the comment is saved, otherwise an error message is 
displayed and the comment is not saved.

Modifying the ZIP file while in the Dos Shell or Open Zip command are 
both possible causes for file size change.

 Help Index 

                 New File Specification Command<F4>

This command will pop up a dialog box for input.  After specifying the 
new Drive, Path and File specification press Enter or press Escape to 
abort.  If the entered filename or directory is invalid an error message 
will be displayed and you will be returned to this command to enter a 
valid file and directory specification. 

Examples:

   c:\dos\*.zip
   a:
   ..\wp\wp*.zip

 Dialog Box Commands 
 Help Index 

                        Import Commands <F6>

The Import command pops up a full screen Import Window.  The Import
process involves searching through file lists for names matching the
filenames read when ZCE was executed.  The Import defaults are read
from the ZCE.CFG file and may be edited using the configuration program.

The Comments File is the name of the file that will be searched for 
Comments.  The Comments file may be the name of a Zip file followed by a 
comma (,) and then by a filename.  If so the filename will be extracted 
from the Zip file and then used as the import Comments file.  i.e. 
BBS.ZIP,BBS.LST. 
 
The Edit/Auto field accepts only E or A as input.  E indicates manual
editing as comments are found and the same comment editor as in the
main ZCE window is used.  In Automatic mode the first match found is
used as the comment and the Comment Column is used to indicate the
column where the comment begins.  Only a single line is used for the
comment in Automatic mode.

                                                                 PgDn...

The Tagged/All field accepts T or A.  T indicates that only Tagged
filenames are used to while searching the Comments file.  Whereas the A 
indicates all filenames will be used in the search.

The Import Buffer Size indicates the numbers of lines read from the
Comments File at one time.  The higher the number the faster the
search because of fewer disk accesses.

If the Extension in Search is set to Yes the whole filename and extension 
are used as the search string.  If set to No, only the filename without 
extension is used as the search string.

 Full Screen Commands 
 Configuration 
 Import Window Commands 




                                                                  PgDn...

                         Import Window Commands

    <F1>  On Line Help.
    <F5>  Display a Pick Box of the currently defined import files.
          These files are defined using the configurationprogram 
          from the main ZCE window.
   <F10>  Start Import.
<Escape>  Exit Import and return to the main program.


 Pick Box Commands 
 Text Editor Commands 
 Import Text Editor Commands 
 Configuration 





                                                                  PgDn... 

                     Import Text Editor Commands

These commands are additional Text Editor Commands and only work while 
in Import command mode.

       <F10>  Abort Import.
<Ctrl-Enter>  Save this comment with the current filename.  If a
              comment already exists and is different a question box is
              displayed asking which comment to use.
    <Escape>  Skip this Comment and continue searching the Import 
              Comments file.

 Text Editor Commands  
 Help Index 

                     Volume Label Command <F7>

If the current or selected drive is A: or B: a dialog box will appear 
requesting a new Volume Label.  Only 11 characters will be allowed.  Only 
characters that are valid for Volume Labels may be entered.  If Escape is 
pressed the Volume Label will not be changed.

 Dialog Box Commands 
 Help Index 


                      Dos Shell Command <F8>

The Dos Shell Command spawns another COMMAND.COM leaving ZCE in
memory.  About 256K is used by ZCE.  If the system crashes or is
re-booted while in the Dos Shell, all edited Comments that have not
been saved will be lost.

If you Shell to Dos and modify a Zip file size in any way or delete
files from the Zip file using the Open Zip Command, the comment
location in the file will be altered and ZCE will display an error
message when the Comment is saved.  At this point the modified comment
can never be saved.  Make sure you write out any modified Comments
first!  This will update Comment locations in ZCE and allow correct
comment editing and update.

 Help Index 

                   Rename Filename <Ctrl+F4>

This command allows you to change the current filename.  A dialog box
will appear for new filename input.  Only characters valid for
filenames will be allowed.  If successful the filename will be
changed.  An error message will be displayed if the rename was not
successful.  Pressing Escape will abort this command and will not
change the filename.

 Help Index 

                   Open Zip Command <Ctrl+Enter>

This command will scan the highlighted Zip file and display a Pick Box
listing of any files.  The file listing will show: Filename,
Compressed Size, Original Size, Date, Time, Compression Method and
Path.  If the path is to long to fit on the display the original and
compressed file sizes will be removed from the display list.

If enter is then pressed on a highlighted file Zce will shell to dos,
decompress and view the file.  The Environment variable ZCEWORK or Zip
Extraction Dir Variable may be used to specify a valid dos drive and 
directory to create the temporary file.  This allows ZCE to use an 
alternate drive or ramdisk.

The Zip, Unzip and File Viewer Variables will be used to uncompress
and view the file.  See  Configuration  program.  All of the programs 
must be in a directory in the current Dos path.  An error will be 
displayed if the directory or file could not be written or removed or if 
and of the Zip, Unzip or File Viewer programs could not be found in the 
                                                                  PgDn... 

Dos path.  When in the Dos Shell there must be enough memory to execute
any of these programs.

Recursive Zip viewing is not supported.  This means that selecting a
Zip file inside a Zip file will not list a second list but only
extract and display the Zip file in binary.

Open Zip Commands:

      <F1>  On Line Help
       <E>  Extract highlighted file to current directory
  <Ctrl-E>  Extract tagged files to current directory
       <D>  Delete highlighted file from current Zip file
  <Ctrl+D>  Delete tagged files from current Zip file
<SpaceBar>  Tag/Untag highlighted file




                                                                  PgDn...

       <S>  Sort by Date, Extension, Filename or Path.

Right Mouse    Tag/Untag current file
Left Mouse     Exit View Zip

Any files with the same name that are created or extracted will be
overwritten.

 Configuration 
 Pick Box Commands 
 Command Line Options 
 Help Index 

               Unzip Current Filename Command <Ctrl+E>

This command will unzip the current filename into the current or
specified directory.  A question box will appear asking whether to
unzip into the current directory or specify a different directory.  If
current is selected the filename is then unzipped into the
current directory.  If specify is selected a dialog box will appear
for directory information.  The filename will be unzipped into the 
specified directory if valid.  If the specified directory does not exist 
an attempt will be made to create it.  If problems occur creating the 
directory or writing the files an error message
will appear.

 Dialog Box Commands  
 Help Index 



                       Exit ZCE<Escape>

If all comments have not been saved a question box will appear asking 
whether to abort or continue to exit.  If abort is selected you will 
returned to ZCE.  If continue is selected a question box will then appear 
asking if you want to exit ZCE.  Selecting YES will exit whereas 
selecting NO will return to ZCE. 

 Help Index 

                          Edit Command <Enter>

This command simply switches into the text editor for the current
filename.  If the comment could not be read or is corrupted, this command
will be disabled and a message indicating the comment is invalid will be
displayed in the editor window.

 Help Index 

             Copy Comment from Another File <Ctrl-F7>

If more than one file comment is listed in the main ZCE window, ZCE
will list the current filenames in a Pick Box for selection.  The
selected filenames comment is then copied into the comment for the
current filename.  If a comment already exists for the current
filename, a question box appears asking when to use the current or
the new comment.

 Pick Box Commands 
 Help Index 

               Write Filenames and Comments <Ctrl-F3>

This command will write the filenames and Comments to a user specified
file.  A question box appears asking whether to write all or tagged
filenames and comments to the file.  A dialog box appears requesting
the file to write the filenames and comments.  If the file exists or
if problems occurred while writing the data to the file an error message
will be displayed.

 Dialog Box Commands 
 Help Index 

                        Tag Commands

The tag commands are used by the import and Write and Open Zip commands.

<Spacebar>  Tag Current Filename
 <Ctrl-F9>  Toggle Tag on All Filenames
 <Ctrl+F2>  Tag Filenames with empty comments
      <F2>  Move Highlight bar to next tagged Filename

 Help Index 

                    Search Command <Ctrl-S>

The Search command allows you to find text within your comments.  A
dialog box will allow input of the search string.  If the search
string is found the highlight bar will move to the filename and the
comment will be displayed in the text editor window.

 Dialog Box Commands 
 Help Index 

                  ZCE Status Screen <Ctrl-F1>

This command will display internal ZCE variables.  This command is
mainly used for development of ZCE.  I am documenting this just in
case you run into it.  It also displays the location of the ZCE.CFG
file current being used by ZCE.

 Help Index 

                     Display Command <Ctrl-F5>

This command toggles between 25, 43 and 50 line screen modes depending
upon the graphics card detected.  CGA supports only 25 line mode.  EGA
supports 25 and 43 line modes.  VGA supports 25 and 50 line modes.

 Help Index 

                  Format Command <Ctrl-F6>

The Format command changes the contents of the single line listing in
the main ZCE Pick Box Window.  Currently there are 3 formats.  The
shipped default is format 1 which lists the filename and about 65
characters of the comment with control characters removed.  Executing
this command increments the format to to which lists the filename,
filesize, filedate, filetime and comment.  Format 3 lists only the
filename.  The default may be changed using the Configuration program.

 Configuration 
 Help Index 

                     Refresh Command <F5>

This command toggles the text editor refresh.  ZCE default is on.
When you scroll through different files in the main ZCE window the
text editor listing at the bottom of the screen updates for each
filename.  If you toggle Refresh the text editor will not refresh when
scrolling through the file listing.  This is handy if you have read in
many files and comments.

 Help Index 

                    Configuration Command <Ctrl-F8>

This command shells to Dos and executes the program ZCECFG.EXE.  There
must be enough Dos memory to execute ZCE and ZCECFG at the same time.
If an error occurs, execute ZCECFG.EXE outside of ZCE.  ZCECFG is a
configuration program for ZCE color and variable defaults.  ZCE will
search the current and all directories in the Dos path for the
configuration file ZCE.CFG.  ZCECFG reads and writes ZCE.CFG.  When
control is returned to ZCE the ZCE.CFG file is read and updates
applied to ZCE.  See ZCECFG on line help for more information about
the individual color and variable definitions.

 Help Index 

                        Pull Down Menu Commands <F10>

 <Down-Arrow>  "Pulls down" a window if one is not already down.
               Otherwise, it moves the highlight bar down one selection
               within the window.

   <up-Arrow>  Moves the selection bar up one item within a window. If a
               window is not pulled down, this key has no function.

 <Left-Arrow>  If a window is not pulled down, the selection bar is
               moved to the next bar menu item to the left. If a window
               is pulled down, the window under the next bar menu item
               on the left is pulled down.

<Right-Arrow>  If a window is not pulled down, the selection bar is
               moved to the next bar menu item to the right. If a window
               is pulled down, the window under the next bar menu item
               on the right is pulled down.

                                                                 PgDn... 

<Alt-Highlight-Key>  If no windows are pulled down, holding down the
                     <Alt> key while pressing a key highlighted on the
                     bar menu will pull down the window under that item.

<Highlight-Key>  If a window is pulled down, pressing a highlighted key
                 will select that item.

<Escape>       If a window is pulled down, it will be erased and only
               the bar menu and the description line will be active.  If
               a window is not pulled down the pull down menu is exited.
<Enter>        If a window is not currently pulled down, the window
               under the highlight bar menu item will be displayed.  If
               a window is pulled down, the highlighted item within the
               window will be selected and the command will be executed.

The Pull Down menu fully supports the Mouse.  Clicking the left
button on a bar menu item will pull down the window for that item.
Clicking the left button on an item within a window will select that
item and execute that command.  Clicking the right mouse button will
have the same effect as pressing the escape key.

                      Text Editor Commands

         <F1>  On line help.
 <Ctrl-Enter>  Save current Comment.
    <Ctrl-F2>  Restore comment to original value.
    <Ctrl-F5>  Switch editor to full screen mode.  The editor will be
               reset when this comment is saved or you exit.
    <Ctrl-F6>  Import file list into comment.  This is the same list
               that is displayed using the Open Zip command.  The list is
               appended to the end of the buffer if there is space.
    <Ctrl-F8>  Shell to dos and call external editor.  ZCE uses the
               filename and editor variables defined using the
               configuration program.
   <Up-Arrow>  Move up one line.  Or <Ctrl-P>
 <Down-Arrow>  Move down one line.  Or <Ctrl-N>
<Right-Arrow>  Move right one character.  Or <Ctrl-F>
 <Left-Arrow>  Move left one character.  Or <Ctrl-B>
       <PgUp>  Move up one page.  Or <Alt-V>
       <PgDn>  Move down one page.  Or <Ctrl-V>
                                                                 PgDn...


       <Home>  If not on the left most column of the window, move to that
               column, else move to the beginning of the current
               line. Or Ctrl-A>
        <End>  Move to the end of the current line.  Or <Ctrl-E>
     <Insert>  Toggle between insert and overstrike mode.
        <Del>  Delete the character at the cursor position.  Or <Ctrl-D> 
  <Backspace>  Delete the character to the left of the cursor position.
        <Tab>  Move one tab stop to the right.
 <Ctrl-Right>  Move right one word.
  <Ctrl-left>  Move left one word.
  <Ctrl-Home>  Move to the first line of text.
   <Ctrl-End>  Move to the last line of text.
     <Ctrl-O>  Insert a line at the current row.
     <Ctrl-T>  Delete the word that the cursor is on.  Or <Alt-D>
     <Ctrl-K>  Delete the current line.
      <Alt-K>  Delete from the current line to the end of buffer.
     <Escape>  Exit or Quit.  If the comment has been modified a question
               box will ask whether to save or discard the edits.  ZCE 
               may reformat text while reading if the text is wider than 
                                                                 PgDn... 

the word wrap width and may cause the modified text question listed above 
to be presented even if you do not make any edits.

The mouse can be used to position the cursor within the window by
clicking the left button at the desired position.  It can be used to
scroll through the text by clicking the left button on the scroll bar.
Clicking the right button will have the same effect as pressing
escape.

 Import Text Editor Commands 
 Help Index 

                          Dialog Box Commands

      <Enter>  Accept the current input.
 <Left-Arrow>  Move left one character.
<Right-Arrow>  Move right one character.
       <Home>  Move to the beginning of the work string.
        <End>  Move to the end of the work string.
     <Insert>  Toggle between insert and overstrike mode.
        <Del>  Delete the character under the cursor.  The characters to 
               the right of the cursor are shifted left one position.
  <Backspace>  Delete the character to the left of the cursor.  The 
               characters from the cursor position to the end of the 
               input string are shifted left. 
 <Ctrl-Right>  Move right one word.
  <Ctrl-Left>  Move left one word.
   <Ctrl-End>  Delete all characters from the cursor position to the end 
               of the field. 
     <Escape>  Abort Input. 

 Help Index 

                      Pick Box Commands

    <Home>  Moves to the first file in the list.
     <End>  Moves to the last file in the list.
    <PgUp>  If the highlight bar is at the top of the box, the previous 
            "group" of files will be displayed and the bar will remain 
            at the top of the box. If the highlight bar is not at the 
            top of the box, it will move to the top.
    <PgDn>  If the highlight bar is at the bottom of the box, the next 
            "group" of files will be displayed and the bar will remain 
            positioned at the bottom of the box.  If the highlight bar 
            is not currently at the bottom of the box, it will move to 
            the bottom.
<Up Arrow>  Moves the highlight bar up one file.  If the bar is at the 
            top of the top of the box, the previous "group" of files 
            will be displayed and the bar positioned at the bottom.
<Dn Arrow>  Moves the highlight bar down one file.  If the bar is at the 
            bottom of the top of the box, the next "group" of files will 
            be displayed and the bar positioned at the top.
<SpaceBar>  Tags or selects the currently highlighted file.  Pressing 

            the spacebar a second time will untag the highlighted file. 

The Mouse can be used to scroll through the list of files in the box by 
clicking the left button on the scroll bar.  Clicking the left button on 
any file within the box operates the the same as the space bar if tagging 
is available.  Clicking the right button will operate the same as 
pressing the escape key.

 Help Index 

                 Full Screen Input Commands

       <PgUp>  Move to the first field on the screen.
       <PgDn>  Move to the last field on the screen.
   <Up Arrow>  Move to up one field.
 <Down Arrow>  Move down one field.
 <Left Arrow>  Moves to the left one character.
<Right Arrow>  Moves to the right one character.
       <Home>  Move to the beginning of the field.
        <End>  Move to the end of the field.
     <Insert>  Toggles between insert and overstrike modes.
        <Del>  Deletes the character under the cursor.  The characters
               to the right of the cursor are shifted left one
               position.
  <Backspace>  Deletes the character to the left of the cursor.  The
               characters from the cursor position to the end of the
               input string are shifted left according to the same
               rules as the Del key.
 <Ctrl-Right>  Moves right one word.
  <Ctrl-Left>  Moves left one word.                              PgDn...


   <Ctrl-End>  Delete all characters from the cursor position to the
               end of the field.
<Enter / Tab>  Move to the next field.
  <Shift-Tab>  Move back one field.
     <Escape>  Exit or Quit.

If you are using a mouse, clicking the left button on a field will
move you to that position in the field.

 Help Index 

                           About ZCE 2.0

ZCE or Zip Comment Editor was created to make it easy to read, edit
and write Zip file comments.  ZCE scans and entire directory of Zip
files and reads the comment from each one.  After the filenames and
comments are displayed a full screen editor allows you to edit each
comment up to 32K in size.  ZCE lets you import comments from ascii
BBS listings and edit them on the fly.  ZCE can also Open and display the 
files inside a Zip file and allow you to view, delete or extract files.

Here is a list of ZCE's features:

Built in Full Screen Text Editor
External Editor support
CGA/EGA/VGA 25/43/50 line Color and Monochrome support
Complete Configuration of Variables and Colors
On Line Hypertext Help
Open Zip file and view internal file list
Import Zip comments from external ascii BBS file lists
                                                                 PgDn...


Copy Comment from another file
Modify Floppy Volume Label
Shell to Dos
Write List of Filenames and Comments to a File
Rename a File
Extract Single or Tagged files
Unzip individual files or entire Zip into specified directory
Full Mouse support
Pull Down Menus

 Help Index 

                          Command Summary

Main Zce Commands
   File Commands           Comment Commands       ZCE Option Commands
        <F1>  Help             <Enter>  Edit          <Ctrl-F1>  Status
        <F3>  Save           <Ctrl-F7>  Copy          <Ctrl-F5>  Display
        <F4>  New Filespec   <Ctrl-F3>  Write         <Ctrl-F6>  Format
        <F6>  Import           <Space>  Tag Current        <F5>  Refresh
        <F7>  Volume         <Ctrl-F9>  Tag All       <Ctrl-F8>  Config
        <F8>  Dos Shell      <Ctrl-F2>  Tag Empty
   <Ctrl-F4>  Rename          <Ctrl-S>  Search
<Ctrl-Enter>  Open Zip            <F2>  Next Tagged
    <Ctrl-E>  Unzip
    <Escape>  Exit

Import Commands
    <F1>  On Line Help.
    <F5>  Display a Pick Box of the currently defined import files.
   <F10>  Start Import.
<Escape>  Exit Import and return to the main program.            PgDn...

Import Text Editor Commands
       <F10>  Abort Import.
<Ctrl-Enter>  Save this comment with the current filename.
    <Escape>  Skip this Comment and continue searching.

Open Zip Commands
      <F1>  On Line Help
       <E>  Extract highlighted file to current directory
  <Ctrl-E>  Extract tagged files to current directory
       <D>  Delete highlighted file from current Zip file
  <Ctrl+D>  Delete tagged files from current Zip file
<SpaceBar>  Tag/Untag highlighted file
       <S>  Sort by Date, Extension, Filename or Path.

Text Editor Commands
         <F1>  On line help.
 <Ctrl-Enter>  Save current Comment.
    <Ctrl-F2>  Restore comment to original value.
    <Ctrl-F5>  Switch editor to full screen mode.
    <Ctrl-F6>  Import file list into comment.          Help Index 

                       Command Line Options

Zip Comment Editor Syntax: ZCE <drive:\path\filenames> [/options]"

Drive must be a Valid Dos Drive, i.e. A: or B: or C:
Path must be in Valid Dos syntax, i.e. \dos\ or \wp50\letters\
Filenames may contain Wildcards, i.e. *.ZIP or H?

Zce Command Line Options:

        /? = This Help Screen
/43 or /50 = Display 43/50 lines on EGA or VGA only
       /25 = Force Display 25 lines
       /NC = No Clock Display
        /L = Lower Case Filenames
       /NS = No Save and Restore Screen

These options may be entered to the ZCE environment variable.  i.e.
set ZCE=/43 /NC /L will start ZCE in 43 or 50 line mode without clock
and filenames will be displayed in lower case.         Help Index 


                               Trademarks

IBM-PC, IBM-XT,  IBM-AT are trademarks of  International Business
Machines Corporation, Boca Roton, Florida.

Pkzip and Pkunzip are trademarks of PKware Inc.
7032 Ardara Avenue
Glendale, WI 53209 (414) 352-3670

List.com is a trademark of The Buerg Utilities
Buerg Software 139 White Oak Circle
Petaluma, CA 94952
(707) 778-1811 between 10 am and 5 pm Pacific time.

Qedit Advanced is a trademark of SemWare
Suite C3A
4343 Shallowford Road
Marietta, GA 30062-5022 (404) 641-9002

                                                          Help Index 


                          Acknowledgements

ZCE  and ZCECFG were written  in basic using  the Microsoft Basic
Professional  Development System  7.1 with  the following  add on
libraries:

MicroHelp Muscle
4359 Shallowford Industrial Parkway
Marietta, Georgia 30066-1135 (404) 516-0898

PBCLONE (Pro Bas Clone) by Thomas G. Hanlin III
3544 E.  Southern Ave.  #104
Mesa, AZ 85204

Simply Help, hypertext help system by Robert E. Pitcher
SimpleWare
34 Earle St.
G.F.- Windsor, NF
Canada  A2B 1E9
                                                                 PgDn... 
Quick  Basic  archive file  viewer  for MS-DOS  machines  by Dick
Dennison, 914-374-3903 24 hrs


The QBNews International QuickBasic Electronics Newsletter.
Clearware Computing
P.O. Box 507 Sandy Hook, CT 06482
QBNews is available for download from Microhelp BUG BBS
(404) 552-0567 or Crescent Software BBS (203) 426-5958.

 Help Index 

