

        ------- PSA Cards 2.5 for Windows 3.1 ------

     VERSION 2.5 WILL READ FILES WRITTEN BY EARLIER VERSIONS.
     EARLIER VERSIONS WILL NOT READ VERSION 2.5B FILES.
     
     IF YOU ARE RUNNING WINDOWS 95 OR WINDOWS NT 3.51 YOU SHOULD
     BE USING PSA CARDS 2.5 FOR WINDOWS 95 / NT 3.51

DESCRIPTION

     PSA Cards is an easy to use address program.  It looks
     like a card file and it works like a card file.  Just
     click on a divider tab or card to open or close it.
     
     PSA Cards is also an OLE 2.0 container application.
     This means that you can link or imbed objects
     (pictures, maps, documents, sound and video clips)
     created in other programs in your PSA Cards entries.
     

PSA Cards existing features:

 *   Print Rolodex cards, envelopes, mailing labels,
       shipping labels and address booklets.  Address books
       can be customized.
 *   Dial phone numbers
 *   Reminders for birthdays, anniversaries, or appointments
 *   Merge two PSA Cards files, keeping latest modifications
 *   Search any field for a text string and dated fields for
       a date or range of dates.  Includes searching for words
       that sound alike.
 *   Import data from an ASCII file or Microsoft CardFile
 *   Export any field or combination of fields to a file or 
       the clipboard for use in a word processing program or
       spreadsheet.
 *   Object Linking and Embedding (OLE 2.0) container
       application
 *   Create groups of entries for organizing various types
       of lists.  These lists can be used to address Christmas
       cards, invitations, and to export addresses for mail merge
       in a word processor.  Powerful group editing features.
 *   No inherent limits on the number of entries or lengths
       of fields.
 *   On-line, context sensitive help
 *   3-D controls
 *   Written in C++
 *   Windows 3.1, Windows NT, and Windows 95 versions available
 *   Tool tips for toolbar buttons (Not available for Windows 3.1)
 *   Dockable toolbars (Not available for Windows 3.1)
 *   Double click an entry to edit it
 *   User selectable screen and printer fonts
 *   Type a letter to open a divider tab
 *   Separate dialogs for residential and business entries
 *   File backup command and backup reminder.
 *   Installation program


Version 2.5 New Features and Changes

New Fields

 *   Added a country field to addresses.
 *   Added domestic dialing prefix field.
 *   Added international dialing prefix field.
 *   Added left-right offset for envelope center feed
       printers.
 *   Added number of copies to print for each label

User Interface

 *   Improved keyboard access to dialog edit fields

Dialing Phone Numbers
 *   Added International dialing, including country codes in 
       telephone numbers.
 *   Moved dialing setup to cards.ini / registry
 *   Added long distance prefix for domestic calls.

Printing 

 *   Print Setup buttons in print dialog boxes.          
 *   Move printing options to cards.ini / Registry.
 *   POSTNET bar codes, include Delivery Point codes and FIM.
 *   Sort envelopes and labels on ZIP code
 *   New field to set left-right position of envelopes in 
       landscape mode for center feed printers.
 *   You can now print multiple copies of each label

On-line Help

 *   Added access to readme.txt and installation log files
       from within the program in compliance with
       Windows 95 programming guidelines.
 
General

 *   Added backup directory path to cards.ini.
 *   Can now print registration forms from registration help 
       topic.
 *   Changed sorting of entries to include a blank between
       the last name and first name, and to use language
       sensitive collating.

Bug Fixes

 *   Fixed a bug which caused "Next" button to drop data
       from property sheets when creating a new entry.


********************** INSTALLATION **********************

   If you install PSA Cards 2.5 over a previous version,
   be sure to use the install program.  It installs new
   system DLL's from Microsoft in your windows\system 
   directory.

   If you have saved your own data in the samples.car file
   from a previous version and are installing to the same
   directory, be sure to move or copy your old sample.car
   file to a different location.  The install program will 
   overwrite the existing sample.car with a new version.

   INSTALLING FROM A FLOPPY DISK

     Run the install program, install.exe from the Program
     Manager.

   INSTALLING FROM A DOWNLOADED PSA Cards ZIP FILE

     1. Create a directory for the program on your hard
     drive and copy the PSA Cards ZIP file to it.
     
     2. Extract the program and help files by running
     pkunzip in DOS or in a DOS window.  This will make
     19 files in the program directory.  Eleven of these are
     OLE 2.0 libraries from Microsoft.  These files will be
     installed in your windows\system directory.  There are
     seven files PSA Cards 2.5 files: cards.exe, cards.hlp,
     readme.txt, register.txt, convert.exe, cardfile.msc, and
     sample.car.
     The last file is the installation program, install.exe.

     If you wish, the PSA Cards ZIP file can now be deleted 
     from your hard drive.  However, it would be a good idea 
     to back it up to a floppy disk before deleting it.
     
     3. Run the installation program, install.exe, from the
     Program Manager (Run... in the File menu) and follow
     instructions.
     

