*0111                      GENE-PAF PROGRAM HELP
  
 INTRODUCTION:
 The GENE-PAF program may be used to select/sort/display/output PAF data.
 You will need all the PAF generated files to execute GENE-PAF.
 The introductory screens give some information and limitations of the program.
 The user selects the routine he wants to execute from the TOP MENU.
 He is then directed through a series of sub-menus to set options and make
 selections. Normally when the program is initiated the outputs are directed
 to the monitor only.  However, the user may select output options to:
    1. Print outputs (to a printer which MUST BE ON-LINE)
    2. File outputs to an ASCII file for later editing and printing.
    3. Save some outputs to a file for import to a database or spreadsheet.
 To activate these options, you select 8 Output Options from the TOP MENU and
 the OUTPUT OPTIONS menu will appear from which you can set the desired
 outputs.  The "Print" and "File" are toggled between OFF -  ON 80 Column
 (standard width) - ON 130 Column (wide print).  Any one, or all of the output
 options can be chosen before the "Go" routine is executed.  Nevertheless,
 the results are always displayed on the monitor.
 Some GENE-PAF routines will allow the user to output notes for individuals
 from the PAF files.  This is also set from the OUTPUT OPTIONS menu.
                                   - MORE -
*02
GENERAL COMMENTS:
 The GENE-PAF program and a PAF database files may be copied using the DOS
 commands COPY or DISKCOPY.  When copying the GENE-PAF program the
 following files must be copied:
     GENE-PAF.EXE  The executable program, executed by typing GENE-PAF <Enter>
     GENE-PAF.CFN  The configuration and menu statements file
     GENE-PAF.HLP  This GENE-PAF help file.
 The README.COM text file, and the REGISTER.G-P file may also be copied
 but are not required for the GENE-PAF program.
 PAF files used are: NAMEADD2.DAT  PAF name address file.
                     REPTITL2.DAT  PAF report title file.
                     NAME2.DAT     PAF names file.
                     INDIV2.DAT    PAF individual file
                     MARR2.DAT     PAF marriage file
                     NOTES2.DAT    PAF note file
 
If the program quits during execution it will display an error message.  To
determine the nature of the error, check a BASIC programming manual or the
POWER-BASIC manual if one is available, for the meaning of the error message.
                            
                            - MORE -
*03
 GENERAL COMMENTS (cont.):
 Some frequently used abbreviations in this Help file and in the program:
   PAF  - Personal Ancestral File program and database
   RIN  - The (PAF) Record Identification Number for individuals
   MRIN - The (PAF) Marriage Record Identification Number; PMRIN = Parent MRIN 
   DOB  - date of birth.. /b/   ;or DOCH   - date of christening.. /c/
   PlDOB- Place of DOB          ;or PlDOCH - place of christening
   DOD  - date of death.. /d/   ;or DOBU   - date of burial....... /u/
   PlDOD- Place of DOD          ;or PlDOBU - place of burial
   DOM  - Marriage date   [date modifiers are AB=about, AF=after, BE=before]
   IDN  - Identification number 
 Single entry responses to a prompt or menu select in GENE-PAF do not
 require the use of the <Retrn> or <Enter> key.
 
 At many of the menus, sub-menus and prompts you may enter <Q>, <0>, or
 <Esc> to return to the previous menu.
 
 You may print any monitor screen displayed during program execution by
 pressing <Shift> and <PrtSc> simultaneously, provided the printer is on-line.
 
  ### - You may want to return to DOS and Print this GENE-PAF.HLP file.  ###
*04
 TOP MENU comments:
    After the introductory screens, the TOP MENU will be displayed.  At
 TOP MENU you have ten choices.  To make a choice you can move the "bar" to
 your choice, using the up/down cursors, and press Enter/Retrn or you may
 simply press the number or letter associated with the choice.  The letter
 associated with the choice is the capitalized letter on the menu but the
 choice is not upper case / lower case sensitive.
 When you move the "bar" to your choice the prompt line at the top of the
 screen will give you more information about the routine before it is executed
 by your pressing Enter/Retrn, the number or letter.
 
 1 Anhentafel... a routine to create an Ahnentafel beginning with the name
      for the Record Identification Number (RIN) you input.  The routine will
      help you find the RIN if you know the approximate RIN or the name.
 2 Children... a routine to find and list the children and grandchildren
      of an individual.  Birth dates, death dates and marriage dates may also
      be included if selected with the (6) Format routine.  RIN input required.
 3 Roots...  a routine to find father roots or mother roots or make picture
      labels.  The roots routines trace ancestors and spouses by fathers or
      mothers, whichever you select.   RIN input required.   [ more page 6 ]
                             - MORE -
