home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 5 / DATAFILE_PDCD5.iso / education / b / family / !Family / !Help < prev    next >
Text File  |  1994-09-19  |  26KB  |  559 lines
  1. !Family - Family tree editor  v2.07 (19 Sep 1994)
  2.  
  3. Denis Howe <dbh@doc.ic.ac.uk>
  4.  
  5. This program is Copyright 1993, 1994 Denis Howe.  You may
  6. distribute verbatim or modified copies of this program
  7. provided each such copy is distributed with a copyright
  8. notice and distribution conditions identical to these.
  9.  
  10. !Family is a RISC OS 3 application for editing and printing family trees.
  11. It displays a graphical representation of all the descendents of a given
  12. person on the screen or a printer and provides a simple system of menus and
  13. dialogue boxes to allow you to move around the tree and modify it.  You can
  14. store collections of related people in files in the standard GEDCOM
  15. genealogical data format.
  16.  
  17. This program requires RISC OS 3.
  18.  
  19. The latest version of this program should be available from the e-mail
  20. server at archive-server@micros.hensa.ac.uk (send message 'help') or by
  21. FTP to micros.hensa.ac.uk (148.88.8.84).  It usually finds its way to
  22. the Stuttgart FTP server and the Arcade BBS as well.
  23.  
  24. Getting started
  25. ===============
  26. When you run !Family the Main window appears.  It will be empty until
  27. there is a 'current person'.  There are two menus, one obtained by clicking
  28. the MENU button over the main window and the other over the icon bar icon.
  29. To create a person, follow the Goto⇨ item in the window menu (shortcut F5).
  30. Enter a new name and that person will then become the current person.  The
  31. current person's name appears in the window menu in place of the 'Person'
  32. item.  This menu item is referred to as <person>⇨ below.
  33.  
  34. Main window
  35. ===========
  36. The main window shows the 'current tree'.  This is centred on the current
  37. person and includes his* father (or his mother if his father is not known),
  38. all his spouses and children and their spouses and children and so on.
  39. There is only one main window so you can only edit one file with each
  40. invocation of !Family though you can run multiple invocations and you can
  41. store any number of trees in one file.
  42.  
  43. * Here and elsewhere, the male is assumed to embrace the female.
  44.  
  45. Each person's full name is shown if the "Choices⇨Show⇨Family name" option
  46. is ticked (see "Choices" below).  If it is off and their family name is the
  47. same as their father's and he is also shown, then the family name is
  48. omitted.  In other words, the family name is only shown for the first male
  49. ancestor with that name.  The name is coloured blue for males, red for
  50. females and green for unknown sex (but always black when printing).
  51.  
  52. The date of each person's birth and death are shown under their name,
  53. separated by a dash (-).  A "?" is displayed if the date of birth is not
  54. known but nothing is shown for an unknown date of death (the person may
  55. still be alive).  If the "Choices⇨Show⇨Year only" option is ticked then
  56. only the last group of digits of a date is shown.  If the
  57. "Choices⇨Show⇨Dates" option is off then no dates are displayed at all.  The
  58. birth and death fields may contain any text but for GEDCOM (see below)
  59. compatibility they should look like "15 OCT 1960", possibly preceded by
  60. ABT, AFT, BEF, EST for about, after, before or estimated.
  61.  
  62. Below the dates are the person's spouses with an "=" over each one.
  63. Multiple spouses are placed side by side with a number after the "=".  If
  64. a spouse's parents are known they are not displayed but a "+" is appended
  65. to the spouse's name to show that there is more information available.
  66. Similarly, if the spouse has other marriages a "+" is appended to the "=".
  67.  
  68. Any offspring are spread horizontally beneath the appropriate spouse,
  69. connected to the spouse by lines.  Children whose other parent is unknown
  70. appear beneath an "invisible spouse" which is numbered consecutively with
  71. any known spouses.
  72.  
  73. !Family can store and display, uncommon relationships such as a man
  74. marrying his aunt (or his mother!) and even impossible relationships.  Each
  75. person can appear in any number of postions but they will only appear once
  76. in each "rôle": father, mother, child or spouse.  So, for (an extreme)
  77. example, if someone is entered as their own father they will appear once as
  78. a father and once as a son.  Spouses are assumed to be of different sexes,
  79. fathers are male, mothers are female.  If these restrictions cause problems
  80. you can always create copies of the same person with different names (eg.
  81. by adding [1], [2] after the names) and add appropriate notes (see below).
  82.  
  83. The main window's title shows the file currently being edited, if any,
  84. followed by a "*" if the data has been modified since it was last saved.
  85. If you close the main window with ADJUST and a file is currently loaded
  86. then a directory display will be opened on the directory containing the
  87. file.  Closing the window does not discard any data.  Clicking SELECT over
  88. the bar icon will re-open the main window and the Notes windows (see
  89. below).
  90.  
  91. Setting the current person
  92. ==========================
  93. The current person is set either by clicking SELECT in the main window,
  94. in which case the nearest person to the pointer becomes the current person,
  95. or using the Goto⇨ menu item, which is also the way to display a person
  96. not in the current tree or create a new person not related to any existing
  97. person.
  98.  
  99. Adding a new person
  100. ===================
  101. You can add a new person simply by entering a new name in any icon that
  102. accepts names, ie. Name, Goto, Marry, Mother or Father (see below).  If you
  103. create a person with Goto then they will be completely unrelated to any
  104. known person.  You can connect them later as described below.  A single
  105. file may contain any number of disconnected trees of one or more people but
  106. you will only be able to see one tree at a time.  You must use Goto to
  107. switch between them.
  108.  
  109. Changing a person's name, sex, dates or parents
  110. ===============================================
  111. Clicking MENU over a person and following the <person>⇨Edit menu item leads
  112. to the Edit dialogue box.  This can also be opened by clicking ADJUST
  113. over a person or by typing control-E to edit the current person.  This
  114. shows that person's current name, sex, dates, mother and father, and allows
  115. you to change them.
  116.  
  117. Hit (⇧)Tab to move (up)down to the next field or use the up and down arrow
  118. keys or the mouse to move between fields.  Control-S toggles the sex.  The
  119. person's details are updated when you hit Return in any field or click the
  120. OK icon.
  121.  
  122. Note that the only way to change a person's name is by editing the name
  123. field in that person's own edit box.  For example, if you create Robert and
  124. then, in an Edit box for his son John, you notice that you spelt Robert's
  125. name wrong, you cannot correct it by editing John's father field.  That
  126. would give John a different father.  You must open an Edit box for Robert
  127. and change his name field there.  All references to him will then change
  128. as well.  Similarly, you cannot edit a different person by entering their
  129. name in the Name field of John's Edit box.  That will change John's name
  130. and details.
  131.  
  132. If you change someone's sex, you may also have to change the sex of their
  133. spouses and swap the parents of their children. 
  134.  
  135. Name completion
  136. ===============
  137. In any dialogue box icon where you can enter a name you can get name
  138. completion by hitting the F1 key.  This will search for all known people
  139. of the appropriate sex, whose names begin with the characters typed so far,
  140. if any.  If there is no match you will hear a beep.  A single match
  141. replaces the contents of the icon.  Multiple matches, up to a maximum of
  142. MaxComp% (default 20), are displayed in the 'Completions window'.  If all
  143. matches share more initial letters than just the given string these will be
  144. added to the icon.
  145.  
  146. Clicking SELECT over a name in the Completions window will enter that name
  147. in the icon where F1 was hit.  Alternatively, you can type more characters
  148. to reduce the number of matches and hit F1 again.
  149.  
  150. For example, you might type  F F1  and get Freddy, Frederick, Fritz and
  151. Ferdinand in the Completions window.  If you then type  r e F1  only
  152. Freddy and Frederick would be shown and the icon would contain "Fred".
  153.  
  154. Note that matching is exact so you must get punctuation and case right.
  155. It is a good idea to use completion whenever you enter a name to ensure
  156. that you don't accidentally create two entri