
                            CFR HELP INDEX                 Page #
       ============================================================
          What this Program Can Do  ........................   2
          Warning  .........................................   3
          Introduction  ....................................   4
          Program Default Screen ...........................   5
          Cross Reference Screen  ..........................   8
          What if PAF Information is Different .............   8
          Need TO Add Screen  ..............................   9
          LOG File  ........................................   9
          CFR.DEF File  ....................................  10
          How Program Works  ...............................  19
          What If Errors Occur  ............................  21

                                  Page 1




WHAT this PROGRAM CAN DO:

          The purpose of this program is to allow a much more convenient
     method to find differences and make changes for the data files created
     by the Personal Ancestral File program (PAF).  PAF is a copyrighted
     program of The Corporation of the President of The Church of Jesus
     Christ of Latter-day Saints.  I will refer to this program as PAF from
     this point on.

          This program allows the computer to do much of the work of
     comparing two different Genealogical data bases.  The amount of
     information compared within both data bases is determined by the
     operator.  The choices are; 1. Direct line, ancestors only, 2. All
     lines, Ancestors & Decedents except multiple marriages.  If the
     individual, marriage or notes are different the differences are

                                  Page 2


     [ displayed on the screen (optional see CFR.DEF file) ] and printed in
     a document file or printer.
          To compare multiple marriages rerun the program using the nonancestral
     spouse as the first individual.
          This program does not allow the use of external note file pointed
     to by the ID# Record entry. (See PAF documentation)

WARNING:
     TRY NOT TO DO THIS!!! use Ctrl-Break or turn the power off
          with in the program this may results in loss of your
          data files.  The program will not process a Ctrl-Break
          until the program is at a safe point.

     INSTEAD DO THIS!!!  If you want to stop use Function Key 3
          as provided within the program.

                                  Page 3


     I DO Not take responsibility for any data LOSS caused by the use of
        this program!  I have made a sincere effort to eliminate these type
        of error.  But the possibility of errors does exist.

INTRODUCTION:

          My brother and I decided to provide our brothers and sisters with
     all the genealogical information we have assembled for our family.  We
     became very frustrated trying to compare and combine our two data
     bases and keep them up dated as well as trying to keep the rest of the
     family updated with all the changes.  With the current PAF software it
     became necessary to reprint almost all the information and
     redistribute it to the family.  This program allows us to only reprint
     the pages that have information that is changed and not just because
     one of the RIN's or MRIN's numbers have changed.
                                  Page 4



PROGRAM DEFAULT screen:
     1. Specify SOURCE #1 drive:[path] :
        Source #1 is the data file that you originally had.  This option
        allows you to change the drive and/or sub-directory from which the
        SOURCE #1 information comes from and which.  The default for this
        value in the CFR.DEF file.

     2. Specify SOURCE #2 drive:[path] :
        Source #2 is the data file that you just received and want to check
        for differences.  This option allows you to change the drive and/or
        sub-directory from which the information to be compared with the
        SOURCE #1 data files.  The default for this value in the CFR.DEF
        file.

     For 1 & 2:  Acceptable examples are as follows.  "c",  "c:",
        "c:\GEN",  "c:\GEN\"
                                  Page 5


     3. Log File ........ <NUL>,<PRN>,<drive:[path]CFRLOG> :
        This option is very useful for documenting any changes you need to
        make to the SOURCE #1 data base.  These differences would be any
        Individual, Marriage or Notes that need to be changed or added.  It
        also includes RIN, MRIN and the things that are different.  In the
        case of notes that need to be added they need to be edited using
        PAF note editor.  The default for this value is in the CFR.DEF
        file.

     4. First Individual Source #1 & #2 ............ RIN # :
        This is the RIN's numbers for the individual that the comparison
        process start with.  You must use PAF to manually find this
        individual in both data bases and enter the RIN's here.  See
        Comparison method to determine how comparison goes form here.

                                  Page 6



     5. Comparison method ... :
        This option allows the user to compare and SOURCE #2 all or just
        one line in there ancestry.  The choices are; Ancestors, All
        (Ancestors and Decedents of the First Individual).  The starting
        person is defined by the person in the above option.  Note that the
        individuals spouses lines are not compared in the Direct line
        option.

     6. Continue:
        This is the option that is used to proceed with execution of the
        program

     7. Quit:
        No explanation necessary

                                  Page 7



