                        WIN_PHON Instructions
readme.txt
Rev 1.1


PACKAGE CONTENTS:
     The following is a list of  the files that should be in this
     package, along with a brief description of what each one is.
          o   README.TXT     ASCII text file.
          o   README.WRI     Windows Write File.
          o   WIN_PHON.DAT   Template data file.
          o   WIN_PHON.EXE   The executable.
          o   WIN_PHON.HLP   The help file.
          o   WIN_PHON.INI   Template initialization file.


INSTALLATION INSTRUCTIONS:

     I.   NOTE:  Use these instruction when setting this program up
          in Windows(1) version 3.1.  Windows 3.0 setup is different
          for step V.- E.

     II.  Make a directory ( skip this step of a directory exists
          that you want to copy these files into).

     III. Copy the above listed files into the desired directory.

     IV.  Copy or move "win_phon.ini" into the directory that Windows
          is installed in.

     V.   Add the application to a group in Windows.
          A.   Click left mouse button in group window that win_phon
               is to be installed into.
          B.   Select "File" menu from the "Program Manager" window.
          C.   Select "New" from the "File Menu".
          D.   Make sure the radio button for "Program Item" is
               selected.
          E.   Fill out the "Program Item Properties" dialog box.
               1.   Description:   Name that is to be
                    seen under the icon (e.g. win_phon).
               2.   Command Line:  Directory path and
                    name of executable (e.g.
                    c:\winapps\win_phon\win_phon.exe).
               3.   Working Directory:  Path to the
                    directory that contains the
                    executable (e.g. c:\winapps\win_phon).
               4.   Shortcut Key:  Enter "None."
               5.   Click the "OK" button.

     VI.  At this point there should be an icon with a phone and an
          open book in the window that was selected in step V.

     VII. To have this application load automatically when Windows is
          invoked put the path name and executable on the "load="
          line in the "win.ini" file (e.g.
          load=c:\winapps\win_phon\win_phon.exe).


INI FILE DESCRIPTION:

     I.   CAUTIONS:
          A.   The names to the left of the equal sign must remain
               the same.
          B.   The names on the right side of the equal sign are the
               ones the user wants to see for each text box title.
          C.   The first 14 characters to the right of the equal sign
               will be used for each of the text field titles.
          D.   The title can be up to 32 characters in length.

     II.  WIN_PHON.INI   This file contains the following data
               lines:
          A.   [WIN_PHON]     This is the first line of the
               ".ini" file, it must always be there,
               otherwise the desired changes would not be
               read from this file.
          B.   fldname1=F Name:    "fldname1" is the variable name of
               the first (top) data field.  The value after the equal
               sign is what the user wants to see as the name of the
               first data field.
          C.   fldname2=Address1:  "fldname2" is the variable name of
               the second data field.  The value after the equal sign
               is what the user wants to see as the name of the
               second data field.
          D.   fldname3=Address2:  "fldname3" is the variable name of
               the third data field.  The value after the equal sign
               is what the user wants to see as the name of the third
               data field.
          E.   fldname4=Phone No:  "fldname4" is the variable name of
               the forth data field.  The value after the equal sign
               is what the user wants to see as the name of the forth
               data field.
          F.   fldname5=Ext No:    "fldname5" is the variable name of
               the fifth data field.  The value after the equal sign
               is what the user wants to see as the name of the fifth
               data field.
          G.   fldname6=FAX No:    "fldname6" is the variable name of
               the sixth data field.  The value after the equal sign
               is what the user wants to see as the name of the
               sixth data field.
          H.   fldname7=Company:   "fldname7" is the variable name of
               the seventh data field.  The value after the equal sign
               is what the user wants to see as the name of the
               seventh data field.
          I.   fldname8=Misc:      "fldname8" is the variable name of
               the eighth (bottom) data field.  The value after the
               equal sign is what the user wants to see as the name
               of the eighth data field.
          J.   Title=My Phone List "Title" is the variable name of
               the title of the dialog box, along with the title name
               that will appear when the application is iconified.
               The value after the equal sign is the name the user
               wants to see for the title of the application.


USAGE:

     I.   Click the left mouse key in any of the text boxes.

     II.  Enter a single character or string of text to search for.

     III. Hit the "Enter" or "Return" key on the keyboard, or click
          the left mouse button on the "OK" button.  This begins the
          search through the database for a match.


CONTROL DESCRIPTION:

     I.   OK       This button is active when the user has
                   clicked the cursor in one of the text boxes and
                   has entered or changed existing text in that box.
                   When the editing is complete the user can press
                   "Enter" or "Return" on the keyboard, or click the
                   mouse on this button to start the search for a
                   matching text pattern in the database.

     II.  CANCEL   This cancels the application.  It is
                   the same as hitting Alt-F4 on the keyboard.

     III. HELP     This brings up the help window.

     IV.  CLEAR    This clears the data in all of the text
                   fields.

     V.   PREV     If you click on the this button the previous
                   match in the database will be displayed.  If the
                   button is gray this indicates the list is at the
                   first match.

     VI.  NEXT     If you click on the this button the next
                   match in the database will be displayed.  If the
                   button is gray this indicates the list is at the
                   last match.

     VII. General  The button with the darker border will
                   accept either having the "spacebar" or the enter
                   key being pressed.


TROUBLESHOOTING:
     CAUTION:  ONLY USE AN ASCII TEXT EDITOR ON THE ".INI" FILE.  If
     the values do not change to the values you entered, make sure
     the ".ini" file is in the windows directory, and that the user
     used an ASCII only editor.  Some editors leave embedded
     characters that cause Windows problems when trying to read the
     ini file.


DISCLAIMER:
     This program has been through some testing, however not with all
     other Windows programs or combinations of programs.  I claim no
     responsibility for any damage that may be caused while using
     this program.  This program is to be used "AS IS".  If you
     experience any problems while using this program please let me
     know, along with your system parameters; and if you are a
     registered user I will try to fix the problem and send you an
     updated version.
     
    
(1) Registered Trademark of Microsoft Corporation.