*05
 TOP MENU comments (cont.):
 4 Identify... a routine to identify commanilaty of records.  You may find
     individuals in the PAF data that have common names or birthdates.
     You may also find names and MRINs by inputting the RIN. [ more page 7 ]
 5 Parents... a routine to find the parents and grandparents of an indiv-
     idual.  RIN input required.
 6 Format outputs... a routine used to set the formats for some of the
     routines. i.e. Surname First or Last; RIN, DOB, DOD, Place, MRIN
     and IDentification number may be turned ON/OFF.
 7 Select/Sort... the routine which allows the selection of PAF
     data with certain characteristics (i. e. male only, female only,
     living etc.) and then determine the order of fields of data to be
     displayed/printed/saved, and then set the fields on which the data
     will to be sorted.  [ See page 9 for more information ]
 8 Output options...  an Output Options menu is displayed to allow the
     setting of printer (on/off), saving data to a File for later editing
     & printing (on/off), Save file for import to database or spreadsheet
     (on/off), turn notes to output (on/off), make monitor color changes and
     Order the output headings before the <GO> is executed.  [ more page 10 ]
 9 Help... call up this GENE-PAF help file.
 0 Quit... quit program and return to DOS.
*06
 ROOTS routines:
 When you select 3 Roots at TOP MENU you will be directed to a sub-menu where
 you must select (F)ather Roots  OR  (M)other roots OR (P)icture labels.
 Other sub-menus/prompts require answers to:
    * (A)hnentafel, (S)equential or (N)o numbering of the Individuals on the
      outputs.
  *** Other output formats (Surname <F>irst or <L>ast, Place ON/OFF) are set
      by returning to the "4 Format output" routine before executing ROOTS.
 
 Ahnentafel or sequential selection then prompts for a starting number. This
 is a number added before each name. The default is 1 but other numbers are
 allowed in case you want to continue a ROOTS listing from a listing prepared
 earlier and want to continue with the same numbering sequence.

 With Roots, as with some of the other routines, you may print outputs to the
 printer, save outputs to an ASCII data file (GENE-PAF.OUT), or both.
 You also have the option to select all notes or only those with unique
 (flagged) identity.  Notes will be printed for all men only in the Father
 Roots routine and for all women only in the Mother Roots routine.
 These options are all set by going to the OUTPUT OPTIONS menu prior to
 executing the Roots routine.
*07
 Identify routines:
 When you select 4 Identify at TOP MENU you are directed to a sub-menu where
 you can select one of several methods for identifying records in PAF data:
   1 (N)ame selection will prompt you to input a name search string (any
     sequence of alphabetic characters) which may be in the PAF individual
     data. The search will find the first such occurrance and then prompt
     to (1) continue the search for another, (2) print the output to 
     printer before continuing,  (3) print the output to printer then quit,
     or (4) quit the search.  The name search is not upper/lower case
     sensitive.
   2 (D)ate selection will prompt you to select date-of-birth, date-of-death,
     or both and then the year, month, and day to search for.  You can make
     "00" entries if any year, or any month, or any day is desired.  The first
     RIN-Name-DOB-DOD-MRIN is displayed which has a matching date and you can
     continue to search for others or quit.
   3 (R)IN selection will prompt you for the input RIN and then the name data
     associated with that RIN will be displayed.
 
 
                             - MORE -
 
*08
 Identify routines (cont.):
   4 (L)ist selection will prompt you to input a starting RIN. At this prompt,
     as with many other routine first prompts, the output formats which you
     can change are displayed. You may select "F" to jump to Format outputs 
     and change the outputs.  If you do not want to change output formats you
     will be prompted for the ending RIN after you have made you starting
     RIN selection.   The routine will then display all the individual records
     (RIN-Name-DOB-MRIN) between the two RINs, a page at a time, until all
     have been displayed.  If Notes are  turned "ON", then they too will be
     output.
   5 (P)rint notes selection will prompt you to input the starting RIN and
     ending RIN.  This routine will then display only the notes associated
     with the range of RINs.  The select Notes from the OUTPUT OPTIONS
     menu must first have been turned ON. If you did not, the program will
     move you to the OUTPUT OPTIONS menu to do this.  At the OUTPUT OPTIONS
     menu you can select to print ALL notes or only those with the special
     tags (1, 2, 3,...up to 6 different tags are allowed) you specify.
 
 All the outputs from the subroutines in the Identify routine will be printed
 and/or saved to an ASCII file if the options are turned "ON" at the OUTPUT
 OPTIONS menu prior to running Identify.