CROSS REFERENCE screen:

          In some cases enough information is not available for the program
     to determine if a person or marriage is the same.  In these cases it
     displays all the available information about the person or marriage
     and a pop up screen will ask if they are the same and show you the
     possibilities you have to chose form.  You tell the computer they are
     the same by pressing a "y" or "n".

WHAT if PAF INFORMATION is DIFFERENT:
          A switch in the CFR.DEF file determines if the program displays
     every difference on the screen.  Aut0='N' will display each individual
     and marriage that is different on the screen.  Pressing any key will
     continue program execution.  Aut0='Y' will disable this option.  In
     ether case more detailed information will be written to the log file.
                                  Page 8



NEED TO ADD screen:

          In the case where an individual, marriage or note is not present
     in the SOURCE #1 file a pop up question will tell you that you need to
     add the person, individual or note.  You tell the computer it okay to
     progress by pressing any key.  This will never happen if Aut0='Y' they
     are automaticly added.

LOG file:
          A log file has been added for convenience.  This file tell of all
     the difference the program found between the two files.  It also
     contains information about each data file.  The total number of
     individuals, marriages compared.  It lists all the individuals,
     marriages that need to be added.  The order that information is
     presented is the same order that it was executed.

                                  Page 9


CFR.DEF file:
     "This file is the default file for 640K machine"
     MAX NAME SIZE=7709
     MAX INDIVIDUAL SIZE = 32768
     MAX MARRIAGE SIZE = 15000
     NUMBER OF NOTE LINES = 100
     NUMBER OF HELP LINES = 402
     PATH1$=C:\GEN\DATA\
     PATH2$=C:\GEN\TEMP\
     AUT0 = Y
     LOG FILE=C:\GEN\MYPROG\COMPARE.LOG
     PRINT FAMILY TO DOC=N
     DISPLAY FREE MEMORY=Y
     STACK HISTORY=N
     LINES TO COMPARE=Ancestors
     SOURCE#1 FIRST RIN #=1
                                  Page 10


     SOURCE#2 FIRST RIN #=1
     BACKGROUND = Blue
     BORDER = Cyan
     TEXT = White
     TITLES = Magenta
     ERROR=Red
     CHOICE = Black

                                  Page 11










     MAX NAME SIZE:
        Is the maximum number of names that can be in the SOURCE #1 in the
        NAME2.DAT file plus new names added form SOURCE #2.  The value of
        this will very with computer configuration.  But must be less than
        7709 (uses 17 Bytes/name).

     MAX INDIVIDUAL SIZE:
        The maximum number of individuals that can be in the SOURCE #1 in
        the INDIV2.DAT files.  The value of this will very with computer
        configuration.  But must be less than 32,767.

     MAX MARRIAGE SIZE:
        The maximum number of marriages that can be in the SOURCE #1 in the
        MARR2.DAT files.  The value of this will very with computer
        configuration.  But must be less than 32,767.

                                  Page 12


     NUMBER OF NOTE LINES:
        This the maximum number of lines that can be displayed for any
        individuals note.  Decreasing this will free up memory for other
        things.
     NUMBER OF HELP LINES:
        This the maximum number of lines that can be displayed when F1 is
        pressed.  Decreasing the number of help lines to 1 will free up the
        memory used by this file thus freing memory for other things.
     PATH1$:
        Specify SOURCE #1 drive:[path] :
        Source #1 is the data file that you originally had.  This option
        allows you to change the drive and/or sub-directory from which the
        SOURCE #1 information comes from and which.  The default for this
        value in the CFR.DEF file.

                                  Page 13



     PATH2$:
        Specify SOURCE #2 drive:[path] :
        Source #2 is the data file that you just received and want to check
        for differences.  This option allows you to change the drive and/or
        sub-directory from which the information to be compared with the
        SOURCE #1 data files.  The default for this value in the CFR.DEF
        file.
     AUT0:
        Y = Differences are not displayed on the screen
        N = Differences are displayed on the screen

     LOG FILE:
        <NUL>,<PRN>,<drive:[path]CFRLOG> :
        This option is very useful for documenting any changes you need to
        make to the SOURCE #1 data base.  These differences would be

                                  Page 14


        any Individual, Marriage or Notes that need to be changed or added.
        It also includes RIN, MRIN and the things that are different.  In
        the case of notes that need to be added they need to be edited
        using PAF note editor.  The default for this value is in the
        CFR.DEF file.

     PRINT FAMILY TO DOC:
        Used for debugging the program.  Prints all the members of each
        family into the Log file.

     DISPLAY FREE MEMORY:
        Top left hand corner will show number of bytes left  for entries
        from NAME2.DAT then the rest of space for all other arrays.  Also
        in the top right hand corner the average length of all name entries
        will be displayed.  "Y" or "N" or "y"  or "n"

                                  Page 15


     STACK HISTORY:
        Used for debugging the program.  Prints all marriages as they are
        pushed and poped form the stack into the 'stack.his' file.
     LINES TO COMPARE:
        Ancestors(Direct line only):
        This option allows the user to compare and SOURCE #2 all or just
        one line in there ancestry.  The starting person is defined by the
        person in the above option.  Note that the and spouse of the first
        Individual and spouses of children are not compared in the Direct
        line option. !!! Ancestors only works in this Version.!!!
     SOURCE#x FIRST RIN #S:
        This is the RIN # for the SOURCE #1 and SOURCE #2 Individual that
        the comparison process start with.  In the Direct line only mode
        comparison goes back from this individual.  Where as in the All
        Lines mode comparison goes up and down all lines from here.

                                    Page 16


     BACKGROUND:  Color of the background.  See following chart.

     BORDER:   Color of the screen border.  See following chart.

     TEXT:  Color of the Text.  See following chart.

     TITLES:  Color of the Title.  See following chart.

     ERROR:  Color of the Error message.  See following chart.

     CHOICE:  Color of the prompt requiring a response. See chart.

                                  Page 17








                     Valid Colors

            ================================
               Black,         Gray
               Blue,          Bright Blue
               Green,         Bright Green
               Cyan,          Bright Cyan
               Red,           Bright Red
               Magenta,       Bright Magenta
               Brown,         Yellow
               White,         Bright White



                                  Page 18


