home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / misc / family3.zip / README < prev    next >
Text File  |  1987-10-20  |  14KB  |  251 lines

  1.                         Family History System
  2.                             Basic Programs
  3.                           (Compiled Version)
  4.  
  5. The Family History System was written to provide a simple means for 
  6. creating files of personal information including family relationships, 
  7. and for producing standard types of genealogical reports from 
  8. information in those files.  Information for up to 3500 individuals 
  9. may be stored on a single DS/DD floppy diskette (or up to 9999 on a 
  10. hard disk).  There are no limits on the numbers of relationships 
  11. (parent, child or spouse) that an individual may be involved in.  
  12. Reports produced by the basic set of programs include:
  13.      ancestor report, descendant reports (in list or "chart" format),
  14.      relative reports, complete sets of ancestor charts, and family 
  15.      group reports.
  16.  
  17. The basic documentation (a 50 page manual) and the "interpreted" 
  18. version of the programs are found on a separate diskette.  This 
  19. diskette has a version of the programs that has been compiled using 
  20. Microsoft's QuickBASIC (version 3.0) compiler.  Requirements for 
  21. running these programs are:
  22.  
  23.      an IBM PC, XT, AT, PCjr or compatible computer
  24.      at least 256k RAM
  25.      PC or MS DOS version 2.0 or later
  26.      at least 1 DS/DD floppy drive
  27.      and an 80 character monitor (monochrome or color, no graphics 
  28.         required)
  29.      (a printer is recommended for making full use of the system but 
  30.         is not required for creating the files or displaying 
  31.         information on the monitor).
  32.  
  33. You may create as many copies of these programs as you need for your 
  34. own use.  Further you may share the system with others, provided you 
  35. only give them a complete DISKCOPY of the distribution diskette as you 
  36. received it and you ask no fee beyond that required to cover the cost 
  37. of media, postage and handling.
  38.  
  39. You are free to use these programs without any feeling of obligation 
  40. for payment to the author, however if you are interested in receiving 
  41. an extended version of the system supporting additional options you 
  42. may consider becoming a registered user of the programs by sending a 
  43. $35.00 registration fee to:
  44.  
  45.                           Phillip E. Brown
  46.                           834 Bahama Drive
  47.                           Tallahassee, Fla.  32301
  48.  
  49. Registered users receive both interpreted and compiled versions of all
  50. programs in the system and are notified of the availability of
  51. additional enhancements (a $10.00/12.00 fee is required for subsequent
  52. updates to the interpreted/compiled versions of the system).
  53. Currently the extended system provides the following additional
  54. options:
  55.  
  56.    a program for creating index files based upon combinations of
  57.    Surname, Given name, birthdate (YMD or MDY), Deathdate (YMD), most
  58.    recent marriage date (MDY), sex, & ID#;
  59.  
  60.    a program for producing printed indexes for ancestor, descendant,
  61.    relative and family group reports and sets of ancestor charts;
  62.  
  63.    a program for searching the files and producing listings of 
  64.    information for selected individuals (including comments, latest 
  65.    residence address and relationship);  this program also produces a
  66.    Surname Summary Report which can be used to evaluate the completeness
  67.    of certain types of information for groups of records;
  68.  
  69.    a program for exporting information for selected individuals into a 
  70.    GEDCOM format ASCII (standard character) file; the same program
  71.    will import information from a GEDCOM format file into another 
  72.    family file, allowing you to create "subset" family files for
  73.    others.  All family relationships between transferred individuals
  74.    are maintained across the export/import process;
  75.  
  76.    an option for producing a Mailmerge format file of latest residence
  77.    addresses and phone numbers; this can be used with database
  78.    managers (such as the publicly distributed PC-FILE III) to print
  79.    mailing labels, and can be used with many word processors to print
  80.    form letters;
  81.  
  82.    a program for checking the consistency of internal "pointer"
  83.    information (and optionally making corrections as required);  this
  84.    may be used to "recover" from errors resulting from an extended
  85.    update session that was interrupted by a power failure.
  86.  
  87.     All programs are (C) Copyright 1985,1986,1987 by Phillip E. Brown
  88.  
  89.  
  90.  
  91. TRYING OUT THE PROGRAMS:
  92.    You may try out these programs by placing this diskette in the "A" 
  93.    drive of your PC and entering:   A>faminit
  94.  
  95.    You should be greeted by the system's "Title Screen" which should
  96.    soon be followed by a display of the system's "MAIN MENU" of
  97.    program options.  If you instead see a message such as:
  98.                  "Cannot run as a child of BASIC"
  99.    then you will first have to enter:   A>zero
  100.                             and then:   A>faminit
  101.    (NOTE: even though all programs in the system are .EXE files, they
  102.    are not individually executable.  The system MUST be entered through
  103.    program FAMINIT.  All other programs are selected from the MainMenu
  104.    of system options.)
  105.  
  106.    Once you get to the "MAIN MENU" you may want to try one of the
  107.    utility options:
  108.            F3-A  Change File Name Table
  109.            F3-B  Change Colors & Error Tone
  110.        or  F3-C  Change Printer Control Table
  111.    Or you may consider trying to print out blank family group
  112.    worksheets (using F2-C, F5) or printing blank ancestor charts
  113.    (using F2-D, F5).
  114.  
  115.    If you get a message like "Unsupported function in line" when 
  116.    requesting MainMenu option F1, the problem is probably insufficient
  117.    available memory on your machine.  Even those with 640k of RAM 
  118.    installed may face this problem if large RAM disks or many resident 
  119.    routines are used.  If you get this message, try rebooting without 
  120.    some of your RAM resident routines to see if the message goes away.
  121.  
  122.    While it is best to look over a copy of the system documentation  
  123.    to find out how the system is intended to operate (the manual is 
  124.    found on the diskette with the interpreted version of the system), 
  125.    you may be able to figure out how it all works by investing a
  126.    little time (and patience) while taking note of the following:
  127.  
  128.       1. Options are usually single-key selectable from a "menu" that 
  129.          appears on the screen.
  130.       2. Errors and "illegal" key-strokes are usually greeted by a
  131.          soft tone and occasionally by an error message on the bottom 
  132.          line of the screen.  If an error message has a trailing "..." 
  133.          then the program is waiting for you to press any key before 
  134.          continuing.
  135.       3. The ESCape key is (almost) always used to terminate an 
  136.          operation that you do not wish to continue.  Some operations 
  137.          such as the creation of an ancestor workfile are not 
  138.          interruptible, and at other times you are given another means 
  139.          (usually pressing a function key) for ending an operation.
  140.       4. When updating a multi-field formatted display, use the TAB 
  141.          and SHIFT+TAB keys to move forward (or backward) to the next 
  142.          (previous) updatable field. (The HOME key moves you to the 
  143.          First updatable field and the END key to the Last updatable 
  144.          field on the screen.)
  145.       5. If you are updating a formatted display and there is not 
  146.          shown an option for letting the program know that you are 
  147.          through, then you should press the ENTER or RETURN key to 
  148.          tell the program that you wish to continue.
  149.       6. Reports may be paused by pressing any key.  A message such as 
  150.          "Waiting..." should appear at the bottom of the screen.  You 
  151.          may then terminate the report by pressing the ESCape key, or 
  152.          continue it by pressing any other key.
  153.       7. There is a DATECALC utility which performs a number of useful
  154.          date manipulations.  If you boot the system from the diskette
  155.          created by the INSTALL procedure (described below) then the
  156.          utility has been made RAM resident and may be called up at
  157.          just about any time by pressing the ALT and CTRL keys at the
  158.          same time.  If you are using DOS 3.0 or later and have enough
  159.          free memory, you can also call it up from the MainMenu by
  160.          pressing the F7 key.  The calculator "window" may be moved
  161.          around using the cursor control keys.  When a calendar is
  162.          displayed, it may be scrolled backward and forward by months
  163.          and years by using the cursor control keys also.
  164.  
  165. CREATING WORKING COPIES OF THE PROGRAMS
  166.    A Batch procedure is provided to help you create a working copy of
  167.    these programs on either a floppy or hard disk.  On a hard disk, 
  168.    the programs are placed in a separate sub-directory (\FAMILY) and a
  169.    batch file (FHS.BAT) is created in the main directory of the hard 
  170.    disk to make it easier getting into the system.
  171.  
  172.    If you are installing the programs on a hard disk then place this 
  173.    diskette in the "A" drive of your PC and enter:
  174.            A>INSTALL HD x yyyy
  175.    where "x" is the letter you use to designate your hard disk 
  176.    (usually "C") and yyyy=ZERO if you found it necessary to enter the 
  177.    ZERO command before running the programs (see TRYING OUT THE 
  178.    PROGRAMS above).  After the installation is complete, you may start 
  179.    the system by changing the default drive to the hard disk and 
  180.    entering  "fhs"  (without the quotes) in response to the DOS 
  181.    prompt.  (The compiled version of the programs can "co-exist" with
  182.    the interpreted version in the same sub-directory...of course you
  183.    will use separate commands to start them.  Once you determine that
  184.    the compiled version works correctly on your equipment, you will
  185.    probably want to remove the interpreted version from your hard disk
  186.    by deleting all of the files in your \FAMILY directory with a
  187.    suffix of ".BAS".)
  188.  
  189.    If you are installing the programs on a floppy diskette, you must
  190.    first format a diskette by placing your DOS diskette (which 
  191.    contains the FORMAT command) in the "A" drive of your PC and
  192.    entering one of the following:
  193.          A>format b:/s   (if the diskette is to be "bootable")
  194.     or   A>format b:     (if you want more room on the diskette for 
  195.                          data)
  196.    You will be asked to place the diskette that is to contain the 
  197.    programs in the "B" drive.  Make sure that you don't want to save 
  198.    anything on the diskette that you use as all previous contents will 
  199.    be lost...If you are not creating a "bootable" diskette, then you 
  200.    should also copy COMMAND.COM from your DOS diskette to the newly 
  201.    formatted program diskette before continuing with the INSTALL 
  202.    procedure.  This will avoid a message prompting you to insert a 
  203.    diskette with COMMAND.COM on it when you terminate a FHS session.
  204.  
  205.    After formatting the diskette, label it "Family History System 
  206.    Program diskette", then place the distribution diskette in the "A" 
  207.    drive and enter:
  208.               A>INSTALL FD xxxx
  209.    where xxxx=ZERO if you found it necessary to enter the ZERO command
  210.    before running the programs (see TRYING OUT THE PROGRAMS above).  
  211.    After the installation is complete, you may start up the system by 
  212.    placing the new Family History System Program diskette in the "A"
  213.    drive and entering: A>fhs (or by pressing CTRL+ALT+DEL if you 
  214.    formatted a "bootable" program diskette).
  215.  
  216.    (Note: With the current and subsequent updates to the compiled set
  217.    of programs, the total size of the program files and QuickBASIC
  218.    runtime support has grown to the point that, depending on the
  219.    version of DOS that you use, there may be insufficient space on a
  220.    360k diskette to create a "bootable" program diskette.  If you get
  221.    a message such as:
  222.                 "Insufficient Disk space to copy...."
  223.    during the installation procedure, then reformat the new program
  224.    diskette without the "/s" option and retry the INSTALL procedure.
  225.    Don't forget to place a copy of COMMAND.COM on the diskette.
  226.  
  227.    You could also split the programs between two diskettes, one of which
  228.    is "bootable".  You should have no problem doing this if you observe
  229.    the following "rules":
  230.         1. The FAMILY.DAT file must only be on the "bootable" diskette.
  231.         2. Program FAMINIT.EXE should only be on the "bootable" diskette.
  232.         3. For convenience only:
  233.            a. place a copy of COMMAND.COM on both diskettes
  234.            b. place a copy of FAMMENU.EXE on both diskettes
  235.            c. if you want to invoke the DATECALC utility using F7 from
  236.               the MainMenu, then make sure DATECALC.COM is on both diskettes.
  237.  
  238. Please note that when running from floppy diskettes, the program diskette
  239. only has to be in the default drive when starting the system, when selecting
  240. an option from the MainMenu, or when returning to the MainMenu from one of
  241. the option processing programs.  At all other times you may remove the
  242. program diskette and replace it with a data diskette.  The system will let
  243. you know when it is necessary to put the program diskette back on that drive.
  244. When you are using the file update program, MainMenu option F1, you should
  245. be careful never to remove a data diskette from either drive until you have
  246. closed the files, or returned to the MainMenu program, or have been told
  247. by the system to put the program diskette in the default drive.
  248.  
  249. I hope you enjoy using the programs.  Please let me know if you have
  250. any problems or if you have suggestions for improvement.
  251.