*09
 SELECT/SORT routine:
 When you select 7 SELECT/SORT at TOP MENU you will enter the routine that 
 will let you select PAF records by all, living, male, female, dates,
 state, range of RINs, etc.).   
 After you have decided which records will be selected you must then decide
 how you want to sort the records.  A sub-menu will allow you to choose
 sorting by Name alphabeticallly, by RIN, by DOB or MRIN (first marriage).
 
 You are then returned to the OUTPUT OPTIONS menu where you can make
 selections as to where the outputs will go...i e to monitor screen only,
 to printer, to files (ASCII or Spreadsheet) or combination of these.
 You will also be able to change the order of the output column headings,
 by selecting <7> or <O> from the OUTPUT OPTIONS menu.  This will allow you
 to set the order for both the 80-column and 130-column outputs (i e  RIN,
 Name-surname first or last, DOB, PlDOB, DOD, MRIN, etc.) to any order you
 prefer. This is useful for making lists or tables of your PAF data.
 By turning "ON" 3 Save at the Output Options Menu, you will create a
 comma deliminated data file (GENE-PAF.DTA) which can be Import to a
 spreadsheet like Lotus 1-2-3 or Quattro-Pro or to a database like
 DBIII or Foxbase for further sorting, processing or manipulation.

*10
 OUTPUT OPTIONS menu comments:
 At the OUTPUT OPTIONS menu you can make choices as to what will be included
 in the outputs and where the outputs will go.   If you select the default
 <9 Go>, and you have already made a <7 Select/Sort> choice, the program will 
 execute the select/sort and output the results using the default or previously
 selected settings. If you have not made the <7 Select/Sort>  choice and you
 execute <9 Go> you will be returned to the TOP MENU to make a choice.
 At the OUTPUT OPTIONS menu you can take the following actions:
  1 Print... will toggle the printer 80 column print - 130 column print - Off.
  2 File... will toggle data to an ASCII file (GENE-PAF.OUT) 80 column -
    130 column - Off.   Data will be appended to the file (GENE-PAF.OUT)
    if it already exists.
  3 Save... will toggle between On - Off the saving (appending) of the 130
    column data to a comma deliminated data file (GENE-PAF.DTA) to be used for
    import to a spreadsheet or database program.
  4 Notes...will, for most routines, cause notes on individuals to be printed
    after  the name data is output.  You are directed to a sub-menu where
    you choose selection of ALL notes or only those with special tags.
    If your PAF notes data is stored with special tags (such as !, #, %,
    ADDR:, PHON:, SOUR:, EDUCATION:, OCCUPATION:, etc.) then you may use this  
    feature to print only those notes with your special tags.
*11
  5 Color...will let you set the color of you monitor forground/background.
    The colors you set when running GENE-PAF are saved to the configuration
    file and will be activated the next time you execute GENE-PAF.
  6 Return...will return you to the TOP MENU.
  7 Order...will allow you to arrange the order (column headings) of the 
    outputs. You are directed to a sub-menu where you can select from two
    default settings for the 80 column and/or 130 column outputs, or you may
    create the order of the outputs as you desire.  As you create your order
    the fields to be output and the number of characters required for each will
    be displayed.  If you select fields which exceed the number allowed (80 or
    130) the routine will erase what you have selected and prompt you to try 
    again. 
  8 Help...will call up this HELP file.
  9 Go...will execute the program (or return to the TOP MENU if the Select/Sort
    option was not selected before coming to the OUTPUT OPTIONS menu).
    The program will select the records you want, sort them as you had
    specified, and then output the results in the order and to where you
    specified.
  0 Quit...exits the GENE-PAF program and returns to DOS.

 -------> You may want to return to DOS and Print this file GENE-PAF.HLP <---
*12
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
*13
 
 
 
page   1st line (each page is 22 lines)
1        1   Introduction
2       23   General comments
3       45   General comments (cont)
4       67   TOP MENU comments
5       89   TOP MENU comments (cont)
6      111   ROOTs routines
7      133   Identify routines
8      155   Identify routines (cont)
9      177   Select/Order/Sort
10     199   Output Options
11     221   Output Options (cont)
12     243
13     265
 
 
 