HOW the PROGRAM WORKS:

             Direct line only method is as follows.  A individual is chosen
        his parents marriage is compared and all of the siblings are
        compared at this time also.  The parents are then placed in the
        position of the first individual and the cycle is repeated again.
        Progression goes from Child to Father up the paternal line until
        the end of the line is reached.  Then it steps back to mother and
        up her paternal line and so forth.  Children's spouses and their
        lines are not compared.

             All lines is similar to direct line only except the lines of
        the children's spouses are also put in to the compare sequence.

                                  Page 19




        The maximum number of Names is defined by MAX NAME  SIZE in
        CFR.DEF.  Note program will stop if string memory is used up.  The
        maximum number of Individuals is MAX SIZE in CFR.DEF.  The maximum
        number of Marriages is MAX SIZE/2 in CFR.DEF.

             It should also be noted that the base RIN is assumed to be 0.
        This is also the case with the base MRIN is assumed to be 0 as well
        as the Volume number is also 0.

             Note that if a birthday is not present the Christening Date
        then the Death date and finally the Burial date is used for cross
        referencing.

             The program doesn't differentiate between names that are upper
        case and those and those that are lower case.

                                  Page 20


WHAT IF ERRORS OCCUR:

     Out of memory errors as you start the program:
        If you start the program and get an out of memory error try the
        following;  1. Reduce the size of 'MAX NAME SIZE', 'MAX INDIVIDUAL
        SIZE' 'MAX MARRIAGE SIZE' they still must fit requirements defined
        above.  2. Reduce the 'NUMBER OF NOTE LINES' this may make the
        program crash if you have a note for an individual more than the
        number you defined.  3. Disable th help function by reducing
        'NUMBER OF HELP LINES' this make the program crash if you press F1.
        Start with step 1 and progress until the program will run.

     File not found error or invalid path statement:
        This will occur if you have defined the 'PATH1$' or 'PATH2$'
        incorrectly.  It could also happen if the CFR.DEF is not in the
                                  Page 21



      default directory.  Ether change the default directory or execute the
        program as "CFR d:\correct path\CFR.DEF".  Note this allows you to
        have several default file and you can choose which you can run
        with.

          I would be interested if anyone finds errors in this program.
     Please send me a copy of the log file, and the two sets of PAF data
     files and the 'STACK.HIS'.  Then I possibly can recreate the error and
     correct it.

                               Ernest Esplin
                               131 Briarwood
                           Versailles Ky.  40383

                                  Page 22
