home *** CD-ROM | disk | FTP | other *** search
/ Between Heaven & Hell 2 / BetweenHeavenHell.cdr / 300 / 206 / readme < prev    next >
Text File  |  1986-11-25  |  12KB  |  219 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 38 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 2.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.1 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 fee is required for subsequent 
  52. updates to either the interpreted or 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.    and relative 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);
  66.  
  67.    a program for exporting information for selected individuals into a 
  68.    GEDCOM format ASCII (standard character) file; the same program 
  69.    will import information from a GEDCOM format file into another 
  70.    family file, allowing you to create "subset" family files for
  71.    others.  All family relationships between transferred individuals 
  72.    are maintained across the export/import process;
  73.  
  74.    an option for producing a Mailmerge format file of latest residence 
  75.    addresses and phone numbers; this can be used with database 
  76.    managers (such as the publicly distributed PC-FILE III) to print 
  77.    mailing labels, and can be used with many word processors to print 
  78.    form letters;
  79.  
  80.    a program for checking the consistency of internal "pointer" 
  81.    information (and optionally making corrections as required);  this 
  82.    may be used to "recover" from errors resulting from an extended 
  83.    update session that was interrupted by a power failure.
  84.    
  85.       All programs are (C) Copyright 1985,1986 by Phillip E. Brown
  86.  
  87.  
  88.  
  89. TRYING OUT THE PROGRAMS:
  90.    You may try out these programs by placing this diskette in the "A" 
  91.    drive of your PC and entering:   A>faminit
  92.  
  93.    You should be greeted by the system's "Title Screen" which should
  94.    soon be followed by a display of the system's "MAIN MENU" of
  95.    program options.  If you instead see a message such as:
  96.                  "Cannot run as a child of BASIC"
  97.    then you will first have to enter:   A>zero
  98.                             and then:   A>faminit
  99.  
  100.    Once you get to the "MAIN MENU" you may want to try one of the
  101.    utility options:
  102.            F3-A  Change File Name Table
  103.            F3-B  Change Colors & Error Tone
  104.        or  F3-C  Change Printer Control Table
  105.    Or you may consider trying to print out blank family group
  106.    worksheets (using F2-C, F5) or printing blank ancestor charts
  107.    (using F2-D, F5).
  108.  
  109.    There is a sample family file on this diskette created from
  110.    information for 24 generations of descendants of ADAM as recorded
  111.    in the book of GENESIS in the Bible.  You can try some of the
  112.    report options using this file (some significant name records are
  113.    ID=1 (Adam), 11 (Noah), and 186 (Joseph)) although there is rather
  114.    limited space on the diskette for creating workfiles.
  115.  
  116.    If you get a message like "Unsupported function in line" when 
  117.    requesting MainMenu option F1, the problem is probably insufficient 
  118.    available memory on your machine.  Even those with 640k of RAM 
  119.    installed may face this problem if large RAM disks or many resident 
  120.    routines are used.  If you get this message, try rebooting without 
  121.    some of your RAM resident routines to see if the message goes away.
  122.  
  123.    While it is best to look over a copy of the system documentation  
  124.    to find out how the system is intended to operate (the manual is 
  125.    found on the diskette with the interpreted version of the system), 
  126.    you may be able to figure out how it all works by investing a 
  127.    little time (and patience) while taking note of the following:
  128.  
  129.       1. Options are usually single-key selectable from a "menu" that 
  130.          appears on the screen.
  131.       2. Errors and "illegal" key-strokes are usually greeted by a 
  132.          soft tone and occasionally by an error message on the bottom 
  133.          line of the screen.  If an error message has a trailing "..." 
  134.          then the program is waiting for you to press any key before 
  135.          continuing.
  136.       3. The ESCape key is (almost) always used to terminate an 
  137.          operation that you do not wish to continue.  Some operations 
  138.          such as the creation of an ancestor workfile are not 
  139.          interruptible, and at other times you are given another means 
  140.          (usually pressing a function key) for ending an operation.  
  141.       4. When updating a multi-field formatted display, use the TAB 
  142.          and SHIFT+TAB keys to move forward (or backward) to the next 
  143.          (previous) updatable field. (The HOME key moves you to the 
  144.          First updatable field and the END key to the Last updatable 
  145.          field on the screen.)
  146.       5. If you are updating a formatted display and there is not 
  147.          shown an option for letting the program know that you are 
  148.          through, then you should press the ENTER or RETURN key to 
  149.          tell the program that you wish to continue.
  150.       6. Reports may be paused by pressing any key.  A message such as 
  151.          "Waiting..." should appear at the bottom of the screen.  You 
  152.          may then terminate the report by pressing the ESCape key, or 
  153.          continue it by pressing any other key.
  154.  
  155.  
  156. CREATING WORKING COPIES OF THE PROGRAMS
  157.    A Batch procedure is provided to help you create a working copy of 
  158.    these programs on either a floppy or hard disk.  On a hard disk, 
  159.    the programs are placed in a separate sub-directory (\FAMILY) and a 
  160.    batch file (FHS.BAT) is created in the main directory of the hard 
  161.    disk to make it easier getting into the system.
  162.  
  163.    If you are installing the programs on a hard disk then place this 
  164.    diskette in the "A" drive of your PC and enter:
  165.            A>INSTALL HD x yyyy
  166.    where "x" is the letter you use to designate your hard disk 
  167.    (usually "C") and yyyy=ZERO if you found it necessary to enter the 
  168.    ZERO command before running the programs (see TRYING OUT THE 
  169.    PROGRAMS above).  After the installation is complete, you may start 
  170.    the system by changing the default drive to the hard disk and 
  171.    entering  "fhs"  (without the quotes) in response to the DOS 
  172.    prompt.  (The compiled version of the programs can "co-exist" with 
  173.    the interpreted version in the same sub-directory...of course you 
  174.    will use separate commands to start them.  Once you determine that 
  175.    the compiled version works correctly on your equipment, you will 
  176.    probably want to remove the interpreted version from your hard disk 
  177.    by deleting all of the files in your \FAMILY directory with a 
  178.    suffix of ".BAS".)
  179.  
  180.    If you are installing the programs on a floppy diskette, you must 
  181.    first format a diskette by placing your DOS diskette (which 
  182.    contains the FORMAT command) in the "A" drive of your PC and 
  183.    entering one of the following:
  184.          A>format b:/s   (if the diskette is to be "bootable")
  185.     or   A>format b:     (if you want more room on the diskette for 
  186.                          data)
  187.    You will be asked to place the diskette that is to contain the 
  188.    programs in the "B" drive.  Make sure that you don't want to save 
  189.    anything on the diskette that you use as all previous contents will 
  190.    be lost...If you are not creating a "bootable" diskette, then you 
  191.    should also copy COMMAND.COM from your DOS diskette to the newly 
  192.    formatted program diskette before continuing with the INSTALL 
  193.    procedure.  This will avoid a message prompting you to insert a 
  194.    diskette with COMMAND.COM on it when you terminate a FHS session.
  195.  
  196.    After formatting the diskette, label it "Family History System 
  197.    Program diskette", then place the distribution diskette in the "A" 
  198.    drive and enter:
  199.               A>INSTALL FD xxxx
  200.    where xxxx=ZERO if you found it necessary to enter the ZERO command 
  201.    before running the programs (see TRYING OUT THE PROGRAMS above).  
  202.    After the installation is complete, you may start up the system by 
  203.    placing the new Family History System Program diskette in the "A" 
  204.    drive and entering: A>fhs (or by pressing CTRL+ALT+DEL if you 
  205.    formatted a "bootable" program diskette).
  206.  
  207.    (Note: With the current and subsequent updates to the compiled set 
  208.    of programs, the total size of the program files and QuickBASIC 
  209.    runtime support has grown to the point that, depending on the 
  210.    version of DOS that you use, there may be insufficient space on a 
  211.    360k diskette to create a "bootable" program diskette.  If you get 
  212.    a message such as:
  213.                 "Insufficient Disk space to copy...."
  214.    during the installation procedure, then reformat the new program 
  215.    diskette without the "/s" option and retry the INSTALL procedure.)
  216.  
  217. I hope you enjoy using the programs.  Please let me know if you have 
  218. any problems or if you have suggestions for improvement.
  219.