home *** CD-ROM | disk | FTP | other *** search
/ CD-ROM Aktief 1995 #3 / CDA3.iso / genealog / pafctool.zip / README < prev   
Text File  |  1992-09-03  |  4KB  |  85 lines
  1.  
  2.  
  3.                 PAFCTOOL
  4.             PAF Tools with C source Code
  5.  
  6.                 by Stephen A. Wood
  7.                 saw@cebaf.gov
  8.                 September 3, 1992
  9.  
  10. PAFCTOOL is a collection of "Free" PAF utilities and their C source code
  11. that work with PAF version 2.2.  Read the file LICENSE for the conditions
  12. under which this software may be used.
  13.  
  14. At the moment there are three utilities in this collection of PAF tools.  It
  15. is my hope that providing the source code will encourage others to create
  16. other "Free" utilities.
  17.  
  18. The utilities NOTEDUMP and NUPDATE are used together to dump all the notes
  19. from a PAF database into a single ASCII file, allowing them to be edited with
  20. any text editor, and then read back into the PAF database, replacing the
  21. existing notes with the edited notes.
  22.  
  23. The program ALIVE is a crude attempt to print out the birthdays of everyone
  24. in a PAF database who is alive.  This it does if the person has no death date
  25. recorded and they are not too old.  The output can be used with the program
  26. PCAL to get birthdays printed on the Postscript calendars made by PCAL.  ALIVE
  27. could clearly be modified to produce output suitable for other calendar
  28. programs that may exist.  ALIVE tries to guess what the last name of a married
  29. woman is, putting the maiden name in brackets.  If a woman has been married
  30. several times, it may guess wrong as to which is the current marriage, so may
  31. get the last name wrong.  It does not check marriage dates.  (Of course it
  32. won't know when a woman has not changed her name to her spouse.)
  33.  
  34. -----
  35.  
  36. Very briefly, here is what you should do if you want to use the NOTEDUMP
  37. and NUPDATE programs to edit PAF notes.
  38.  
  39. 1. Make a backup of your paf database.
  40.  
  41. 2.  From the directory that contains the paf database, type
  42.  
  43.     NOTEDUMP > PAF.NOT
  44.  
  45. 3.  Edit the notes.  The format should be clear.  Don't mess with the lines
  46. that begin with % that surround each note.  You can entirely remove the
  47. % lines and note for a given person though, then when you read this note
  48. file back in, that person simply will not be updated.
  49.  
  50. 4.  After you have finished editing the notes to your satisfaction, type the
  51. following
  52.  
  53.     NUPDATE < PAF.NOT
  54.  
  55. That will update all the notes with the notes in PAF.NOT.  NUPDATE will
  56. make backup copies of NOTES2.DAT and INDIV2.DAT, the only two files that
  57. it modifies.
  58.  
  59.  
  60. NOTEDUMP has some options.  Normally it only writes out note entry for those
  61. individuals that have notes in the paf database.  If you use the -e option,
  62. it will write out an entry for every individual.  You can then use an
  63. editor to insert note material for anyone in the database.
  64.  
  65. The -a option will append the various name, place and date information that
  66. is contained in the paf database onto the end of the note material.  As an
  67. example of how this can be useful, I often put information that I have
  68. gotten from the IGI or Ancestral file into a PAF database.  (separate from
  69. my family database).  The IGI or AF data often contains duplicate entrys
  70. for individuals which have different event dates.  If I just do a merge
  71. of these individuals in PAF, I can loose some of the conflicting information
  72. and what sources it came from.  By using the -a option I can get all that
  73. data put into notes.  Then when the various records for an individual get
  74. merged, the various dates and their sources are recorded in notes.
  75.  
  76. I find that in using these tools, I go back and forth between PAF and the
  77. text editor.  If you use the -a option, it only makes sense to use it the
  78. first time that you do a NOTEDUMP.
  79.  
  80. Please bear in mind that you can trash your paf database if you are not
  81. careful.  I am pretty confident that things are OK if the tools are used
  82. properly, but always be careful.
  83.  
  84. _________________________________________________________________________
  85.