































                                 ListFile Release 4.0









1. Introduction                                          

2. File Menu                                             
     2.1. Print...                                       
          2.1.1. Open a File Dialog Box                  
               2.1.1.1. Name                             
               2.1.1.2. Files                            
     2.2. View...                                        
          2.2.1. Open a File Dialog Box                  
               2.2.1.1. Name                             
               2.2.1.2. Files                            
          2.2.2. File viewer                             
     2.3. Edit...                                        
          2.3.1. Open a File Dialog Box                  
               2.3.1.1. Name                             
               2.3.1.2. Files                            
          2.3.2. File Editor                             
               2.3.2.1. File position                    
               2.3.2.2. Change Indicator                 
               2.3.2.3. Selecting Text                   
     2.4. New                                            
     2.5. Save                                           
     2.6. Save As...                                     
     2.7. Upload...                                      
     2.8. Download...                                    
     2.9. Change Dir...                                  
          2.9.1. Change Directory Dialog                 
     2.10. About...                                      
     2.11. Exit                                          

3. Edit Menu                                             
     3.1. Undo                                           
     3.2. Cut                                            
     3.3. Copy                                           
     3.4. Paste                                          
     3.5. Show Clipboard                                 
     3.6. Clear                                          

4. Search Menu                                           
     4.1. Find...                                        
     4.2. Replace...                                     
     4.3. Search Again                                   

5. Windows Menu                                          
     5.1. Resize/Move                                    
     5.2. Zoom                                           
     5.3. Next                                           
     5.4. Close                                          
     5.5. Tile                                           
     5.6. Cascade                                        

6. Accessories Menu                                      
     6.1. Envelope                                       
     6.2. Addresses                                      
     6.3. DOS Shell                                      
     6.4. Calendar                                       
     6.5. Calculator                                     

7. Options Menu                                          
     7.1. Video Mode                                     
     7.2. Mouse...                                       
     7.3. Page Format...                                 
          7.3.1. Side By Side                            
          7.3.2. Vertical Numbered                       
          7.3.3. Portrait Un-numbered                    
          7.3.4. Horizontal Numbered                     
          7.3.5. Landscape Un-numbered                   
          7.3.6. Normal 66 line                          
          7.3.7. Carriage Control                        

8. Command Line Options                                  

9. Using ListFile on a network                           

10. Mouse Techniques                                     

11. SAA/CUA                                              
     11.1. Dialog Boxes                                  
     11.2. Buttons                                       
     11.3. Radio Buttons ( ) ( )                         
     11.4. Check Boxes [X]                               
     11.5. Entry Fields                                  
     11.6. History Fields                                
     11.7. Windows                                       
     11.8. Icons                                         
          11.8.1. Close                                  
          11.8.2. Zoom                                   
          11.8.3. Resize                                 
     11.9. Scroll Bar                                    
     11.10. Slider                                       
     11.11. Title Bar                                    