INSTALL.EXE -- MORE DETAILED INFORMATION

     The installation program will copy the PSA Cards files
     to whatever directory you choose.  The installation
     directory can be the same as directory for the
     downloaded PSA Cards ZIP file.
     
     After copying the Cards files to the installation
     directory, the install program will create a program
     group and program items in the Program Manager.  There
     will be program items for PSA Cards, Cards Help, the
     installation log, and this readme.txt file.
     
     The OLE 2.0 dynamic libraries are supplied by Microsoft
     for installation in systems running 16 bit versions of
     Windows.  That is, Windows 3.1 and Windows 3.11
     (Windows for Workgroups).  If you are running a 32 bit 
     version of Windows, you should download or order the 
     32 bit version of PSA Cards.
     
     In order to install the OLE libraries, the install
     program checks to make sure that an existing version of
     a library is not in use.  If one is, a message box is
     displayed asking the user to shut down all possible
     applications and then try to continue the installation.
     If this doesn't fix the problem, try shutting down and
     restarting Windows.  Then restart the installation.  If
     you already have the OLE 2.0 libraries, the install
     program will compare library versions and will not
     overwrite a newer library version with an older one.
     The OLE 2.0 files are:
     
          COMPOBJ.DLL
          MFCOLEUI.DLL
          OLE2.DLL
          OLE2.REG
          OLE2CONV.DLL
          OLE2DISP.DLL
          OLE2NLS.DLL
          OLEPROX.DLL
          STDOLE.TLB
          STORAGE.DLL
          TYPELIB.DLL
     
     The OLE 2.0 libraries must be registered with the
     REGEDIT.EXE program.  REGEDIT.EXE is part of Windows.
     REGEDIT.EXE is run automatically by the installation
     program.
     
     If you are running Windows 3.1, you must have the SHARE
     command in your autoexec.bat file.  The SHARE settings
     /L: and /F: must be at least /L:500 and /F:5100.  This
     sets up range locking used by OLE 2.0 compound files.
     The install program checks for the SHARE command.  More
     often than not, the install program from some other OLE
     2.0 aware application will have already added SHARE to
     your autoexec.bat. If you do get a SHARE message you
     will need to edit your autoexec.bat file and add the
     line:
     
       SHARE /L:500 /F:5100
     
     after the PATH command but before the WIN command.  Use
     an ASCII text editor such as Notepad or SysEdit to
     change your c:\autoexec.bat file.  If you are working
     in DOS you can also use the DOS editor, EDIT. I could
     have written the install program to do this
     automatically, but I dislike (and distrust) install
     programs that alter my autoexec.bat and config.sys
     files.
     
     If you are running MS-DOS 4.01, the SHARE statement
     must be in your CONFIG.SYS file and the command is:
     
       INSTALL=C:\DOS\SHARE.EXE /L:500 /F:5100
     
     Of course, if your DOS directory is not C:\DOS, the
     correct path to your DOS directory must be supplied.
     
     IMPORTANT PRECAUTION -- Anytime that you change your
     autoexec.bat (or config.sys) file you should make a
     backup copy of it first.  Just copy it to another file
     such as autoexec.sav.  Then if there is some mishap
     with your autoexec.bat file you can restore it.  Your
     computer needs the autoexec.bat and config.sys files in
     order to boot.
     
     When you change your autoexec.bat file, you need to
     reboot your computer before the changes will take
     effect.
     
     If you are running Windows 3.11 (Windows for
     Workgroups) you do not need (and should not use) SHARE.
     Range locking is a built-in part of Windows 3.11.
     
     Finally, if you have set your TEMP entry in your
     autoexec.bat to point to removable media, you should
     change it back to point to a local hard drive.  The
     install program does NOT check TEMP entry.
        

LOADING A DATA FILE ON STARTUP
     
     The installation program sets up PSA Cards to automatically 
     open the file "sample.car" each time you double click on
     the PSA Cards icon.  If you want to open a different file
     on program startup, use the Program manager "Properties" 
     command to change the Command Line entry.  The new data 
     file name replaces "sample.car" after the program name 
     (cards.exe).  Be sure to leave a blank between the program 
     name and the file name.

