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