12. Licensing                                            









 Introduction

     ListFile   is  designed  to  work  with  HP  laser  printers   and
     compatibles.  It  provides several ways of formatting  ASCII  text
     files  to decrease the amount of paper required. New with  release
     4.0,  there  are functions for creating editing and viewing  these
     files  as  well as some accessories to help reduce the  amount  of
     times that you need to exit the program.

     This release of ListFile provides the following functions:

                    File Printing
                    File Viewing
                    File Editing
                    File Upload to Mainframe
                    File Download from Mainframe
                    Envelope Printing
                    Envelope Database
                    Calculator
                    Calendar
                    DOS Shell
                    Mouse Support
                    SAA/CUA Environment

     This  version  makes extensive use of the mouse, and  has  several
     options  for  use  from  the  DOS command  line.  Network  use  is
     supported for individual customization and data files.









 File Menu

     The  File  menu offers choices for viewing, editing, printing  and
     transfering files, changing directories, and exiting the program.

 Print...

     This  selection allows you to print text files. Each file will  be
     printed  in  the default format unless you change this  using  the
     OPTIONS PAGE FORMAT selection. If you have been editing or viewing
     a  file,  the  most recent file will be displayed as the  default.
     Select  YES  to print it, NO to select another file or  CANCEL  to
     abandon  the  printing completely. Since the print function  reads
     the  file from disk, it will not contain any changes you have made
     using the editor unless you save it first.

   Open a File Dialog Box

     The  Open a File dialog box contains an input box, a file list,  a
     file  information  panel, the standard button  Cancel,  one  other
     action  button  Open, plus a history list that's attached  to  the
     Name input box

      Name
     The  Name  input box is where you enter the name of  the  file  to
     load, or the file-name mask to use as a filter for the Files  list
     box (for example, *.*).

      Files
     The  Files  list  box  lists the names of  files  in  the  current
     directory  that  match the file-name mask in the Name  input  box,
     plus   the  parent  directory  (the  ..  in  the  list)  and   all
     subdirectories  (beginning with \). Selecting the  directory  will
     change  the display to the files in that directory, but the change
     is  not  permanent. To change permanently use the Change Directory
     The  File information panel shows the path name, file name,  date,
     time,  and  size of the selected file. None of the items  on  this
     information panel are selectable.

     The  Open  button opens a file and places the selected file  in  a
     window or sends it to the printer.

     If  you  choose Cancel, nothing changes and no action occurs,  and
     the dialog box is put away. (Esc always cancels a dialog box, even
     if a Cancel button does not appear.)

     In  the  Open  a  File dialog box, if you choose the  Open  button
     ListFile opens a new file and places the selected file in a window
     or sends it to the printer depending on your current function.

 View...

     The  Open  command displays the Open a File dialog  box.  In  this
     dialog  box  you select the text file you want browse  in  a  file
     viewer. The Open a File dialog box contains: an input box  with  a
     history  list,  a list box to browse the directory,  the  standard
     Cancel  button, open action button and an information  panel  that
     describes the selected file

   Open a File Dialog Box

     The  Open a File dialog box contains an input box, a file list,  a
     file  information  panel, the standard button  Cancel,  one  other
     action  button  Open, plus a history list that's attached  to  the
     Name input box

      Name
     The  Name  input box is where you enter the name of  the  file  to
     load, or the file-name mask to use as a filter for the Files  list
     box (for example, *.*).

      Files
     The  Files  list  box  lists the names of  files  in  the  current
     directory  that  match the file-name mask in the Name  input  box,
     plus   the  parent  directory  (the  ..  in  the  list)  and   all
     subdirectories  (beginning with \). Selecting the  directory  will
     change  the display to the files in that directory, but the change
     is  not  permanent. To change permanently use the Change Directory
     The  File information panel shows the path name, file name,  date,
     time,  and  size of the selected file. None of the items  on  this
     information panel are selectable.

     The  Open  button opens a file and places the selected file  in  a
     window or sends it to the printer.

     If  you  choose Cancel, nothing changes and no action occurs,  and
     the dialog box is put away. (Esc always cancels a dialog box, even
     if a Cancel button does not appear.)

     In  the  Open  a  File dialog box, if you choose the  Open  button
     ListFile opens a new file and places the selected file in a window
     or sends it to the printer depending on your current function.

   File viewer

     A  file viewer views the contents of a text file. You can use  the
     arrow  keys  to move about in the file. A file is loaded  via  the
     File View menu item. This option does not allow you to change  the
     contents of the file. In order to change a file use the File  Edit
     command.  Viewer windows can be distinguished from Editor  windows
     by  their different text color. Keys on the cursor pad operate  as
     follows, with the mouse equivalents after:

     Up      Move up one line           Click on up arrow
     Down    Move down one line         Click on down arrow
     Right   Move right one column      Click on right arrow
     Left    Move left one column       Click on left arrow
     PgUp     Move one page up           Click scroll bar above  slider
     mark
     PgDn     Move one page down         Click scroll bar below  slider
     mark
     Home    View right most column of the file
     End     View left most column of the file
     Ctrl-PgUp                           View top of file  Drag  slider
     mark to top of scroll bar
     Ctrl-PgDn                           View bottom of file.      Drag
     slider mark to bottom of scroll bar

     File  viewers can be resized and moved using the Windows  menu  or
     the mouse.

 Edit...

   Open a File Dialog Box

     The  Open a File dialog box contains an input box, a file list,  a
     file  information  panel, the standard button  Cancel,  one  other
     action  button  Open, plus a history list that's attached  to  the
     Name input box

      Name
     The  Name  input box is where you enter the name of  the  file  to
     load, or the file-name mask to use as a filter for the Files  list
     box (for example, *.*).

      Files
     The  Files  list  box  lists the names of  files  in  the  current
     directory  that  match the file-name mask in the Name  input  box,
     plus   the  parent  directory  (the  ..  in  the  list)  and   all
     subdirectories  (beginning with \). Selecting the  directory  will
     change  the display to the files in that directory, but the change
     is  not  permanent. To change permanently use the Change Directory
     The  File information panel shows the path name, file name,  date,
     time,  and  size of the selected file. None of the items  on  this
     information panel are selectable.

     The  Open  button opens a file and places the selected file  in  a
     window or sends it to the printer.

     If  you  choose Cancel, nothing changes and no action occurs,  and
     the dialog box is put away. (Esc always cancels a dialog box, even
     if a Cancel button does not appear.)

     In  the  Open  a  File dialog box, if you choose the  Open  button
     ListFile opens a new file and places the selected file in a window
     or sends it to the printer depending on your current function.

   File Editor

     A  file  Editor allows you to change the contents of a text  file.
     You  may  load multiple files in seperate windows using  the  File
     Edit  menu item. During the edit session you may copy text to  the
     clipboard  and paste it into other editing windows. If  you  later
     choose  to  print a file you have been editing you must  save  the
     file  first  or  the changes will not show in the printed  output.
     Editor  windows can be distinguished from viewers by the different
     window  color and the file position information displayed  at  the
     bottom  of the window. Keys on the cursor pad operate as  follows,
     with the mouse equivalents after:

     Up      Move up one line           Click on up arrow
     Down    Move down one line         Click on down arrow
     Right   Move right one column      Click on right arrow
     Left    Move left one column       Click on left arrow
     PgUp     Move one page up           Click scroll bar above  slider
     mark
     PgDn     Move one page down         Click scroll bar below  slider
     mark
     Home    View right most column of the file
     End     View left most column of the file
     Ctrl-PgUp                           View top of file  Drag  slider
     mark to top of scroll bar
     Ctrl-PgDn                           View bottom of file.      Drag
     slider mark to bottom of scroll bar

     To  highlight words or lines hold the shift key and use the cursor
     keys or drag the mouse while holding left button down. Editors can
     be resized and moved using the Windows menu or the mouse.

      File position
     The  bottom  frame  of  the  window  contains  a  row  and  column
     indicator. This is two numbers that tell you the current  position
     of the cursor in the file.

      Change Indicator
     To  the  left of the file position is a change indicator. This  is
     the  character * which appears only if you have changed  something
     in the file.

      Selecting Text
     You may select text to copy, delete, or move by using the mouse or
     keyboard.  With  the mouse, move the cursor to the  start  of  the
     text, and drag the cursor to a point past the end of the text  you
     want,  then  release  the  button.  The  selected  text  will   be
     highlighted. With the keyboard, move to the start with the  cursor
     keys,  hold the shift key and use the cursor to move the highlight
     over  the  text  you  want, then release the shift  key.  You  may
     highlight  an  entire line by double clicking on it,  and  several
     lines  may  be  highlighted by holding the second click  down  and
     dragging the mouse up or down. After text is highlighted  you  may
     cut or copy it to the clipboard.

 New

     You  may  open an Editor window and create a new text  file  using
     this option. An empty editor window is opened.

 Save

     If  you have made changes to a file use this option to save  them.
     The original file will be overwritten with your changes. If you do
     not want to overwrite the original, use the Save as... option.

 Save As...

     This  option  allows you to save your changes  under  a  new  name
     rather than overwrite the original file.

 Upload...

     A  file may be transferred to the mainframe provided you have  the
     program  SEND.COM installed in a directory that appears  somewhere
     in  your  PATH  statement in the AUTOEXEC.BAT  file.  The  program
     SEND.COM  is  provided  with  your  mainframe  terminal  emulation
     software. You will also need to be connected to the mainframe with
     a  3270 type adapter board. If the option appears disabled on your
     menu,  then ListFile was unable to find it. You must also  have  a
     mainframe TSO session active and be at the TSO READY prompt.

     When you choose this option, you will be prompted for the name  of
     the  file  you wish to transfer from the PC and the  name  of  the
     mainframe file you wish to create. Do not include any quotes,  but
     supply  the full DSN including the high level qualifier  when  you
     enter  the  mainframe file name. You will also need to select  the
     mainframe  session  window that your TSO  session  is  active  in.
     Select  1 if TSO is the first mainframe session window you started
     and 2 if it is the second.

     If  the transfer times out you are either not logged on to TSO  at
     the  ready  prompt or you selected the wrong session window.  When
     the  transfer is finished you will have to hit enter to return  to
     ListFile. This allows you to view any error messages generated  by
     the transfer. See File Download also.

 Download...

     A  file  may be received from the mainframe provided you have  the
     program   RECEIVE.COM  installed  in  a  directory  that   appears
     somewhere  in  your PATH statement in the AUTOEXEC.BAT  file.  The
     program  RECEIVE.COM  is  provided with  your  mainframe  terminal
     emulation  software.  You will also need to be  connected  to  the
     mainframe  with  a 3270 type adapter board. If the option  appears
     disabled  on your menu, then ListFile was unable to find  it.  You
     must  also have a mainframe TSO session active and be at  the  TSO
     READY prompt.

     When you choose this option, you will be prompted for the name  of
     the  file you wish to receive from the mainframe and the  name  of
     the  PC  file  you wish to create. Do not include any quotes,  but
     supply  the full DSN including the high level qualifier  when  you
     enter  the  mainframe file name. You will also need to select  the
     mainframe  session  window that your TSO  session  is  active  in.
     Select  1 if TSO is the first mainframe session window you started
     and 2 if it is the second.

     If  the transfer times out you are either not logged on to TSO  at
     the  ready  prompt or you selected the wrong session window.  When
     the  Receive is finished you will have to hit enter to  return  to
     ListFile. This allows you to view any error messages generated  by
     the receive. See File Upload also.

 Change Dir...

     File  Change  Dir brings up the Change Directory  dialog  box,  in
     which you can change the current directory.

   Change Directory Dialog

     The  Change Directory dialog box consists of an input box, a  list
     box,  the  standard  OK and Help buttons, and  two  other  buttons
     (Chdir and Revert).

     The  Directory Name input box is where you type in the path of the
     new directory. The Directory Tree list box enables you to navigate
     directories  by  using the selecting bar and  pressing  Enter.  If
     you're  using  the  keyboard, press Enter  to  make  the  selected
     directory be the current directory, then choose OK or press Esc to
     exit  the dialog box. Choosing Drives displays a list of the  disk
     drives  available. Choosing a drive letter will display  the  root
     directory of that drive. Choosing a directory will display all its
     subdirectories.

     The  Chdir  button  changes  the  current  directory  once  you've
     selected or typed in a directory name. The Revert button goes back
     to  the previous directory, as long as you haven't yet exited  the
     dialog box.

 About...

     This  option displays some really important information about your
     program  and version number. It is important for everyone to  view
     this  at  least  once.  The shareware version  will  display  this
     information each time you exit the program press enter  or  escape
     to remove the dialog. If you register your copy you will be sent a
     version without the ending nag screen.

 Exit

     The Exit command terminates this program.
 








 Edit Menu

     Commands  for  use in the editor window are contained  under  this
     main menu entry.

 Undo

     Many  editor commands can be undone if you have inadvertently done
     something such as delete text. Only the most recent command may be
     undone.

 Cut

     Highlighted  text  in  the edit window will be  deleted  from  the
     editor  and placed on the clipboard replacing the current contents
     of the clipboard.

 Copy

     Text  that  is  highlighted in the editor will be  copied  to  the
     clipboard  replacing the current contents of  the  clipboard.  The
     contents of the editor remain unaffected.

 Paste

     The  contents  of the clipboard will be inserted  at  the  current
     cursor location.

 Show Clipboard

     The  clipboard holds text that was selected during an edit  sesion
     and  either cut or copied. This text can be viewed using the  EDIT
     Show  clipboard selection. You may also save this text to  a  file
     using  the Save as command. The clipboard window behaves the  same
     as any Editor type window.

 Clear

     Highlighted text in the edit window will be deleted but not placed
     on the clipboard.









 Search Menu

     When  you  are in an editor window, you may use these commands  to
     find and replace text. These commands are not available for Viewer
     windows.

 Find...

     A  dialog box is displayed requesting the text to find and options
     for case sensitivity and whole word only searches. Click on either
     option  box to toggle it on or off, then press enter to start  the
     search. To repeat the search, use the Search Again menu option.

 Replace...

     A  dialog box is displayed requesting the text to find and the new
     text  to replace it with. Options for case sensitivity, whole word
     only  searches,  prompt  on  replace, and  replace  all  are  also
     offered.  Click  on any option box to toggle it on  or  off,  then
     press  enter to start the search and replace. To repeat the search
     and replace, use the Search Again menu option.

 Search Again

     This option repeats the previous search or replace selection.









 Windows Menu

     The  Windows  menu  contains commands to close, move  and  perform
     other  window-management commands. Most of  the  windows  in  this
     program  have  all the standard window elements, including  scroll
     bars,  a  close  box, and zoom Icons. For more about  windows  and
     their  elements,  refer  to  windows.  Window-management  commands
     Size/Move, Zoom, Tile, Cascade, Next, Previous, and Close

 Resize/Move

     Choose  this command to change the size or position of the  active
     window.If  you press Shift while you use the arrow keys,  you  can
     change  the  size of the active window. Once you've  adjusted  its
     size  or  position, press Enter. If a window has a Resize  corner,
     you  can drag that corner (lower right) to resize the window. When
     you  choose Window Size/Move, the active window moves in  response
     to  the arrow keys. Once you've moved the window to where you want
     it,  press Enter. You can also move a window by dragging its title
     bar with the mouse.

 Zoom

     Choose  Zoom to resize the active window to the maximum  size.  If
     the  window  is  already zoomed, you can choose  this  command  to
     restore  it  to  its  previous size.  You  can  also  double-click
     anywhere  on the window's title bar (except where an Icon appears)
     to zoom or unzoom the window.

 Next

     Choose Next to cycle forwards through the windows on the desktop.

 Close

     Choose  Close to close the active window. You can also  click  the
     Close box in the upper right corner to close a window.

 Tile

     Choose Windows Tile to tile all file viewers on the desktop.

 Cascade

     Choose  Windows  Cascade to stack all viewers and editors  on  the
     desktop.









 Accessories Menu

 Envelope

     This  option  allows  you  to print envelopes  using  the  Address
     Database or by entering new address information which you may then
     save to the database.

     You  will  first be prompted for the return address.  The  default
     return address that you have saved will be displayed. You may make
     changes to this and select OK to use the return address or  select
     NONE to skip the return address.

     In  order  to make changes, use the TAB key to move from field  to
     field and press enter only when you have finished and wish to  use
     the  address. If you wish to save your return address  select  the
     Save  box  with the mouse, or use the TAB key and press the  space
     bar to toggle it on or off, then press ENTER or click the mouse on
     OK.

     You  will  be  presented with a scrolling list  of  names  on  the
     database. Select a name by highlighting it and pressing enter,  or
     double  clicking the mouse on it. Another window  will  open  that
     allows  you to edit the address and save the changes or print  the
     address.  Pressing  cancel or escape will stop  the  changes  from
     being made. You may open multiple address windows at one time, and
     then  print  or edit them each without having to go  back  to  the
     menu.

 Addresses

     This  option  allows  you  to maintain the  address  database  for
     envelope printing. You may also print envelopes from this  screen,
     but  you  do  not  have an option to change  or  omit  the  return
     address, the default return address will always be printed.

     You  will  be  presented with a scrolling list  of  names  on  the
     database. Select a name by highlighting it and pressing enter,  or
     double  clicking the mouse on it. Another window  will  open  that
     allows  you to edit the address and save the changes or print  the
     address.  Pressing  cancel or escape will stop  the  changes  from
     being made. You may open multiple address windows at one time, and
     then  print  or edit them each without having to go  back  to  the
     menu.

 DOS Shell

     With  the DOS Shell command, you can leave the program temporarily
     to perform a DOS command or run another program. To return to this
     program, type EXIT at the DOS prompt.

 Calendar

     The calendar displays the current month, highlighting todays date.
     The  next and previous months can be viewed using the '+'  or  '-'
     keys  respectivly. The mouse can also be used to change the  month
     by pressing the - or icons.

 Calculator

     The  calculator  is  a simple four-function calculator  with  add,
     subtract, multiply, and divide. To operate the calculator you  can
     either  use  the  keyboard or press the buttons on the  calculator
     with  the mouse. The 'C' key clears the calculator, the back arrow
     key  will erase the last character typed, and the plus over  minus
     key  toggles  the  value from positive to negative  (the  keyboard
     equivalent is '_').









 Options Menu

     The   Options   menu  contains  commands  that  let   you   change
     PrintDefaults and mouse settings.

 Video Mode

     You  may  switch the screen between 25 line mode and  the  EGA/VGA
     high resolution 43/50 line mode with this option.

 Mouse...

     The  Mouse  command brings up the Mouse Options dialog box,  where
     you  can  set  various options that control how your mouse  works,
     including how fast a double-click is and which mouse button (right
     or left) is active.

     This dialog box consists of one check box, one slider bar, and the
     standard buttons OK and Cancel. The Mouse Double Click slider  bar
     adjusts  the  double-click  speed of  your  mouse.  Reverse  Mouse
     Buttons  makes the right mouse button take on the normal functions
     of the left--and vice versa.

 Page Format...

     The  Print  options  may be selected for the current  session,  or
     saved as the default by clicking on the save as default check box.
     Options that may be selected are page formatting and tabs size.

   Side By Side

     Two pages of 66 lines by 80 characters are printed side by side on
     a  sheet  of  paper. Lines that are longer than 80 characters  are
     truncated.  Each sheet has a heading with the file name  and  file
     date on it and numbering for each page printed on the sheet.

   Vertical Numbered

     This  is the default style. It will print a column of line numbers
     at  the  beginning of each line and place a heading at the top  of
     each  page.  The heading consists of the file name and  the  print
     date  and time. The text is printed Vertical on the page, 77 lines
     of text, 115 columns, using the Lineprinter Font.

   Portrait Un-numbered

     This  will  print  vertical on the page, 80  lines  of  text,  133
     columns, using the Lineprinter Font. No numbers or heading will be
     included.

   Horizontal Numbered

     This  will print a column of line numbers at the beginning of each
     line  and  place  a heading at the top of each page.  The  heading
     consists of the file name and the print date and time. The text is
     printed sideways on the page, 57 lines of text, 165 columns, using
     the Lineprinter Font.

   Landscape Un-numbered

     This  will  print  sideways on the page, 60  lines  of  text,  176
     columns, using the Lineprinter Font. No numbers or heading will be
     included.

   Normal 66 line

     Text will be printed in the printers default font with no headings
     or line numbers. This is 66 lines, 80 columns, Courier Font.

   Carriage Control

     Text will be printed using IBM carriage control characters (1,  0,
     -,  +,).  Text will be sideways on the page, and up to 176 columns
     wide  by  60  lines  long.  The  Lineprinter  font  is  used.  The
     overstrike  option  of  the  carriage control  characters  is  not
     supported.









 Command Line Options

     Syntax:

          LISTFILE [option] [filename] [filename] ...

          where option is: E for edit, P for print in the default mode,
     V for View

          Filename is: the name of the file you wish to load

     You  may load multiple files by specifying multiple files when you
     enter the command for example:

          LISTFILE P FILE1.TXT FILE2.TXT

     will  print file1.txt and file2.txt in the default mode. If E  was
     specified rather than P, an editor window would be opened for each
     file. If you specify a partial file mask as in the following:

          LISTFILE E FILE????.TXT

     Listfile  will  start with a file selection dialog and  show  only
     files  that  start  with the characters FILE  and  that  have  the
     extension   of  TXT  such  as  FILE1.TXT  and  FILESTUF.TXT.   Any
     combination  of DOS wildcards should work. Options  and  filenames
     should always be seperated by a space when you specify them.









 Using ListFile on a network

     Users  may  save their own configurations, defaults, and databases
     without  affecting other network users by entering  the  following
     line in their AUTOEXEC.BAT file:

          SET LISTFILE=d:\directory

     where  d:  is  any  valid FIXED disk on the  users  computer,  and
     directory  is  any  valid  directory  path  on  that  drive.  This
     directory will be used to store the following files:

          LISTFILE.CFG (Default settings for ListFile)

          LISTFILE.TMP (a temporary file used for DOS sessions)

          LISTFILE.ADR (The mailing address database)

     It  is  not  necessary to be on a network in  order  to  use  this
     feature.  This will allow you to store the program away  from  the
     data files if you wish. It is also not necessary to use this on  a
     network, but any changes to the defaults or databases will  affect
     all  users if you do not set them each up this way. If the network
     drive  is  write protected, nobody would be able to save addresses
     or defaults unless you install this way.









 Mouse Techniques

     In  all cases when using the mouse, the left mouse button is  used
     unless you have switched mouse buttons using a program option or a
     mouse driver option.

                    Clicking is the pressing and releasing of the mouse
        button. This is usually done to select something or change  the
        cursor position.

                     Double Clicking is when you press and release  the
        mouse  button  twice quickly. This is usually  done  to  select
        something  and  then execute the default action.  For  instance
        double  clicking  on a file name in the file  open  dialog  box
        selects that file and then opens it.

                     Dragging  something  with the  mouse  is  done  by
        placing  the  mouse  cursor  on it, pressing  and  holding  the
        button,  and then moving the mouse. This technique can be  used
        to  highlight  text  in  a text field or  to  move  and  resize
        windows.  When  the object is where you want  it,  release  the
        mouse button.

                     Selecting is done by clicking on an item with  the
        mouse. Often in conjunction with the dragging technique.









 SAA/CUA

     ListFile conforms to Systems Application Architecture (SAA) Common
     User Access (CUA) and should be fairly intuitive to use if you are
     familiar with Microsoft Windows or Presentation Manager. For those
     who  are  not,  or  just  need a refresher,  the  following  pages
     describe some of the elements of the interface and how to use  it.
     It is assumed here that you know basic mouse techniques

 Dialog Boxes

     A  dialog  box is window used to solicit input from the  user.  It
     usually  consists of a series of input fields and check  boxes  or
     rabio  buttons. When moving from item to item in a dialog box  use
     the  tab  key  and  press enter only when you have  completed  the
     dialog. Each box usually has a default action signified by the  OK
     button  and a Cancel option. Enter is the equivalent of OK, Escape
     is the equivalent of Cancel.

 Buttons

     These  are the way you tell the dialog what to do with your input.
     They are rectangular buttons which you select with the mouse.  You
     will  usually find them labelled OK, Cancel, Yes and No.  You  may
     move between them using the tab key as well as the mouse.

 Radio Buttons ( ) ( )

     These  buttons are always present in groups, and like the  buttons
     on  a radio, only one can be selected at a time. Select the button
     using  the  mouse, by typing the highlighted letter,  or  use  the
     cursor and press the space bar.

 Check Boxes [X]

     Check  boxes  are  similar to radio buttons in the  way  they  are
     selected,  but more than one may be selected at a time. Also  they
     may appear by themselves. When selected they have the letter X  in
     them.

 Entry Fields

     An  entry field is a place to enter text often these fields scroll
     sideways  to accommodate text that is longer than the input  area.
     You can scroll these fields by clicking the mouse on the right  or
     left  pointing triangles at the ends of the field. These triangles
     only  appear when there is more text than will fit in the  display
     area. Use the tab key to exit not the enter key.

 History Fields

     These  fields are a special type of entry field. You  will  notice
     them  by the down pointing arrow to the right of the entry  field.
     If  you  select this arrow, a window opens up displaying the  last
     few things that have been typed into the field. You may select one
     of  these items by double clicking on it with the mouse. To cancel
     this  press  escape or click the close icon. The file  open  entry
     field is an example of a history field.

 Windows

     Windows  are all of those framed areas that appear on  the  screen
     with  text files in them or entry fields and buttons. Most windows
     can  be moved about the screen and many can be resized. There  are
     commands to do this using the mouse or keyboard.

 Icons

     ListFile's  windows  may  contain several  types  of  ICONS  which
     function as follows:

                     The  diamond on the title bar allows you to  close
       the window, like ESC or F3.

                    The up arrow on the title bar Zooms the window.

                    The bar in the lower right corner is used to resize
       the window.

   Close

     Each  window will have a small box in the upper left corner called
     the  close icon. If you click on this icon, the window will close.
     This is the same as pressing escape or F3 key.

   Zoom

     In resizable windows, the upper right corner contains a box with a
     double or single headed arrow in it. This is the zoom icon. If the
     window  is not at its maximum size, it will be enlarged  when  you
     click on this button. Clicking again will return it to the smaller
     size.

   Resize

     Resizable windows contain a highlighted corner in the lower  right
     that can be used to change the size of the window. Place the mouse
     cursor  on  the corner, hold the mouse button down  and  drag  the
     window to the size and shape you want, then release the button.

 Scroll Bar

     A  scroll  bar allows you to move through text files or  selection
     lists using the mouse rather than page up/down or the cursor keys.
     To move up or down thru selections, use the bar on the right side.
     If  you click on the arrow you will move 1 line in that direction.
     If  you click between the arrow and the slider that appears in the
     bar,  you  will move a page. You may also drag the slider  to  any
     relative place in the file or list. Sometimes you will also have a
     scroll bar on the bottom for moving from right to left. These bars
     work in the same manner as vertical scroll bars.

 Slider

     The slider is the highlighted block in the middle of a scroll bar.
     It  will  show  your relative position in a file or  list  by  its
     relative position on the screen. At the top it indicates  the  top
     of  list, the bottom is the end of the list. You may move  quickly
     to  the  top or bottom by dragging the slider to the top or bottom
     of the bar using the mouse.

 Title Bar

     Each  window  is likely to have a title at the top of  the  frame.
     This  is known as the title bar and can be used to move the window
     around  the screen. Place the mouse cursor in the title, hold  the
     button down, drag the window to the location you want, and release
     the button.









 Licensing

     ListFile is distributed as shareware, as such it is not free.  You
     are free to use this program for a short time in order to evaluate
     it.  If  you use this program on a regular basis you are obligated
     to  pay  for it. This program may be copied as many times  as  you
     wish,  you  may  distribute  it to as many  people  as  you  wish,
     provided that this documentation is distributed with it and you do
     not charge for the program or documentation.

     In  order  to  register your copy and receive the  latest  version
     without the nag screen at the end, send a check for $25.00 to:

          Tom Guilford
          29 Fernwood Way
          San Rafael, CA 94901

     Be sure to state that you are registering ListFile v 4.0.

     You  may not distribute the registered version of the program when
     you  receive it. It is for your use on a single computer. You  may
     also  install a second copy on a laptop or other computer as  long
     as  you  are the only one who uses the program. You are encouraged
     to provide feedback about what you don't like, would like to have,
     or do like.


         ----------------end-of-author's-documentation---------------

                         Software Library Information:

                    This disk copy provided as a service of

                           Public (software) Library

         We are not the authors of this program, nor are we associated
         with the author in any way other than as a distributor of the
         program in accordance with the author's terms of distribution.

         Please direct shareware payments and specific questions about
         this program to the author of the program, whose name appears
         elsewhere in  this documentation. If you have trouble getting
         in touch with the author,  we will do whatever we can to help
         you with your questions. All programs have been tested and do
         run.  To report problems,  please use the form that is in the
         file PROBLEM.DOC on many of our disks or in other written for-
         mat with screen printouts, if possible.  PsL cannot debug pro-
         programs over the telephone, though we can answer questions.

         Disks in the PsL are updated  monthly,  so if you did not get
         this disk directly from the PsL, you should be aware that the
         files in this set may no longer be the current versions. Also,
         if you got this disk from another vendor and are having prob-
         lems,  be aware that  some files may have become corrupted or
         lost by that vendor. Get a current, working disk from PsL.

         For a copy of the latest monthly software library newsletter
         and a list of the 4,000+ disks in the library, call or write

                           Public (software) Library
                               P.O.Box 35705 - F
                            Houston, TX 77235-5705

                                1-800-2424-PSL
                             MC/Visa/AmEx/Discover

                          Outside of U.S. or in Texas
                          or for general information,
                              Call 1-713-524-6394