REGISTRATION

     To become a registered PSA Cards user, and to receive
     notification of new releases of PSA Cards, send $25.00
     to:
          
          William L. Rogers
          PSA Software
          1319 Silk Oak Drive
          Fort Collins, CO 80525-5597
          
     Colorado residents please add 3% sales tax.  Fort
     Collins, Colorado residents please add 6% sales tax.

     WHAT YOU GET FOR REGISTERING

     *  Your registration code
     *  A personalized program diskette with the latest
        version of PSA Cards
     *  Notification of new releases 
     *  Download & use the Windows 95 version. (Your registration 
        code will work with it too.)
     *  Program support
     *  The Windows 95 / Windows NT 3.51 PSA Cards 2.5 diskette
        for only a $3.00 shipping handling fee.
     
     The file register.txt can be printed and used as a 
     registration form.  A registration form can also be
     printed from within the program's Help topic for the
     Register command.  If you choose not to use a 
     registration form, be sure to indicate that you are
     registering the Windows 3.1 version 
     so that I can mail the correct diskette.  

     COMPUSERVE USERS

     If you are a CompuServe user, you can also register
     using CompuServe's Shareware Registration service.
     The registration ID for this program is 4619.  The
     fee is $25.00.  After CompuServe notifies me of your
     registration, I will e-mail your registration code 
     and send your diskette via US mail.

     Registered users enable me continue to improve PSA
     Cards and implement your suggestions.  The income also
     pays for the computer and software I use to do this.
     If you use PSA Cards on a regular basis and find it
     useful, please register.  This version of PSA Cards 
     allows you to update your data file 20 times before
     registering.  After the 20th update you will still be
     able to access your data, but will not be able to save
     changes to the file until you enter your registration
     code using the Registration command in the Help menu.
     

DISCLAIMER

     Although PSA Cards has been carefully written and
     tested, no claim is made as to its reliability and
     freedom from bugs.  This software is provided "as-is"
     without warranty of any kind. In no event shall PSA
     Software be liable for any damages whatsoever arising
     out of the use or inability to use PSA Cards.
     
     
INSTRUCTIONS FOR CONVERTING MICROSOFT CARDFILE FILES

     Importing data from a program like Microsoft CardFile
     poses a problem. PSA Cards has specific data fields for
     each type of information that it stores.  That is, it
     makes a distinction between say a street address and a
     phone number. CardFile does not.  There are only two
     fields in CardFile -- the index line and text.
     CardFile data can be converted to input for PSA Cards'
     ASCII import function if the information on each card
     is in a consistent order and the file contains no
     imbedded objects (remove all OLE stuff).
     
     There is a grubby little DOS application in this
     package called convert.exe.  Convert reads a CardFile
     file and attempts to find the appropriate places for
     field delimiters in the card and writes an output file
     for the import function in PSA Cards:
          
          CardFile file -> Convert.exe -> PSA Cards ASCII
          import
          
     Convert uses the following rules to insert field
     delimiters.
     
     *    Newlines (carriage return, line feed) are replaced by a
          delimiter.
     
     *    Multiple newlines only generate one delimiter.
     
     *    A comma followed by a blank is replaced by a delimiter.
          This can be turned off (option c-).
     
     *    If comma-blank is being replaced by a delimiter, the
          index line  will always generate two fields.  The second
          field may be empty.
     
     *    A single blank after a letter followed by five digits
          will be replaced by a delimiter.  This is assumed to be the
          ZIP code.  This can also be turned off (option z-).
     
     Convert writes a field definition record as the first
     line of the output file.  It assumes that the delimiter
     is ! and that the fields are in the following order:
     
          !lname1 fname1 street city state zip phone1
          comment

     If your CardFile has a different order or different
     fields, the first line of the output file will have to
     be edited.  Use the DOS editor, or Notepad.  Be sure to
     use "No conversion" if you must use Write.  You may
     also have to fix up individual records if your input
     file is not consistent enough or you encounter
     situations not handled properly by the above rules.
     You can also edit individual cards once they have been
     imported to PSA Cards.
     
     See the on-line help for PSA Cards for more details
     about the file import function in PSA Cards.
     
     Convert has been tested with files written by the
     CardFile in Windows for Workgroups 3.11 and Windows NT.
     I can only assume that the same program is used in
     Windows 3.1.  There is an example CardFile file
     included.  It is called cardfile.msc.  If you turn on
     Convert output to the screen (/s+) you can pipe your
     output to "more".  To see how Convert works, type the
     following command in DOS or a DOS window while in the
     PSA Cards directory:

          >convert  /s+  cardfile.msc  imptcard.adr  |  more

     Then run PSA Cards from Windows and use the "Import..."
     command (File menu) to read imptcard.adr.
     

KNOWN PROBLEMS

     *    The Equation Editor for Microsoft Word does not always
          work properly with OLE 2.0 container applications.  This 
          version of PSA Cards will not recognize the Equation
          Editor.  Word itself and its other associated OLE
          servers work OK.
     
     *    The Help buttons in the OLE dialog boxes for Change
          Icon and the OLE File Browser do not do anything.
     
     *    Context sensitive help for the Object command in the
          OLE menu does not link to the correct help topic.
     
     These bugs are related to OLE 2.0 components supplied
     by Microsoft.


BUG REPORTS AND FEEDBACK

     Please send bug reports, and suggestions for new
     features to CompuServe User ID 72064,1437, or 
     Internet: billr@Linden.FortNet.org or US mail to me 
     at the above registration address.  I can't fix bugs
     or add new features if I don't know about them, so let
     me hear from you.
     
     I hope that you find PSA Cards useful.

          Bill Rogers
