home *** CD-ROM | disk | FTP | other *** search
/ Amiga Format 69 / af069sub.adf / Scion / Scion.doc < prev    next >
Text File  |  1978-02-03  |  166KB  |  4,279 lines
  1.  
  2.  
  3.  
  4. ----------------------------------------------------------------------------------
  5. Main
  6. ----------------------------------------------------------------------------------
  7.               Welcome to the Scion Genealogist 3.13 AmigaGuide®
  8.  
  9.      'Programme Overview     '            'Free-form Notes        '
  10.      'Personal Details Window'            'Viewing Pictures       '
  11.      'Personal Window Gadgets'            'ARexx Interface        '
  12.      'Family Details Window  '            'Hints, Tips & Questions'
  13.      'Family Window Gadgets  '            'LDS Compatibility      '
  14.      'Project Menu           '            'Programme Specification'
  15.      'Print Menu             '            'Version Information    '
  16.      'Prefs Menu             '            'Credits                '
  17.      'Extras Menu            '            'Errors Messages        '
  18.  
  19.  
  20. ----------------------------------------------------------------------------------
  21. CompleteIndex
  22. ----------------------------------------------------------------------------------
  23.  
  24.     '' About...
  25.     '' Add Child Gadget
  26.     '' Add New Person Gadget
  27.     '' Add People
  28.     '' AmigaGuide® Help
  29.     '' AmigaGuide® Help: Arrow Keys
  30.     '' AmigaGuide® Help: Buttons
  31.     '' AmigaGuide® Help: Environment Variables
  32.     '' AmigaGuide® Help: Function Keys
  33.     '' AmigaGuide® Help: Keystrokes
  34.     '' AmigaGuide® Help: Menus
  35.     '' AmigaGuide® Help: Mouse
  36.     '' ARexx Interface
  37.     '' Ancestors Gadget
  38.  
  39.     '' Child List
  40.     '' Choose Editor
  41.     '' Choose Viewer
  42.     '' Colours
  43.     '' Credits
  44.  
  45.     '' Dates
  46.     '' Delete Person Gadget
  47.     '' Descendants Gadget
  48.     '' Dissolve Family Gadget
  49.  
  50.     '' EXISTFAMILY
  51.     '' EXISTPERSON
  52.     '' Entering and Editing Family Information
  53.     '' Entering and Editing Personal Information
  54.     '' Error Messages
  55.     '' Exchange Gadget
  56.     '' Extras Menu
  57.  
  58.     '' Family Details Window
  59.     '' Family Details Window Gadgets
  60.     '' Family Group Record Number
  61.     '' Family List Gadget
  62.     '' Family Note Editor Gadget
  63.     '' Family Search Gadget
  64.     '' First Family Gadget
  65.     '' First Marriage Gadget
  66.     '' First Person Gadget
  67.     '' Free Form Notes
  68.  
  69.     '' GETBIRTHDATE
  70.     '' GETBIRTHPLACE
  71.     '' GETBURIALDATE
  72.     '' GETBURIALPLACE
  73.     '' GETCHILD
  74.     '' GETDBNAME
  75.     '' GETDEATHDATE
  76.     '' GETDEATHPLACE
  77.     '' GETFAMILYWIN
  78.     '' GETFAMLABEL
  79.     '' GETFAMUSER1
  80.     '' GETFAMUSER2
  81.     '' GETFIRSTNAME
  82.     '' GETLANGUAGE
  83.     '' GETLASTNAME
  84.     '' GETMARRIAGE
  85.     '' GETMARRYDATE
  86.     '' GETMARRYPLACE
  87.     '' GETPARENTS
  88.     '' GETPERSONWIN
  89.     '' GETPERSLABEL
  90.     '' GETPERSUSER1
  91.     '' GETPERSUSER2
  92.     '' GETPERSUSER3
  93.     '' GETPRINCIPAL
  94.     '' GETPROGVERSION
  95.     '' GETSEX
  96.     '' GETSPOUSE
  97.     '' GETTOTALFGRN
  98.     '' GETTOTALIRN
  99.     '' Go to Family Gadget
  100.     '' Go to Father Gadget
  101.     '' Go to Mother Gadget
  102.     '' Go to Person Gadget
  103.  
  104.     '' HELP
  105.     '' Hints, Tips & Questions
  106.  
  107.     '' Individual Record Number
  108.     '' Info...
  109.  
  110.     '' LDS Compatibility
  111.     '' Last Family Gadget
  112.     '' Last Marriage Gadget
  113.     '' Last Person Gadget
  114.     '' List Families Gadget
  115.     '' List Marriages Gadget
  116.     '' List People Gadget
  117.  
  118.     '' Navigating Around the Family Database
  119.     '' Navigating Around the Personal Database
  120.     '' New
  121.     '' New Marriage Gadget
  122.     '' Next Family Gadget
  123.     '' Next Marriage Gadget
  124.     '' Next Person Gadget
  125.  
  126.     '' Open...
  127.  
  128.     '' PUTBIRTHDATE
  129.     '' PUTBIRTHPLACE
  130.     '' PUTBURIALDATE
  131.     '' PUTBURIALPLACE
  132.     '' PUTCHILD
  133.     '' PUTDEATHDATE
  134.     '' PUTDEATHPLACE
  135.     '' PUTFAMLABEL
  136.     '' PUTFAMUSER1
  137.     '' PUTFAMUSER2
  138.     '' PUTFIRSTNAME
  139.     '' PUTLASTNAME
  140.     '' PUTMARRYDATE
  141.     '' PUTMARRYPLACE
  142.     '' PUTNEWFAMILY
  143.     '' PUTNEWPERSON
  144.     '' PUTPERSLABEL
  145.     '' PUTPERSUSER1
  146.     '' PUTPERSUSER2
  147.     '' PUTPERSUSER3
  148.     '' PUTSEX
  149.     '' PUTSPOUSE
  150.     '' Parents/Siblings Gadget
  151.     '' People List Gadget
  152.     '' Personal Details Window
  153.     '' Personal Details Window Gadgets
  154.     '' Personal Note Editor Gadget
  155.     '' Personal Search Gadget
  156.     '' Pick Gadget
  157.     '' Prefs Menu
  158.     '' Previous Family Gadget
  159.     '' Previous Marriage Gadget
  160.     '' Previous Person Gadget
  161.     '' Print Descendant Chart
  162.     '' Print Family Group Sheet
  163.     '' Print List of Families
  164.     '' Print List of People
  165.     '' Print Menu
  166.     '' Print Pedigree Chart
  167.     '' Print Personal Summary
  168.     '' Programme Overview
  169.     '' Programme Specification
  170.     '' Project Menu
  171.  
  172.     '' Quit
  173.  
  174.     '' Remove Child Gadget
  175.  
  176.     '' Save
  177.     '' Save As...
  178.     '' Search Wildcards
  179.     '' Select Child Gadget
  180.     '' Select FGRN Gadget
  181.     '' Select IRN Gadget
  182.     '' Select Principal Gadget
  183.     '' Select Spouse Gadget
  184.     '' Set 1st Marriage
  185.     '' Set Behaviour
  186.     '' Set Spouse Gadget
  187.     '' Set User Labels
  188.     '' Sorting On/Off
  189.     '' Spouse/Children Gadget
  190.  
  191.     '' Tested Editors
  192.  
  193.     '' Version Information
  194.     '' View Family Picture Gadget
  195.     '' View Personal Picture Gadget
  196.     '' Viewing Pictures
  197.  
  198.  
  199. ----------------------------------------------------------------------------------
  200. Help
  201. ----------------------------------------------------------------------------------
  202. You have reached this Help window by either clicking on the Help button or
  203. by hitting the Help key within the Scion Genealogist Help utility.  Unlike
  204. other help topics present in the Scion Help utility, the Help help topic
  205. opens its own window.  You must close this window by clicking on the close
  206. gadget or hitting escape before returning to the Scion help utility.  You
  207. cannot hit the Retrace button to return.
  208.  
  209. To quit the Scion Help utility, select Quit from the Project menu or click
  210. on the close gadget.  You may also hit escape.
  211.  
  212. Most help screens will display one or more buttons as part of the text.
  213. Clicking on these buttons will provide further information on the topic
  214. listed on the button.  You can also reach these help topics through the
  215. main Contents screen or one of its sub-screens.
  216.  
  217. While in the Scion Help utility, you may retrace your steps through the
  218. help screens you have selected by clicking on the Retrace button.
  219.  
  220. The Browse buttons will move you forward and backwards between help
  221. screens.
  222.  
  223.          'Detailed description of AmigaGuide® keys, buttons, etc'
  224.  
  225.  
  226. ----------------------------------------------------------------------------------
  227. GuideHelp
  228. ----------------------------------------------------------------------------------
  229.   'Buttons'
  230.   'Menus'
  231.   'Keystrokes'
  232.   'Mouse'
  233.   'Arrow Keys'
  234.   'Function Keys'
  235.   'Environment Variables'
  236.  
  237.  
  238. ----------------------------------------------------------------------------------
  239. HELP_BUTTONS
  240. ----------------------------------------------------------------------------------
  241. Contents - Display the Table of Contents document for the current database.
  242.    Index - Display the index document for the current database.
  243.     Help - Display the help document for the current database.  If the
  244.            database doesn't have a Help document of its own, then the
  245.            global Help database will be used instead.
  246.  Retrace - Go back to the previous node.
  247.   Browse - Step through the documents in sequential order, in the order
  248.            they appear in the database.
  249.  
  250.  
  251. ----------------------------------------------------------------------------------
  252. HELP_MENUS
  253. ----------------------------------------------------------------------------------
  254. Project
  255. -------
  256.              Print - Print the current document to the current print
  257.                      device.
  258.       Close Window - Close the active document window.
  259.               Quit - Close all windows for the current database, and exit.
  260.  
  261. Edit
  262. ----
  263.               Mark - Start marking a block of text for copying to the
  264.                      clipboard.
  265.               Copy - Copy the current document to the clipboard.
  266.         Select All - Select all the lines of the current document.
  267.     Clear Selected - Unselect all the lines of the current document.
  268.     Print Selected - Print the selected lines to the current print device.
  269.  
  270. Navigation
  271. ----------
  272.   Find Document... - Locate a document.
  273.       Find Text... - Locate all occurrences of text within the current
  274.                      document.
  275.          Find Next - Show the Find Text document.
  276.       Set Bookmark - Save the current location to the bookmark file.
  277.     Go To Bookmark - Go to the location indicated by the bookmark file.
  278.  
  279.  
  280. ----------------------------------------------------------------------------------
  281. HELP_KEYSTROKES
  282. ----------------------------------------------------------------------------------
  283.          TAB - Cycle forward through the buttons.
  284.    Shift-TAB - Cycle backwards through the buttons.
  285.         HELP - Display this document in its own window.
  286.          ESC - Close the active AmigaGuide® window.
  287.    Backspace - Scroll backwards a page.
  288.       RETURN - Activate the default button (the highlighted one).
  289. Shift-RETURN - Activate the default button (the highlighted one).
  290.                If it is a document, then load it in a new window.
  291.        SPACE - Scroll forwards a page.
  292.            > - Go to the end of the current document.
  293.            < - Go to the beginning of the current document.
  294.  
  295.  
  296. ----------------------------------------------------------------------------------
  297. HELP_ARROWS
  298. ----------------------------------------------------------------------------------
  299.          Up - Scroll up through the document.
  300.        Down - Scroll down through the document.
  301.    Shift-Up - Go up a page in the document.
  302.  Shift-Down - Go down a page in the document.
  303.      Alt-Up - Go to the beginning of the document.
  304.    Alt-Down - Go to the end of the document.
  305.        Left - Scroll left through the document.
  306.       Right - Scroll right through the document.
  307.  Shift-Left - Scroll left one window-full through the document.
  308. Shift-Right - Scroll right one window-full through the document.
  309.    Alt-Left - Go to the extreme left of the document.
  310.   Alt-Right - Go to the extreme right of the document.
  311.  
  312.  
  313. ----------------------------------------------------------------------------------
  314. HELP_FUNCTION
  315. ----------------------------------------------------------------------------------
  316.  F9 - Activate Next Window.
  317. F10 - Cycle active AmigaGuide® window front to back.
  318.  
  319.  
  320. ----------------------------------------------------------------------------------
  321. HELP_MOUSE
  322. ----------------------------------------------------------------------------------
  323.       Select - Over a node, will activate the node.
  324. Shift-Select - Over a node, will activate the node.  If it is a document,
  325.                then load the document in a new window.
  326.  
  327.  
  328. ----------------------------------------------------------------------------------
  329. HELP_VARS
  330. ----------------------------------------------------------------------------------
  331. Use the DOS command, SetEnv to set any of the following variables.
  332.  
  333.  AmigaGuide/Path
  334.   This variable contains the list of path names that AmigaGuide®
  335.   should search through when it attempts to open a database.
  336.  
  337.   For example:
  338.  
  339.     SetEnv AmigaGuide/Path "Workbench:Autodocs Workbench:Includes"
  340.  
  341.  
  342.  AmigaGuide/Pens
  343.   Gives you control over the colors that AmigaGuide® uses to
  344.   render the text and link points with.
  345.  
  346.     SetEnv AmigaGuide/Pens <abcdefgh>
  347.  
  348.   where:
  349.  
  350.     a = Background pen
  351.     b = Button text pen
  352.     c = Button background pen
  353.     d = Highlighted button text pen
  354.     e = Highlighted button background pen
  355.     f = Outline pen
  356.     g = Highlight outline pen
  357.     h = Text on background pen
  358.  
  359.   For example:
  360.  
  361.     SetEnv AmigaGuide/Pens 21213001
  362.     SetEnv AmigaGuide/Text BOLD
  363.  
  364.   will give a very sharp look.
  365.  
  366.  AmigaGuide/Text
  367.   Enables you to determine what the link points look like.
  368.  
  369.     SetEnv AmigaGuide/Text <style>
  370.  
  371.   where style can be one of the following:
  372.  
  373.     BUTTON
  374.     HIGHLIGHT
  375.     UNDERLINE
  376.     BOLD
  377.     ITALIC
  378.  
  379.  
  380. ----------------------------------------------------------------------------------
  381. Overview
  382. ----------------------------------------------------------------------------------
  383.                            PROGRAMME OVERVIEW
  384.  
  385.       PREPARE!   PREPARE!   PREPARE!   PREPARE!   PREPARE!   PREPARE!
  386.  
  387.       Make sure that you have ALL possible information available
  388.       before you start (with all the inter-personal and family relations
  389.       sorted out). It will make things MUCH easier if you have a good
  390.       idea what you are planning to do before you start!
  391.  
  392. The programme is based on two windows, the 'Personal Details Window'
  393. and the 'Family Details Window'.
  394.  
  395. The Personal Details Window is used to enter and/or edit details about the
  396. people that make up the database, and the Family Details Window is used to
  397. establish the family relationships between these people.
  398.  
  399. Details on the various people making up the database should be entered
  400. FIRST and then the relationships between them can be established.
  401.  
  402. Scion Genealogist has been written in a totally non-sexist and secular
  403. manner, has no checking on sex (to allow for "unconventional"
  404. relationships), and has no name checking (to allow for adopted children).
  405. Because of the non-sexist nature of the programme, the partners of a family
  406. group (or marriage) are referred to as "Principal" and "Spouse". Either
  407. partner can be the Principal. However, to conform with genealogical
  408. conventions, when reports are printed the male partner is automatically
  409. "promoted" to Principal and male parents are displayed first.
  410.  
  411. Every person and family in the database is identified by a unique number:
  412.  
  413. 'IRN - Individual Record Number'      'FGRN - Family Group Record Number'
  414.  
  415.  
  416.  
  417. ----------------------------------------------------------------------------------
  418. PersonalWindow
  419. ----------------------------------------------------------------------------------
  420.                         PERSONAL DETAILS WINDOW
  421.  
  422. The Personal Details Window is used to enter and/or edit details about the
  423. people that make up the database.
  424.  
  425. Details on the various people making up the database should be entered
  426. FIRST and then the relationships between them can be established.
  427.  
  428. If, at any time, the Personal Details Window you move to has all the fields
  429. "ghosted", this means that somebody's record has been deleted from the
  430. database. What you are seeing is the position that was "reserved" for that
  431. person, and this will be reassigned when a new person is added to the
  432. database. Just step over the disabled window using the usual gadgets.
  433.  
  434.              'Entering and Editing Personal Information'
  435.              'Navigating Around the Personal Database  '
  436.              'Personal Details Window Gadgets          '
  437.  
  438.  
  439. ----------------------------------------------------------------------------------
  440. PersonalEdit
  441. ----------------------------------------------------------------------------------
  442.                Entering and Editing Personal Information
  443.  
  444. When a new person is added to the database (by clicking the mouse on the
  445. 'Add New Person' gadget) or when an existing database is opened, the
  446. Personal Details Window displayed is where information about each person
  447. may be edited or added.
  448.  
  449. To enter or edit information in a particular field, just click on that
  450. field. For example, to enter the birth date just click on the Birth Date
  451. field and then type in the date.  Pressing RETURN or TAB will automatically
  452. take you to the next field (in this example, the Birth Place field).
  453. Pressing Shift-TAB will take you to the preceding field. See also 'Dates'.
  454.  
  455. To reduce the amount of typing required, and to help ensure that Last Names
  456. are consistent, use the 'Pick' gadget located beside the Last Name entry
  457. field. Select (from the list displayed) the Last Name that you want entered
  458. into the Last Name field.
  459.  
  460. See also "Carry-over last names" under 'Set Behaviour'.
  461.  
  462.  
  463. ----------------------------------------------------------------------------------
  464. DateField
  465. ----------------------------------------------------------------------------------
  466. All date fields are "free form" fields, to allow for entries such as
  467. "About 1983", and NO checking is carried out on the date entered. However,
  468. it is strongly recommended that you enter dates in the format
  469. "3 Jan 1956". Do NOT use dates such as "3/1/56".  This could mean either
  470. 3 January 1956 or 1 March 1956. Equally it could mean 1856 and not 1956.
  471.  
  472. Date fields are limited to 12 characters which enforces the use of the
  473. genealogical convention of using three character names for the months.
  474. For example, Jan, Feb, Mar, Apr....
  475.  
  476. Again to conform to general convention, the date field could contain one
  477. of the following "modifiers":
  478.  
  479.     Bef (or Before)        Actual date is before the given date
  480.     Abt (or About)        Actual date is approximately the given date
  481.     Aft (or After)        Actual date is after the given date.
  482.  
  483. Where an event date is known to be within a range (such as between 1876
  484. and 1879), enter the FIRST date in the appropriate date field, and make
  485. a note in the "comments" field about the possible range.
  486.  
  487. Where an event date is uncertain or unverified, add a question mark as
  488. the last character of the date. For example, 5 Jun 1974?
  489.  
  490. If this convention is adhered to, Scion Genealogist will list the children
  491. of a family group sorted by date of birth.
  492.  
  493. Examples:
  494.     23 Jan 1873
  495.     About 1923
  496.     Aft 1907
  497.     4 Apr 1765?    (Unverified/uncertain date "format")
  498.     1945        (Comment: Date between 1945 and 1947)
  499.     Before 1987
  500.  
  501.  
  502. ----------------------------------------------------------------------------------
  503. PickName
  504. ----------------------------------------------------------------------------------
  505.                              "Pick" Gadget
  506.             (Located to the right of the Last Name entry field)
  507.  
  508. Every time that the <RETURN> key is pressed while in the Last Name entry
  509. field, that last name is checked against a list of names maintained in the
  510. "Last Name Pick List". If the current name is unique, it is added to that
  511. pick list. This list maintains the 8 most recent unique last names entered.
  512.  
  513. To transfer a last name from the pick list into the Last Name entry field,
  514. simply click on the appropriate name in the list. That name will then be
  515. transferred into the Last Name field where it may be accepted or edited.
  516.  
  517. This reduces the amount of typing required, and also ensures consistent
  518. spelling of last names.
  519.  
  520. The keyboard shortcut for this gadget is "K" (not shown in gadget).
  521.  
  522.  
  523. ----------------------------------------------------------------------------------
  524. PersonalNavigation
  525. ----------------------------------------------------------------------------------
  526.                Navigating Around the Personal Database
  527.  
  528. The move around the Personal Database, use the "SELECT PERSON" gadgets:
  529.  
  530.      ' |« ' Select the first person (in IRN numerical order)
  531.      ' «« ' Select the previous person (in IRN numerical order)
  532.      'LIST' Display selection list of the people in the database
  533.      ' »» ' Select the next person (in IRN numerical order)
  534.      ' »| ' Select the last person (in IRN numerical order)
  535.  
  536. The IRN (Individual Record Number) of the currently displayed database
  537. entry is displayed at the bottom centre of the window.
  538.  
  539. To go directly to a particular person's record when their IRN is known,
  540. click on the '^' gadget at the bottom centre of the screen and type in
  541. the IRN for that person. (Remember to press <RETURN>)
  542.  
  543. To search for (and go to the entry for) a particular person in the
  544. database, the 'Personal Search' gadget can be used.
  545.  
  546. To locate a particular ancestor, and go to the entry for a particular
  547. ancestor, use the 'Anc' (Ancestors) gadget.
  548.  
  549. To locate a particular descendant, and go to the entry for a particular
  550. descendant, use the 'Desc' (Descendants) gadget.
  551.  
  552. To locate the current person's father, and go to his entry, use the
  553. 'Fath' (Father) gadget.
  554.  
  555. To locate the current person's mother, and go to her entry, use the
  556. 'Moth' (Mother) gadget.
  557.  
  558. To move to Family Details Windows, use the "SELECT FAMILY" gadgets:
  559.  
  560.      'Parents/Siblings' Select the person's parent's Family Details Window
  561.      'Spouse/Children ' Select the Family Details Window for the current
  562.                         person's first marriage
  563.      'Family List...  ' Select a family from a list of families
  564.      'Go to Family... ' Select a family using a known FGRN
  565.  
  566.  
  567. ----------------------------------------------------------------------------------
  568. PersonalGadgets
  569. ----------------------------------------------------------------------------------
  570.                         Personal Details Window Gadgets
  571.  
  572.   SELECT PERSON Gadgets
  573.    ' |« ' ' «« ' 'LIST' ' »» ' ' »| '
  574.  
  575.   TOOLS Gadgets           EDIT DATABASE Gadgets   SELECT FAMILY Gadgets
  576.    'Edit Notes      '      'Add New Person  '      'Parents/Siblings'
  577.    'View Picture    '      'Delete Person   '      'Spouse/Children '
  578.    'Personal Search '      'Set 1st Marriage'      'Family List...  '
  579.                                                    'Go to Family... '
  580.  
  581.   SELECT OTHER Gadgets                            IRN Gadget
  582.    'Anc' 'Desc' 'Fath' 'Moth'                        '^'
  583.  
  584.   Miscellaneous Gadgets
  585.    'Pick'
  586.  
  587.  
  588. ----------------------------------------------------------------------------------
  589. FirstPerson
  590. ----------------------------------------------------------------------------------
  591.                        "|«" (First Person) Gadget
  592.  
  593. Clicking on the "|«" (First Person) gadget will take you to the window for
  594. the first person in the database (in IRN numerical order).
  595.  
  596. If the "|«" (First Person) gadget is "ghosted" (shaded grey) it means that
  597. you are already at the first person in the database and the gadget will do
  598. nothing.
  599.  
  600.  
  601. ----------------------------------------------------------------------------------
  602. PrevPerson
  603. ----------------------------------------------------------------------------------
  604.                      "««" (Previous Person) Gadget
  605.  
  606. Clicking on the "««" (Previous Person) gadget will take you to the window
  607. for the preceding person (in IRN numerical order).
  608.  
  609. If the "««" (Previous Person) gadget is "ghosted" (shaded grey) it means
  610. that you are at the first person in the database and the gadget will do
  611. nothing.
  612.  
  613.  
  614. ----------------------------------------------------------------------------------
  615. ListPeople
  616. ----------------------------------------------------------------------------------
  617.                             List People Gadget
  618.  
  619. Clicking on the "LIST" gadget will display a list of every person in the
  620. database.
  621.  
  622. By default, the list of people is in IRN numerical order. If you would
  623. prefer the list to be in alphabetical order, before displaying the list,
  624. select 'Extras' from the menu bar and choose the 'Sorting On/Off'
  625. menu item.
  626.  
  627. If the lists are sorted, an [S] marker will be displayed in the window
  628. title bar. If the lists are not sorted, this marker will be absent.
  629.  
  630. If you are using a colour monitor, males will be displayed in blue and
  631. females will be displayed in red. If a person's sex has not been defined,
  632. their entry in the list will be displayed in yellow.
  633.  
  634. At the bottom of the list are two gadgets, a "cycle" gadget that displays
  635. either "Show All" or "Show only ->", and a string gadget labelled
  636. "Last Name". When the cycle gadget is displaying "Show All", the list
  637. displays all the people in the database. When the cycle gadget is
  638. displaying "Show only ->", the list displays only those people with the
  639. Last Name entered into the adjacent string gadget.
  640.  
  641. On first displaying a people list, the Last Name string gadget will contain
  642. "?*". This represents a 'Wildcard' matching ANY person in the database.
  643. In this (default) case, the "Show only ->" state of the cycle gadget will
  644. ALSO display every person in the database.
  645.  
  646. To display only those people with a last name of "SMITH", for example,
  647. enter the name "SMITH" into the string gadget and make sure the cycle
  648. gadget is set to "Show only ->". The list will then only display those
  649. people who have the word "SMITH" in their last name. Note that because of
  650. the wildcard matching, "SMITH" will also match with "SMITHSON",
  651. "BLACKSMITH", etc.
  652.  
  653. To display a particular person's Personal Details Window, simply click on
  654. that person in the list.  Selecting "Cancel" will return you to the
  655. original window.
  656.  
  657. The number displayed at the bottom centre of the Personal Details Window is
  658. the current IRN.
  659.  
  660. The keyboard shortcut for this gadget is "L".
  661.  
  662.  
  663. ----------------------------------------------------------------------------------
  664. NextPerson
  665. ----------------------------------------------------------------------------------
  666.                         "»»" (Next Person) Gadget
  667.  
  668. Clicking on the "»»" (Next Person) gadget will take you to the window for
  669. the next person (in IRN numerical order).
  670.  
  671. If the "»»" (Next Person) gadget is "ghosted" (shaded grey) it means that
  672. there are no more people in the database and the gadget will do nothing.
  673.  
  674.  
  675. ----------------------------------------------------------------------------------
  676. LastPerson
  677. ----------------------------------------------------------------------------------
  678.                        "»|" (Last Person) Gadget
  679.  
  680. Clicking on the "»|" (Last Person) gadget will take you to the window for
  681. the last person in the database (in IRN numerical order).
  682.  
  683. If the "»|" (Last Person) gadget is "ghosted" (shaded grey) it means that
  684. there are no more people in the database and the gadget will do nothing.
  685.  
  686.  
  687. ----------------------------------------------------------------------------------
  688. PersonEditor
  689. ----------------------------------------------------------------------------------
  690.                             Edit Notes Gadget
  691.  
  692. Clicking on the "Edit Notes" gadget will display a file requester where
  693. you can enter the name of the free-form note that you wish to edit. The
  694. editor that will be used is defined using the 'Choose Editor' option under
  695. the 'Prefs' menu.
  696.  
  697. By default the notes are assigned the name PNx.database, where "PN" stands
  698. for "Personal Notes", "x" is the IRN of the current person displayed, and
  699. "database" is the name of the database. The name of the database is defined
  700. when you save the database.
  701.  
  702. The default name can be ignored, and the notes file can be given any name.
  703. (Note that the "pattern" field in the file requester may have to be
  704. changed so that you can see files with other than the default names. Enter
  705. #? as the pattern to see ALL files.)
  706.  
  707. The keyboard shortcut for this gadget is "N".
  708.  
  709.  
  710. ----------------------------------------------------------------------------------
  711. ViewPerson
  712. ----------------------------------------------------------------------------------
  713.                             View Picture Gadget
  714.  
  715. Clicking on the "View Picture" gadget will display a file requester where
  716. you can enter the name of the IFF picture file that you wish to view. The
  717. viewer that will be used is defined using the 'Choose Viewer' option under
  718. the 'Prefs' menu.
  719.  
  720. By default the pictures are assigned the name PPx.database, where "PP"
  721. stands for "Personal Picture", "x" is the IRN of the current person
  722. displayed, and "database" is the name of the database. The name of the
  723. database is defined when you save the database.
  724.  
  725. The default name can be ignored, and the picture file can be given any
  726. name.  (Note that the "pattern" field in the file requester may have to be
  727. changed so that you can see files with other than the default names. Enter
  728. #? as the pattern to see ALL files.)
  729.  
  730. The keyboard shortcut for this gadget is "V".
  731.  
  732.  
  733. ----------------------------------------------------------------------------------
  734. PersonSearch
  735. ----------------------------------------------------------------------------------
  736.                            Personal Search gadget
  737.  
  738. This gadget allows you to search for a particular individual in the
  739. database.
  740.  
  741. After clicking on the "Personal Search" gadget you will be presented
  742. with a requester asking for "Last Name" and "First Names".  Type the
  743. name of the person you are trying to find into these fields, and then
  744. click on "Find First" to find (and display) the Personal Details
  745. Window for the first person in the database matching your entries.
  746.  
  747. If the name fields already contain the name(s) that you want (from a
  748. previous search) click on "Find Next" to move to the Personal Details
  749. Window for the next person in the database matching your entries, or
  750. click on "Find Prev" to move to the Personal Details Window for the
  751. previous person in the database matching your entries.
  752.  
  753. To "browse" the database for people with the same last name (for example),
  754. from the Personal details window (with no data entry field active)
  755. press "P" to bring up the search requester, and then either "N" or "P" to
  756. find the next or previous person with that same last name.
  757.  
  758. In this way, repeatedly pressing "P" then "N" will progressively display
  759. the next person in the database with the name of interest.
  760.  
  761. NOTE: This same technique may be used to "browse" families, but
  762.       the search will be initiated by pressing the "F" key (for
  763.       "Family Search", and then followed by "N" or "P".
  764.  
  765. On first starting the programme, the Last Name and First Name(s)
  766. fields will contain "?*". This represents a 'Wildcard' matching ANY
  767. person in the database. In this (default) case, clicking on "Find Next"
  768. will take you to the Personal Details Window for the next person in IRN
  769. numerical order.
  770.  
  771. If the screen flashes when carrying out a search, that means that there are
  772. no more matching entries in the database.
  773.  
  774. The keyboard shortcut for this gadget is "P".
  775.  
  776.  
  777.  
  778. ----------------------------------------------------------------------------------
  779. AddNewPerson
  780. ----------------------------------------------------------------------------------
  781.                           Add New Person Gadget
  782.  
  783. To add a new person to the database, click on the "Add New Person" gadget.
  784. After confirming that that is what you want to do, you will be presented
  785. with a blank Personal Details Window (assigned the next available IRN) and
  786. information about the new person can immediately be entered.
  787.  
  788. If the programme behaviour is set to "no confirmation" (using the
  789. "Confirm 'Add Person'" option), the programme will not ask to confirm the
  790. addition of the new person. See 'Set Behaviour'
  791.  
  792. The keyboard shortcut for this gadget is "A".
  793.  
  794.  
  795. ----------------------------------------------------------------------------------
  796. DeletePerson
  797. ----------------------------------------------------------------------------------
  798.                           Delete Person Gadget
  799.  
  800. To remove a person from the database, click on the "Delete Person" gadget.
  801. You will be asked to confirm your actions before the record is actually
  802. removed.  Not only will the person's Personal Details Window data be
  803. deleted, but ALL references to that person as a child of a family or a
  804. partner in a marriage will also be removed.  Any marriages that the person
  805. was a partner in will be dissolved, and the person will no longer be a
  806. parent of any of the children of that family group.
  807.  
  808. WARNING: Once you have removed a person from the database, their
  809.          information is irretrievably lost, and their IRN and
  810.          corresponding Personal Details Window are available for
  811.      reassignment.
  812.  
  813. The keyboard shortcut for this gadget is "D".
  814.  
  815.  
  816. ----------------------------------------------------------------------------------
  817. SetMarriage
  818. ----------------------------------------------------------------------------------
  819.                           Set 1st Marriage Gadget
  820.  
  821. If there are no marriages recorded for the current person, clicking on the
  822. "Set 1st Marriage" gadget will, after confirmation, create a family group
  823. corresponding to the first marriage of this person. A spouse and any
  824. children may then be added to the resulting family group.
  825.  
  826. If the gadget is "ghosted" (shaded grey) it means that the first marriage
  827. has already been established for this person and the gadget will do
  828. nothing. You can go to the Family Details Window for the (established)
  829. first marriage by clicking on the 'Spouse/Children' gadget.
  830.  
  831. The keyboard shortcut for this gadget is "M".
  832.  
  833.  
  834. ----------------------------------------------------------------------------------
  835. Parents
  836. ----------------------------------------------------------------------------------
  837.                         Parents/Siblings Gadget
  838.  
  839. Clicking on the "Parents/Siblings" gadget will take you to the Family
  840. Details Window for the person's parents where the person's siblings
  841. (brothers and sisters) are also displayed.
  842.  
  843. People have their parents established when a person is added to a family
  844. group as a child.
  845.  
  846. The keyboard shortcut for this gadget is "S".
  847.  
  848.  
  849. ----------------------------------------------------------------------------------
  850. SpouseKids
  851. ----------------------------------------------------------------------------------
  852.                         Spouse/Children Gadget
  853.  
  854. If a family group (marriage) is established for this person, clicking on
  855. this gadget will take you to the first Family Details Window for that
  856. person.
  857.  
  858. The keyboard shortcut for this gadget is "C".
  859.  
  860.  
  861. ----------------------------------------------------------------------------------
  862. FamilyList
  863. ----------------------------------------------------------------------------------
  864.                           Family List Gadget
  865.  
  866. Clicking on the "Family List..." gadget will display a list of every family
  867. in the database. The list of families is in FGRN numerical order.
  868.  
  869. At the bottom of the list are two gadgets, a "cycle" gadget that displays
  870. either "Show All" or "Show only ->", and a string gadget labelled
  871. "Last Name". When the cycle gadget is displaying "Show All", the list
  872. displays all the families in the database. When the cycle gadget is
  873. displaying "Show only ->", the list displays only those families in which
  874. one of the partners has the Last Name entered into the adjacent string
  875. gadget.
  876.  
  877. On first displaying a families list, the Last Name string gadget will
  878. contain "?*". This represents a 'Wildcard' matching ANY family partner
  879. in the database. In this (default) case, the "Show only ->" state of the
  880. cycle gadget will ALSO display every family in the database.
  881.  
  882. To display only those families where one of the partners has a last name
  883. of "SMITH", for example, enter the name "SMITH" into the string gadget
  884. and make sure the cycle gadget is set to "Show only ->". The list will
  885. then only display those families with a partner who has the word "SMITH"
  886. in their last name. Note that because of the wildcard matching, "SMITH"
  887. will also match with "SMITHSON", "BLACKSMITH", etc.
  888.  
  889. To display a particular family's Family Details Window, simply click on
  890. that family in the list.  Selecting "Cancel" will return you to the
  891. original window.
  892.  
  893. The keyboard shortcut for this gadget is "F".
  894.  
  895.  
  896. ----------------------------------------------------------------------------------
  897. GotoFamily
  898. ----------------------------------------------------------------------------------
  899.                         Go to Family Gadget
  900.  
  901. If the FGRN of a family of interest is known and you want to move directly
  902. to their Family Details Window, click on this gadget and type in the FGRN
  903. for that family. When  the <RETURN> key is pressed, the Family Details
  904. Window for that family will be displayed.
  905.  
  906. To return to the Personal Details Window for the current person, select
  907. the "Cancel" gadget.
  908.  
  909. The keyboard shortcut for this gadget is "G".
  910.  
  911.  
  912. ----------------------------------------------------------------------------------
  913. GotoFather
  914. ----------------------------------------------------------------------------------
  915.                            Go to Father Gadget
  916.  
  917. Clicking on the "Fath" gadget will move to the Personal Details Window
  918. for the father of the currently displayed person.
  919.  
  920. NOTE: If there is no father defined (only a mother), then clicking on
  921. this gadget will cause the screen to flash. Similarly, if the father's
  922. "sex" field does not contain an "M" (for male), clicking on this gadget
  923. cause the screen to flash.
  924.  
  925.  
  926. ----------------------------------------------------------------------------------
  927. GotoMother
  928. ----------------------------------------------------------------------------------
  929.                            Go to Mother Gadget
  930.  
  931. Clicking on the "Moth" gadget will move to the Personal Details Window
  932. for the mother of the currently displayed person.
  933.  
  934. NOTE: If there is no mother defined (only a father), then clicking on
  935. this gadget will cause the screen to flash. Similarly, if the mother's
  936. "sex" field does not contain an "F" (for female), clicking on this gadget
  937. cause the screen to flash.
  938.  
  939.  
  940. ----------------------------------------------------------------------------------
  941. Ancestors
  942. ----------------------------------------------------------------------------------
  943.                             Ancestors Gadget
  944.  
  945. Clicking on the "Anc" gadget will display an on-screen ancestor chart
  946. for the current person. To move to the Personal Details Window for a
  947. particular ancestor, click on their name in the ancestor chart. To return
  948. to the Personal Details Window for the current person, select the "Cancel"
  949. gadget.
  950.  
  951.  
  952. ----------------------------------------------------------------------------------
  953. DescList
  954. ----------------------------------------------------------------------------------
  955.                           Descendants Gadget
  956.  
  957. Clicking on the "Desc" gadget will display an on-screen descendant
  958. chart for the current person. To move to the Personal Details Window for
  959. a particular descendant, click on their name in the descendant chart. To
  960. return to the Personal Details Window for the current person, select the
  961. "Cancel" gadget.
  962.  
  963.  
  964. ----------------------------------------------------------------------------------
  965. WhatIRN
  966. ----------------------------------------------------------------------------------
  967.                           "^" Select IRN Gadget
  968.  
  969. If the IRN of a person of interest is known and you want to move directly
  970. to their Personal Details Window, click on this gadget and type in the IRN
  971. for that person. When  the <RETURN> key is pressed, the Personal Details
  972. Window for that person will be displayed.
  973.  
  974. To return to the Personal Details Window for the current person, select
  975. the "Cancel" gadget.
  976.  
  977.  
  978. ----------------------------------------------------------------------------------
  979. FamilyWindow
  980. ----------------------------------------------------------------------------------
  981.                            FAMILY DETAILS WINDOW
  982.  
  983. The Family Group Window displays the Principal, Spouse and children making
  984. up a family group and is where information about each family group may be
  985. edited or added.
  986.  
  987. When you select "Spouse/Children" or "Parents/Siblings" from a Personal
  988. Details Window, you will automatically change to the appropriate Family
  989. Details Window.
  990.  
  991. You will also automatically change to the appropriate Family Details
  992. Window when you create the first marriage for a person by selecting the
  993. "Set 1st Marriage" gadget.
  994.  
  995. NOTE: Details on the various people making up the database should be
  996.       entered FIRST and then the relationships between them can be
  997.       established.
  998.  
  999. If, at any time, the Family Details Window you move to has all the fields
  1000. "ghosted", this means that some family's record has been deleted from the
  1001. database. What you are seeing is the position that was "reserved" for that
  1002. family, and this will be reassigned when a new family is added to the
  1003. database. Just step over the disabled window using the usual gadgets.
  1004.  
  1005.               'Entering and Editing Family Information'
  1006.               'Navigating Around the Family Database  '
  1007.               'Family Details Window Gadgets          '
  1008.  
  1009.  
  1010. ----------------------------------------------------------------------------------
  1011. FamilyEdit
  1012. ----------------------------------------------------------------------------------
  1013.                  Entering and Editing Family Information
  1014.  
  1015. When a new family is added to the database or when an existing database is
  1016. opened, the Family Details Window is where information about each family
  1017. may be edited or added.
  1018.  
  1019. To enter or edit information in a particular field, just click on that
  1020. field. For example, to enter the wedding date just click on the Wedding
  1021. Date field and then type in the date.  Pressing RETURN or TAB will
  1022. automatically take you to the next field (in this example, the Wedding
  1023. Place field).  Pressing Shift-TAB will take you to the preceding field.
  1024.  
  1025. See also 'Dates'.
  1026.  
  1027.  
  1028. ----------------------------------------------------------------------------------
  1029. FamilyNavigation
  1030. ----------------------------------------------------------------------------------
  1031.                    Navigating Around the Family Database
  1032.  
  1033. The move around the Family Database, use the "SELECT MARRIAGE" and
  1034. "SELECT FAMILY" gadgets:
  1035.  
  1036.  SELECT MARRIAGE Gadgets:
  1037.      ' |« ' Select the first marriage of the current Principal
  1038.      ' «« ' Select the previous marriage of the current Principal
  1039.      'LIST' Display selection list of the marriages of current Principal
  1040.      ' »» ' Select the next marriage of the current Principal
  1041.      ' »| ' Select the last marriage of the current Principal
  1042.  
  1043.      'Exchange' Exchange Principal and Spouse
  1044.  
  1045.  SELECT FAMILY Gadgets:
  1046.      ' |« ' Select the first family (in FGRN numerical order)
  1047.      ' «« ' Select the previous family (in FGRN numerical order)
  1048.      'LIST' Display selection list of the families in the database
  1049.      ' »» ' Select the next family (in FGRN numerical order)
  1050.      ' »| ' Select the last family (in FGRN numerical order)
  1051.  
  1052. The FGRN (Family Group Record Number) of the currently displayed database
  1053. entry is displayed at the bottom centre of the window.
  1054.  
  1055. To go directly to a particular family's record when their FGRN is known,
  1056. click on the '^' gadget at the bottom centre of the screen and type in
  1057. the FGRN for that family. (Remember to press <RETURN>)
  1058.  
  1059. To search for (and go to the entry for) a particular family in the
  1060. database, the 'Family Search' gadget can be used.
  1061.  
  1062. To move to Personal Details Windows, use the "P" (Principal), "S" (Spouse),
  1063. "C" (Child), "People List..." and "Go to Person..." gadgets:
  1064.  
  1065.      'P' Select the current Principal's Personal Details Window
  1066.      'S' Select the current Spouse's Personal Details Window
  1067.      'C' Select the currently highlighted child's Personal Details Window
  1068.      'People List...' Select a person from a list of people
  1069.      'Go to Person..' Select a person using a known IRN
  1070.  
  1071. NOTE: If a family group is dissolved using the 'Dissolve Family' gadget,
  1072.       you will be returned to the Personal Details Window for the current
  1073.       Principal.
  1074.  
  1075.  
  1076. ----------------------------------------------------------------------------------
  1077. FamilyGadgets
  1078. ----------------------------------------------------------------------------------
  1079.                           Family Details Window Gadgets
  1080.  
  1081.   SELECT PERSON Gadgets     TOOLS Gadgets           EDIT DATABASE Gadgets
  1082.    'P' Select Principal      'Edit Notes      '      'Set Spouse      '
  1083.    'S' Select Spouse         'View Picture    '      'Add Child       '
  1084.    'C' Select Child          'Family Search   '      'Remove Child    '
  1085.    'People List...'                                  'Dissolve Family '
  1086.    'Go to Person..'                                  'New Marriage    '
  1087.  
  1088.   SELECT MARRIAGE Gadgets
  1089.    ' |« ' ' «« ' 'LIST' ' »» ' ' »| '
  1090.  
  1091.    'Exchange' Exchange Principal and Spouse
  1092.  
  1093.   SELECT FAMILY Gadgets
  1094.    ' |« ' ' «« ' 'LIST' ' »» ' ' »| '
  1095.  
  1096.   FGRN Gadget
  1097.    '^'
  1098.  
  1099.  
  1100. ----------------------------------------------------------------------------------
  1101. Principal
  1102. ----------------------------------------------------------------------------------
  1103.                        "P" (Select Principal) Gadget
  1104.  
  1105. Clicking on the "P" (Select Principal) gadget will take you to the Personal
  1106. Details Window for the Principal of the currently displayed family group.
  1107.  
  1108. The keyboard shortcut for this gadget is "P".
  1109.  
  1110.  
  1111. ----------------------------------------------------------------------------------
  1112. Spouse
  1113. ----------------------------------------------------------------------------------
  1114.                         "S" (Select Spouse) Gadget
  1115.  
  1116. Clicking on the "S" (Select Spouse) gadget will take you to the Personal
  1117. Details Window for the Spouse of the currently displayed family group.
  1118.  
  1119. The keyboard shortcut for this gadget is "S".
  1120.  
  1121.  
  1122. ----------------------------------------------------------------------------------
  1123. Child
  1124. ----------------------------------------------------------------------------------
  1125.                         "C" (Select Child) Gadget
  1126.  
  1127. Clicking on the "C" (Select Child) gadget will take you to the Personal
  1128. Details Window for the currently highlighted child of the currently
  1129. displayed family group.
  1130.  
  1131. To highlight a child, click on the child in the list immediately above the
  1132. "C" (Select Child) gadget. This child will then be displayed next to the
  1133. gadget.
  1134.  
  1135. If you are using a colour monitor, males will be displayed in blue and
  1136. females will be displayed in red. If a person's sex has not been defined,
  1137. their entry in the list will be displayed in yellow.
  1138.  
  1139. The keyboard shortcut for this gadget is "C".
  1140.  
  1141.  
  1142. ----------------------------------------------------------------------------------
  1143. ChildList
  1144. ----------------------------------------------------------------------------------
  1145.                               Child List
  1146.  
  1147. This area contains a list of all the children attached to this family
  1148. group sorted by date of birth. See also 'Dates'.
  1149.  
  1150. To highlight a child, click on the child in this list. The selected child
  1151. will then be displayed in the box immediately below this list. You can
  1152. then use the 'C' gadget to take you to the Personal Details Window for
  1153. the selected child.
  1154.  
  1155. Clicking on the 'Remove Child' gadget also allows you to remove the
  1156. selected child from the family group.
  1157.  
  1158. If you are using a colour monitor, males will be displayed in blue and
  1159. females will be displayed in red. If a person's sex has not been defined,
  1160. their entry in the list will be displayed in yellow.
  1161.  
  1162.  
  1163. ----------------------------------------------------------------------------------
  1164. Exchange
  1165. ----------------------------------------------------------------------------------
  1166.                             Exchange Gadget
  1167.           (Located to the right of the Principal & Spouse names)
  1168.  
  1169. Clicking on the Exchange gadget will exchange the Principal and Spouse
  1170. in the current Family Details window. By using this gadget, you can trace
  1171. the marriages of either partner in a family group.
  1172.  
  1173. The keyboard shortcut for this gadget is "X".
  1174.  
  1175.  
  1176. ----------------------------------------------------------------------------------
  1177. PeopleList
  1178. ----------------------------------------------------------------------------------
  1179.                            People List Gadget
  1180.  
  1181. Clicking on the "People List..." gadget will display a list of every person
  1182. in the database.
  1183.  
  1184. By default, the list of people is in IRN numerical order. If you would
  1185. prefer the list to be in alphabetical order, before displaying the list,
  1186. select 'Extras' from the menu bar and choose the 'Sorting On/Off'
  1187. menu item.
  1188.  
  1189. If the lists are sorted, an [S] marker will be displayed in the window
  1190. title bar. If the lists are not sorted, this marker will be absent.
  1191.  
  1192. If you are using a colour monitor, males will be displayed in blue and
  1193. females will be displayed in red. If a person's sex has not been defined,
  1194. their entry in the list will be displayed in yellow.
  1195.  
  1196. At the bottom of the list are two gadgets, a "cycle" gadget that displays
  1197. either "Show All" or "Show only ->", and a string gadget labelled
  1198. "Last Name". When the cycle gadget is displaying "Show All", the list
  1199. displays all the people in the database. When the cycle gadget is
  1200. displaying "Show only ->", the list displays only those people with the
  1201. Last Name entered into the adjacent string gadget.
  1202.  
  1203. On first displaying a people list, the Last Name string gadget will contain
  1204. "?*". This represents a 'Wildcard' matching ANY person in the database.
  1205. In this (default) case, the "Show only ->" state of the cycle gadget will
  1206. ALSO display every person in the database.
  1207.  
  1208. To display only those people with a last name of "SMITH", for example,
  1209. enter the name "SMITH" into the string gadget and make sure the cycle
  1210. gadget is set to "Show only ->". The list will then only display those
  1211. people who have the word "SMITH" in their last name. Note that because of
  1212. the wildcard matching, "SMITH" will also match with "SMITHSON",
  1213. "BLACKSMITH", etc.
  1214.  
  1215. To display a particular person's Personal Details Window, simply click on
  1216. that person in the list.  Selecting "Cancel" will return you to the
  1217. original window.
  1218.  
  1219. The keyboard shortcut for this gadget is "E".
  1220.  
  1221.  
  1222. ----------------------------------------------------------------------------------
  1223. GotoPerson
  1224. ----------------------------------------------------------------------------------
  1225.                         Go to Person Gadget
  1226.  
  1227. If the IRN of a person of interest is known and you want to move directly
  1228. to their Personal Details Window, click on this gadget and type in the IRN
  1229. for that person. When  the <RETURN> key is pressed, the Personal Details
  1230. Window for that person will be displayed.
  1231.  
  1232. To return to the Family Details Window for the current family, select
  1233. the "Cancel" gadget.
  1234.  
  1235. The keyboard shortcut for this gadget is "G".
  1236.  
  1237.  
  1238. ----------------------------------------------------------------------------------
  1239. FirstMarriage
  1240. ----------------------------------------------------------------------------------
  1241.                        "|«" (First Marriage) Gadget
  1242.  
  1243. Clicking on the "|«" (First Marriage) gadget will take you to the window
  1244. for the first marriage in the database for the current Principal.
  1245.  
  1246. If the "|«" (First Marriage) gadget is "ghosted" (shaded grey) it means
  1247. that you are already at the first marriage for the current Principal and
  1248. the gadget will do nothing.
  1249.  
  1250.  
  1251. ----------------------------------------------------------------------------------
  1252. PrevMarriage
  1253. ----------------------------------------------------------------------------------
  1254.                      "««" (Previous Marriage) Gadget
  1255.  
  1256. Clicking on the "««" (Previous Marriage) gadget will take you to the window
  1257. for the preceding Marriage of the current Principal.
  1258.  
  1259. If the "««" (Previous Marriage) gadget is "ghosted" (shaded grey) it means
  1260. that you are at the first marriage for the current Principal and the gadget
  1261. will do nothing.
  1262.  
  1263.  
  1264. ----------------------------------------------------------------------------------
  1265. ListMarriages
  1266. ----------------------------------------------------------------------------------
  1267.                           List Marriages Gadget
  1268.  
  1269. Clicking on the "LIST" gadget will display a list of the spouses of every
  1270. marriage in the database for the current Principal.
  1271.  
  1272. If you are using a colour monitor, male spouses will be displayed in blue
  1273. and female spouses will be displayed in red. If a spouse's sex has not been
  1274. defined, their entry in the list will be displayed in yellow.
  1275.  
  1276. To display a particular marriage's Family Details Window, simply click on
  1277. that marriage in the list.  Selecting "Cancel" will return you to the
  1278. original window.
  1279.  
  1280.  
  1281. ----------------------------------------------------------------------------------
  1282. NextMarriage
  1283. ----------------------------------------------------------------------------------
  1284.                         "»»" (Next Marriage) Gadget
  1285.  
  1286. Clicking on the "»»" (Next Marriage) gadget will take you to the window
  1287. for the next marriage of the current Principal.
  1288.  
  1289. If the "»»" (Next Marriage) gadget is "ghosted" (shaded grey) it means that
  1290. there are no more marriages for the current Principal and the gadget will
  1291. do nothing.
  1292.  
  1293.  
  1294. ----------------------------------------------------------------------------------
  1295. LastMarriage
  1296. ----------------------------------------------------------------------------------
  1297.                        "»|" (Last Marriage) Gadget
  1298.  
  1299. Clicking on the "»|" (Last Marriage) gadget will take you to the window for
  1300. the last marriage in the database for the current Principal.
  1301.  
  1302. If the "»|" (Last Marriage) gadget is "ghosted" (shaded grey) it means that
  1303. there are no more marriages for the current Principal and the gadget will
  1304. do nothing.
  1305.  
  1306.  
  1307.  
  1308. ----------------------------------------------------------------------------------
  1309. FirstFamily
  1310. ----------------------------------------------------------------------------------
  1311.                        "|«" (First Family) Gadget
  1312.  
  1313. Clicking on the "|«" (First Family) gadget will take you to the window for
  1314. the first family in the database (in FGRN numerical order).
  1315.  
  1316. If the "|«" (First Family) gadget is "ghosted" (shaded grey) it means that
  1317. you are already at the first family in the database and the gadget will do
  1318. nothing.
  1319.  
  1320.  
  1321. ----------------------------------------------------------------------------------
  1322. PrevFamily
  1323. ----------------------------------------------------------------------------------
  1324.                      "««" (Previous Family) Gadget
  1325.  
  1326. Clicking on the "««" (Previous Family) gadget will take you to the window
  1327. for the preceding family (in FGRN numerical order).
  1328.  
  1329. If the "««" (Previous Family) gadget is "ghosted" (shaded grey) it means
  1330. that you are at the first family in the database and the gadget will do
  1331. nothing.
  1332.  
  1333.  
  1334. ----------------------------------------------------------------------------------
  1335. WhatFGRN
  1336. ----------------------------------------------------------------------------------
  1337.                          "^" Select FGRN Gadget
  1338.  
  1339. If the FGRN of a family of interest is known and you want to move directly
  1340. to their Family Details Window, click on this gadget and type in the FGRN
  1341. for that family. When  the <RETURN> key is pressed, the Family Details
  1342. Window for that family will be displayed.
  1343.  
  1344. To return to the Family Details Window for the current family, select
  1345. the "Cancel" gadget.
  1346.  
  1347.  
  1348. ----------------------------------------------------------------------------------
  1349. ListFamilies
  1350. ----------------------------------------------------------------------------------
  1351.                             List Families Gadget
  1352.  
  1353. Clicking on the "LIST" gadget will display a list of every family in the
  1354. database. The list of families is in FGRN numerical order.
  1355.  
  1356. At the bottom of the list are two gadgets, a "cycle" gadget that displays
  1357. either "Show All" or "Show only ->", and a string gadget labelled
  1358. "Last Name". When the cycle gadget is displaying "Show All", the list
  1359. displays all the families in the database. When the cycle gadget is
  1360. displaying "Show only ->", the list displays only those families in which
  1361. one of the partners has the Last Name entered into the adjacent string
  1362. gadget.
  1363.  
  1364. On first displaying a families list, the Last Name string gadget will
  1365. contain "?*". This represents a 'Wildcard' matching ANY family partner
  1366. in the database. In this (default) case, the "Show only ->" state of the
  1367. cycle gadget will ALSO display every family in the database.
  1368.  
  1369. To display only those families where one of the partners has a last name
  1370. of "SMITH", for example, enter the name "SMITH" into the string gadget
  1371. and make sure the cycle gadget is set to "Show only ->". The list will
  1372. then only display those families with a partner who has the word "SMITH"
  1373. in their last name. Note that because of the wildcard matching, "SMITH"
  1374. will also match with "SMITHSON", "BLACKSMITH", etc.
  1375.  
  1376. To display a particular family's Family Details Window, simply click on
  1377. that family in the list.  Selecting "Cancel" will return you to the
  1378. original window.
  1379.  
  1380. The number displayed at the bottom centre of the Family Details Window is
  1381. the current FGRN.
  1382.  
  1383. The keyboard shortcut for this gadget is "L".
  1384.  
  1385.  
  1386. ----------------------------------------------------------------------------------
  1387. NextFamily
  1388. ----------------------------------------------------------------------------------
  1389.                         "»»" (Next Family) Gadget
  1390.  
  1391. Clicking on the "»»" (Next Family) gadget will take you to the window for
  1392. the next family (in FGRN numerical order).
  1393.  
  1394. If the "»»" (Next Family) gadget is "ghosted" (shaded grey) it means that
  1395. there are no more families in the database and the gadget will do nothing.
  1396.  
  1397.  
  1398. ----------------------------------------------------------------------------------
  1399. LastFamily
  1400. ----------------------------------------------------------------------------------
  1401.                        "»|" (Last Family) Gadget
  1402.  
  1403. Clicking on the "»|" (Last Family) gadget will take you to the window for
  1404. the last family in the database (in IRN numerical order).
  1405.  
  1406. If the "»|" (Last Family) gadget is "ghosted" (shaded grey) it means that
  1407. there are no more families in the database and the gadget will do nothing.
  1408.  
  1409.  
  1410. ----------------------------------------------------------------------------------
  1411. FamilyEditor
  1412. ----------------------------------------------------------------------------------
  1413.                             Edit Notes Gadget
  1414.  
  1415. Clicking on the "Edit Notes" gadget will display a file requester where
  1416. you can enter the name of the free-form note that you wish to edit. The
  1417. editor that will be used is defined using the 'Choose Editor' option under
  1418. the 'Prefs' menu.
  1419.  
  1420. By default the notes are assigned the name FNx.database, where "FN" stands
  1421. for "Family Notes", "x" is the FGRN of the current family displayed, and
  1422. "database" is the name of the database. The name of the database is defined
  1423. when you save the database.
  1424.  
  1425. The default name can be ignored, and the notes file can be given any name.
  1426. (Note that the "pattern" field in the file requester may have to be
  1427. changed so that you can see files with other than the default names. Enter
  1428. #? as the pattern to see ALL files.)
  1429.  
  1430. The keyboard shortcut for this gadget is "N".
  1431.  
  1432.  
  1433. ----------------------------------------------------------------------------------
  1434. ViewFamily
  1435. ----------------------------------------------------------------------------------
  1436.                             View Picture Gadget
  1437.  
  1438. Clicking on the "View Picture" gadget will display a file requester where
  1439. you can enter the name of the IFF picture file that you wish to view. The
  1440. viewer that will be used is defined using the 'Choose Viewer' option under
  1441. the 'Prefs' menu.
  1442.  
  1443. By default the pictures are assigned the name FPx.database, where "FP"
  1444. stands for "Family Picture", "x" is the FGRN of the current family
  1445. displayed, and "database" is the name of the database. The name of the
  1446. database is defined when you save the database.
  1447.  
  1448. The default name can be ignored, and the picture file can be given any
  1449. name.  (Note that the "pattern" field in the file requester may have to be
  1450. changed so that you can see files with other than the default names. Enter
  1451. #? as the pattern to see ALL files.)
  1452.  
  1453. The keyboard shortcut for this gadget is "V".
  1454.  
  1455.  
  1456. ----------------------------------------------------------------------------------
  1457. FamilySearch
  1458. ----------------------------------------------------------------------------------
  1459.                         Family Search gadget
  1460.  
  1461. This gadget allows you to search for a particular family in the database.
  1462.  
  1463. After clicking on the "Family Search" gadget you will be presented with a
  1464. requester asking for "Last Name" and "First Names" of one of the partners
  1465. in a marriage.  Type the name of the person whose marriages you are trying
  1466. to find into these fields, and then click on "Find First" to find (and
  1467. display) the Family Details Window for the first marriage in the database
  1468. matching your entries.
  1469.  
  1470. If the name fields already contain the name(s) that you want (from a
  1471. previous search) click on "Find Next" to move to the Family Details Window
  1472. for the next marriage in the database matching your entries, or click on
  1473. "Find Prev" to move to the Family Details Window for the previous marriage
  1474. in the database matching your entries.
  1475.  
  1476. To "browse" the database for families with the same spouse (for example),
  1477. from the Family details window (with no data entry field active)
  1478. press "F" to bring up the search requester, and then either "N" or "P" to
  1479. find the next or previous family with that same spouse.
  1480.  
  1481. In this way, repeatedly pressing "F" then "N" will progressively display
  1482. the next family in the database with the spouse of interest.
  1483.  
  1484. NOTE: This same technique may be used to "browse" people, but
  1485.       the search will be initiated by pressing the "P" key (for
  1486.       "Personal Search", and then followed by "N" or "P".
  1487.  
  1488. On first starting the programme, the Last Name and First Name(s)
  1489. fields will contain "?*". This represents a 'Wildcard' matching ANY
  1490. person in the database. In this (default) case, clicking on "Find Next"
  1491. will take you to the Family Details Window for the next marriage in FGRN
  1492. numerical order.
  1493.  
  1494. If the screen flashes when carrying out a search, that means that there are
  1495. no more matching entries in the database.
  1496.  
  1497. The keyboard shortcut for this gadget is "F".
  1498.  
  1499.  
  1500. ----------------------------------------------------------------------------------
  1501. AddSpouse
  1502. ----------------------------------------------------------------------------------
  1503.                               Set Spouse Gadget
  1504.  
  1505. To add a Spouse to a family group when there is no spouse already defined,
  1506. (thereby establishing a "marriage" between the Principal and the Spouse),
  1507. click on the "Set Spouse" gadget. A list of all the people in the
  1508. database will be displayed.
  1509.  
  1510.    If you are using a colour monitor, males will be displayed in blue and
  1511.    females will be displayed in red. If a person's sex has not been
  1512.    defined, their entry in the list will be displayed in yellow.
  1513.  
  1514.    At the bottom of the list are two gadgets, a "cycle" gadget that
  1515.    displays either "Show All" or "Show only ->", and a string gadget
  1516.    labelled "Last Name". When the cycle gadget is displaying "Show All",
  1517.    the list displays all the people in the database. When the cycle
  1518.    gadget is displaying "Show only ->", the list displays only those
  1519.    people with the Last Name entered into the adjacent string gadget.
  1520.  
  1521.    On first displaying a people list, the Last Name string gadget will
  1522.    contain "?*". This represents a 'Wildcard' matching ANY person in
  1523.    the database. In this (default) case, the "Show only ->" state of the
  1524.    cycle gadget will ALSO display every person in the database.
  1525.  
  1526.    To display only those people with a last name of "SMITH", for example,
  1527.    enter the name "SMITH" into the string gadget and make sure the cycle
  1528.    gadget is set to "Show only ->". The list will then only display those
  1529.    people who have the word "SMITH" in their last name. Note that because
  1530.    of the wildcard matching, "SMITH" will also match with "SMITHSON",
  1531.    "BLACKSMITH", etc.
  1532.  
  1533.    Click on the Spouse you wish to add to the family group. The selected
  1534.    Spouse will then be displayed near the top of the Family Details Window
  1535.    next to the "S" (Select Spouse) gadget.
  1536.  
  1537.    Selecting "Cancel" from the list of people displayed will abort this
  1538.    operation.
  1539.  
  1540. If there is already a spouse defined for the family group, and you wish
  1541. to delete or change that spouse (maybe you had the wrong person), clicking
  1542. on the "Set Spouse" gadget will ask if you wish to remove the existing
  1543. spouse and (optionally) replace with a new spouse. If you select "yes",
  1544. the existing spouse will be removed, a list of all the people in the
  1545. database will be displayed, and you can select the "replacement" spouse
  1546. as outlined above.
  1547.  
  1548. If, at this point, you select the "Cancel" gadget in the list of people,
  1549. the original spouse will have been removed (deleting them from the family
  1550. group).
  1551.  
  1552.    If you wish to re-instate a deleted spouse to the family group, click
  1553.    on the "Set Spouse" gadget again and add them to the family group
  1554.    as outlined above.
  1555.  
  1556. The keyboard shortcut for this gadget is "O".
  1557.  
  1558.  
  1559. ----------------------------------------------------------------------------------
  1560. AddChild
  1561. ----------------------------------------------------------------------------------
  1562.                              Add Child Gadget
  1563.  
  1564. To add a child to a family group (thereby establishing the Principal and
  1565. Spouse as the child's parents), click on the "Add Child" gadget. A list of
  1566. all the people in the database will be displayed.
  1567.  
  1568. If you are using a colour monitor, males will be displayed in blue and
  1569. females will be displayed in red. If a person's sex has not been defined,
  1570. their entry in the list will be displayed in yellow.
  1571.  
  1572. At the bottom of the list are two gadgets, a "cycle" gadget that displays
  1573. either "Show All" or "Show only ->", and a string gadget labelled
  1574. "Last Name". When the cycle gadget is displaying "Show All", the list
  1575. displays all the people in the database. When the cycle gadget is
  1576. displaying "Show only ->", the list displays only those people with the
  1577. Last Name entered into the adjacent string gadget.
  1578.  
  1579. On first displaying a people list, the Last Name string gadget will contain
  1580. "?*". This represents a 'Wildcard' matching ANY person in the database.
  1581. In this (default) case, the "Show only ->" state of the cycle gadget will
  1582. ALSO display every person in the database.
  1583.  
  1584. To display only those people with a last name of "SMITH", for example,
  1585. enter the name "SMITH" into the string gadget and make sure the cycle
  1586. gadget is set to "Show only ->". The list will then only display those
  1587. people who have the word "SMITH" in their last name. Note that because of
  1588. the wildcard matching, "SMITH" will also match with "SMITHSON",
  1589. "BLACKSMITH", etc.
  1590.  
  1591. Click on the child you wish to add to the family group. The selected child
  1592. will then be displayed at the bottom of the list of children immediately to
  1593. the left of this gadget.
  1594.  
  1595. Selecting "Cancel" from the list of people displayed will abort this
  1596. operation.
  1597.  
  1598. The keyboard shortcut for this gadget is "A".
  1599.  
  1600.  
  1601. ----------------------------------------------------------------------------------
  1602. RemoveChild
  1603. ----------------------------------------------------------------------------------
  1604.                            Remove Child Gadget
  1605.  
  1606. To remove a child from a family group:
  1607.  
  1608.     (1) Highlight the child to be removed by clicking on the chosen child
  1609.         from the list displayed immediately to the left of the "Remove
  1610.         Child" gadget. The selected child will then be displayed in the
  1611.     position below the list (next to the "C" gadget).
  1612.  
  1613.     (2) Click on the "Remove Child" gadget. You will be asked to confirm
  1614.         that you wish to remove the child from the family group. Replying
  1615.     "no" will cancel the operation. Replying "yes" will remove the
  1616.     child from the family group.
  1617.  
  1618. The child removed will become an "orphan".
  1619.  
  1620. The keyboard shortcut for this gadget is "R".
  1621.  
  1622.  
  1623. ----------------------------------------------------------------------------------
  1624. DissolveFamily
  1625. ----------------------------------------------------------------------------------
  1626.                           Dissolve Family Gadget
  1627.  
  1628. To remove a family from the database, click on the "Dissolve Family"
  1629. gadget.  You will be asked to confirm your actions before the record is
  1630. actually removed.  Not only will the family's Family Details Window data be
  1631. deleted, but ALL references to that family will also be removed. Children
  1632. specified as part of the family group will become "orphans", and the
  1633. original Principal and Spouse will be "divorced".
  1634.  
  1635. WARNING: Once you have removed a family from the database, the
  1636.          information is irretrievably lost, and the original FGRN and
  1637.          corresponding Family Details Window are available for
  1638.      reassignment.
  1639.  
  1640. The keyboard shortcut for this gadget is "D".
  1641.  
  1642.  
  1643. ----------------------------------------------------------------------------------
  1644. NewMarriage
  1645. ----------------------------------------------------------------------------------
  1646.                           "New Marriage Gadget"
  1647.  
  1648. This gadget allows you to establish additional marriages (family groups)
  1649. for the current Principal. Clicking on this gadget will, after
  1650. confirmation, display a new Family Details Window corresponding to a new
  1651. marriage for the Principal. A spouse and children may now be added to
  1652. this family group as for the first marriage.
  1653.  
  1654. (To move between marriages, use the "marriage navigation" gadgets at the
  1655. bottom-left of the Family Details Window.)
  1656.  
  1657. If this gadget is "ghosted" (shaded grey), it means that the Principal has
  1658. already been married for the maximum number of times permitted, and this
  1659. gadget will do nothing.
  1660.  
  1661. The keyboard shortcut for this gadget is "M".
  1662.  
  1663.  
  1664. ----------------------------------------------------------------------------------
  1665. ProjectMenu
  1666. ----------------------------------------------------------------------------------
  1667.                             "Project" Menu
  1668.  
  1669. The following functions are available from the "Project" menu:
  1670.  
  1671.    '  New     '
  1672.    '  Open... '
  1673.    '  Save    '
  1674.    'Save As...'
  1675.    ' Info...  '
  1676.    ' About... '
  1677.    '  Quit    '
  1678.  
  1679.  
  1680. ----------------------------------------------------------------------------------
  1681. MenuNew
  1682. ----------------------------------------------------------------------------------
  1683. New:
  1684.  
  1685. Selecting "New" will, after requesting confirmation, delete the existing
  1686. database.
  1687.  
  1688.  
  1689. ----------------------------------------------------------------------------------
  1690. MenuOpen
  1691. ----------------------------------------------------------------------------------
  1692. Open...
  1693.  
  1694. Selecting "Open..." will, after requesting confirmation, display a
  1695. standard file requester. Select the database you wish to load, and
  1696. click on the "Open" gadget to bring that database into Scion
  1697. Genealogist. If you do not wish to load the selected database, click on
  1698. the "Cancel" gadget.
  1699.  
  1700.  
  1701. ----------------------------------------------------------------------------------
  1702. MenuQuickSave
  1703. ----------------------------------------------------------------------------------
  1704. Save:
  1705.  
  1706. Selecting "Save" will save the existing database immediately to disk
  1707. without asking for confirmation or whether you wish to overwrite an
  1708. existing copy of that database.
  1709.  
  1710. NOTE: When you save a database using the 'Save As...' option, the
  1711.       filename that you give the database will become the default name
  1712.       that will be used by this "Save" option.
  1713.  
  1714.       If there is no database name, or the database is called "Unnamed",
  1715.       this "Save" option will ask that you name the database first.
  1716.  
  1717.  
  1718. ----------------------------------------------------------------------------------
  1719. MenuSave
  1720. ----------------------------------------------------------------------------------
  1721. Save As...
  1722.  
  1723. Selecting "Save As..." will, after requesting confirmation, display a
  1724. standard file requester. Select the database you wish to save (or type
  1725. in the name for a new database file) and click on the "Save" gadget to
  1726. save that database. If you do not wish to save the database, click on
  1727. the "Cancel" gadget.
  1728.  
  1729. NOTE: When you save a database, the filename that you give the database
  1730.       will become the default name for the database. If you do not
  1731.       enter a database file name, the database name will default to
  1732.       "Unnamed".
  1733.  
  1734.  
  1735. ----------------------------------------------------------------------------------
  1736. MenuInfo
  1737. ----------------------------------------------------------------------------------
  1738. Info...
  1739.  
  1740. Selecting "Info..." will display a requester containing the following
  1741. information:
  1742.  
  1743. Project name:      The name set when you save a database, see 'Save As...',
  1744.                    otherwise will be "unnamed"
  1745. Editor name:       The name of your selected editor. See 'Choose Editor'
  1746.                    option under the 'Prefs Menu' menu.
  1747. Viewer name:       The name of your selected viewer. See 'Choose Viewer'
  1748.                    option under the 'Prefs Menu' menu.
  1749. Programme version: The current version number of Scion Genealogist.
  1750. ARexx port name:   The ARexx port name for this instance of the programme.
  1751. Current number of people: The current number of people.
  1752. Current number of families: The current number of families.
  1753. Remaining space:   The approximate amount of space (in people) remaining
  1754.                    in the database.
  1755.  
  1756.  
  1757. ----------------------------------------------------------------------------------
  1758. MenuAbout
  1759. ----------------------------------------------------------------------------------
  1760. About...
  1761.  
  1762. Selecting "About..." will display a requester containing information about
  1763. the programme.
  1764.  
  1765.  
  1766. ----------------------------------------------------------------------------------
  1767. MenuQuit
  1768. ----------------------------------------------------------------------------------
  1769. Quit:
  1770.  
  1771. Selecting "Quit" will, after requesting confirmation, exit the programme.
  1772.  
  1773.  
  1774. ----------------------------------------------------------------------------------
  1775. PrintMenu
  1776. ----------------------------------------------------------------------------------
  1777.                             "Print" Menu
  1778.  
  1779. The following functions are available from the "Print" menu:
  1780.  
  1781.    'List of People    '
  1782.    'List of Families  '
  1783.    'Personal Summary  '
  1784.    'Family Group Sheet'
  1785.    'Descendant Chart  '
  1786.    'Pedigree Chart    '
  1787.  
  1788.  
  1789. ----------------------------------------------------------------------------------
  1790. PrintPeople
  1791. ----------------------------------------------------------------------------------
  1792. Print List of People:
  1793.  
  1794. This menu item will print a list of the people currently defined in the
  1795. database. If sorting is on, the list will be printed in alphabetical
  1796. order, otherwise the list will be printed in numerical order.
  1797.  
  1798. See 'Sorting On/Off' option under the 'Extras Menu' menu.
  1799.  
  1800. Printing can be aborted at any time.
  1801.  
  1802.  
  1803. ----------------------------------------------------------------------------------
  1804. PrintFamilies
  1805. ----------------------------------------------------------------------------------
  1806. Print List of Families:
  1807.  
  1808. This menu item will print a list of the families currently defined in the
  1809. database.
  1810.  
  1811. Printing can be aborted at any time.
  1812.  
  1813.  
  1814. ----------------------------------------------------------------------------------
  1815. PrintSummary
  1816. ----------------------------------------------------------------------------------
  1817. Print Personal Summary:
  1818.  
  1819. This menu item will print a detailed summary of all the information in
  1820. the database about the specified person.
  1821.  
  1822. The "Current" option will print details on the current person.
  1823. The "Range..." option will display a requester where you can enter the
  1824. starting IRN and ending IRN for a printed range of personal summaries.
  1825. The "All" option will print personal summaries for all people in the
  1826. database.
  1827.  
  1828. Printing can be aborted at any time.
  1829.  
  1830.  
  1831. ----------------------------------------------------------------------------------
  1832. PrintFGS
  1833. ----------------------------------------------------------------------------------
  1834. Print Family Group Sheet:
  1835.  
  1836. This menu item will print a Family Group Sheet containing all the
  1837. information in the database about the specified family.
  1838.  
  1839. The "Current" option will print a Family Group Sheet for the current
  1840. family.
  1841. The "Range..." option will display a requester where you can enter the
  1842. starting FGRN and ending FGRN for a printed range of Family Group
  1843. Sheets.
  1844. The "All" option will print Family Group Sheets for all families in the
  1845. database.
  1846.  
  1847. Printing can be aborted at any time.
  1848.  
  1849.  
  1850. ----------------------------------------------------------------------------------
  1851. PrintDescendant
  1852. ----------------------------------------------------------------------------------
  1853. Print Descendant Chart:
  1854.  
  1855. This menu item will print a Descendant Chart for the current person.
  1856.  
  1857. The "With IRNs" option will print the chart with each person's IRN
  1858. attached to the end of their entry.
  1859.  
  1860. The "Without IRNs" option will omit the printing of IRNs for every
  1861. person.
  1862.  
  1863. Printing can be aborted at any time.
  1864.  
  1865.  
  1866. ----------------------------------------------------------------------------------
  1867. PrintPedigree
  1868. ----------------------------------------------------------------------------------
  1869. Print Pedigree Chart:
  1870.  
  1871. This menu item will print a Pedigree Chart for the current person.
  1872.  
  1873. Printing can be aborted at any time.
  1874.  
  1875.  
  1876. ----------------------------------------------------------------------------------
  1877. PrefsMenu
  1878. ----------------------------------------------------------------------------------
  1879.                        Prefs (Preferences) Menu
  1880.  
  1881. The following functions are available from the "Prefs" menu:
  1882.  
  1883.      'Choose Editor  '
  1884.      'Choose Viewer  '
  1885.      'Set User Labels'
  1886.      'Set Behaviour  '
  1887.  
  1888.  
  1889. ----------------------------------------------------------------------------------
  1890. ChooseEditor
  1891. ----------------------------------------------------------------------------------
  1892. Choose Editor:
  1893.  
  1894. This allows you to choose the editor to use to create and edit "free-form"
  1895. notes.
  1896.  
  1897. Selecting this item will display a standard file requester. Select the
  1898. editor that you wish to use, and then click on "Use It" in the requester.
  1899. The editor that you choose is remembered when you save a database, and will
  1900. be restored when that database is re-loaded.
  1901.  
  1902. 'Tested Editors'
  1903.  
  1904.  
  1905. ----------------------------------------------------------------------------------
  1906. ChooseViewer
  1907. ----------------------------------------------------------------------------------
  1908. Choose Viewer:
  1909.  
  1910. This allows you to choose the picture viewer to use to view any pictures
  1911. you may have.
  1912.  
  1913. Selecting this item will display a standard file requester. Select the
  1914. viewer that you wish to use, and then click on "Use It" in the requester.
  1915. The viewer that you choose is remembered when you save a database, and will
  1916. be restored when that database is re-loaded.
  1917.  
  1918.  
  1919. ----------------------------------------------------------------------------------
  1920. SetUserLabels
  1921. ----------------------------------------------------------------------------------
  1922. Set User Labels:
  1923.  
  1924. This allows you to choose the labels for the last three data entry fields
  1925. in the Personal Details Window and the last two data entry fields in the
  1926. Family Details Window. The default labels for the personal fields are:
  1927. Label 1 = "Occupation", Label 2 = "Comments" and Label 3 = "References".
  1928. The default labels for the family fields are: Label 1 = "Celebrant" and
  1929. Label 2 = "Comments". These labels are displayed immediately to the left
  1930. of the appropriate data entry fields.
  1931.  
  1932. Selecting this item will display a data entry requester. The gadgets will
  1933. display the current settings for the five user-defined labels. To change
  1934. any label, activate the appropriate entry gadget and type in the new label
  1935. (up to 13 characters per label). When you are happy with your labels,
  1936. click on the "Accept" gadget. The new labels will then be displayed in the
  1937. Personal Details Window and Family Details Window in place of the default
  1938. labels.
  1939.  
  1940. If you do NOT wish to change the labels, click on the "Cancel" gadget in
  1941. the requester.
  1942.  
  1943. Your user-defined labels will be stored with your database, and be
  1944. restored the next time you load that database.
  1945.  
  1946.  
  1947. ----------------------------------------------------------------------------------
  1948. SetBehaviour
  1949. ----------------------------------------------------------------------------------
  1950. Set Behaviour:
  1951.  
  1952. This allows you to control some of the behaviour of the programme.
  1953.  
  1954. (1) Confirm "Add Person"
  1955.     By default, the programme will always ask you to confirm if you wish
  1956.     to add a new person when you click on the "Add New Person" gadget.
  1957.     When the Confirm "Add Person" checkbox is ticked, this is the
  1958.     behaviour that will occur. If the chechbox is NOT ticked, the
  1959.     programme will NOT ask you to confirm if you wish to add a new person.
  1960.  
  1961. (2) Capitalize first names
  1962.     By default, the programme will force all names in a "first name(s)"
  1963.     field to lower-case with the initial letter of every name capitalized.
  1964.     When the "Capitalize first names" checkbox is ticked, this is the
  1965.     behaviour that will occur. If the checkbox is NOT ticked, any entries
  1966.     in a "first name(s)" field will be left as typed.
  1967.  
  1968. (3) Capitalize event place names
  1969.     By default, the programme performs NO processing of the data entered
  1970.     into an event place field (for example, Birth Place). When the
  1971.     "Capitalize event place names" checkbox is ticked, the programme will
  1972.     force all words in an "event place" field to lower-case with the
  1973.     initial letter of every word capitalized. If the checkbox is NOT
  1974.     ticked, any entries in an "event place" field will be left as typed.
  1975.  
  1976. (4) Carry-over last names
  1977.     By default, when a new person is added to the database (using the
  1978.     "Add New Person" gadget), the Last Name field will be blank. If the
  1979.     "Carry-over last names" checkbox is ticked, the programme will fill
  1980.     in the Last Name field of a new person with the last name of the
  1981.     most recently displayed person. This shortcut is often useful when
  1982.     adding a number of people with the same last name. When the checkbox
  1983.     is NOT ticked, any new person added will start out with a blank
  1984.     Last Name field.
  1985.  
  1986.     See also the 'Pick' gadget.
  1987.  
  1988.  
  1989. ----------------------------------------------------------------------------------
  1990. ExtrasMenu
  1991. ----------------------------------------------------------------------------------
  1992.                             "Extras" Menu
  1993.  
  1994. The following functions are available from the "Extras" menu:
  1995.  
  1996.      'Sorting On/Off'
  1997.      'Add People    '
  1998.      'Colours       '
  1999.  
  2000.  
  2001. ----------------------------------------------------------------------------------
  2002. Sorting
  2003. ----------------------------------------------------------------------------------
  2004. Sorting On/Off:
  2005.  
  2006. This will toggle sorting on and off. If sorting is on, an [S] marker will
  2007. be displayed in the window's title bar, and any lists of people will be
  2008. displayed in alphabetical order. If sorting is off, there will be no marker
  2009. in the window's title bar, and lists of people will be displayed in IRN
  2010. numerical order.
  2011.  
  2012. Sorting also applies to printed "List of People" reports. With sorting on,
  2013. the list will be printed in alphabetical order. If sorting is off, the list
  2014. will be printed in IRN numerical order.
  2015.  
  2016. At programme start-up, sorting is OFF by default. If sorting is on when you
  2017. save your database, this fact is remembered, and the next time you load
  2018. your database, sorting will be turned on.
  2019.  
  2020. NOTE: Sorting ONLY applies to lists of people. It does NOT affect the
  2021.       order of the people in the database.
  2022.  
  2023.  
  2024. ----------------------------------------------------------------------------------
  2025. BulkPeople
  2026. ----------------------------------------------------------------------------------
  2027. Add People:
  2028.  
  2029. Instead of adding people to the database one at a time (using the "Add
  2030. Person" gadget in the Personal Details Window), you can "bulk" add space
  2031. for people by using this menu item.
  2032.  
  2033. There are two sub-items in this menu -
  2034.  
  2035.   - Make space for 10: This will add 10 "blank" people to the database,
  2036.                        if space is available.
  2037.  
  2038.   - Make space for 20: This will add 20 "blank" people to the database,
  2039.                        if space is available.
  2040.  
  2041.  
  2042. ----------------------------------------------------------------------------------
  2043. Colours
  2044. ----------------------------------------------------------------------------------
  2045. Colours:
  2046.  
  2047. This allows you to "customize" the colour of the display from a pre-defined
  2048. selection. To choose a particular colour, select that colour from this
  2049. menu. The screen will immediately change colour to reflect your new choice.
  2050.  
  2051. Colours are remembered when you save a database, and will be restored when
  2052. that database is re-loaded.
  2053.  
  2054.  
  2055. ----------------------------------------------------------------------------------
  2056. ARexx
  2057. ----------------------------------------------------------------------------------
  2058.                            ARexx Interface
  2059.  
  2060. Scion Genealogist provides an ARexx interface for reading and modifying the
  2061. information contained in a database.
  2062.  
  2063. The default ARexx port name is SCIONGEN. If this name is not unique, or
  2064. more than one copy of Scion is running, the default ARexx port name will be
  2065. suffixed with a digit from 1 to 9. For example, SCIONGEN3. Therefore, up to
  2066. 10 copies of Scion can be run, each with a unique ARexx port name.
  2067.  
  2068. To determine the actual ARexx port name in use, select the "Info" item in
  2069. the Project menu.
  2070.  
  2071. "People" Commands:
  2072.   'EXISTPERSON   '
  2073.   'GETTOTALIRN   '
  2074.                     'PUTNEWPERSON  '
  2075.   'GETLASTNAME   '  'PUTLASTNAME   '
  2076.   'GETFIRSTNAME  '  'PUTFIRSTNAME  '
  2077.   'GETSEX        '  'PUTSEX        '
  2078.   'GETBIRTHDATE  '  'PUTBIRTHDATE  '
  2079.   'GETBIRTHPLACE '  'PUTBIRTHPLACE '
  2080.   'GETDEATHDATE  '  'PUTDEATHDATE  '
  2081.   'GETDEATHPLACE '  'PUTDEATHPLACE '
  2082.   'GETBURIALDATE '  'PUTBURIALDATE '
  2083.   'GETBURIALPLACE'  'PUTBURIALPLACE'
  2084.   'GETPARENTS    '
  2085.   'GETMARRIAGE   '
  2086.  
  2087. "Families" Commands:
  2088.   'EXISTFAMILY   '
  2089.   'GETTOTALFGRN  '
  2090.   'GETPRINCIPAL  '  'PUTNEWFAMILY  '
  2091.   'GETSPOUSE     '  'PUTSPOUSE     '
  2092.   'GETCHILD      '  'PUTCHILD      '
  2093.   'GETMARRYDATE  '  'PUTMARRYDATE  '
  2094.   'GETMARRYPLACE '  'PUTMARRYPLACE '
  2095.  
  2096. "Configuration" Commands:
  2097.   'GETPERSUSER1  '  'PUTPERSUSER1  '
  2098.   'GETPERSUSER2  '  'PUTPERSUSER2  '
  2099.   'GETPERSUSER3  '  'PUTPERSUSER3  '
  2100.   'GETFAMUSER1   '  'PUTFAMUSER1   '
  2101.   'GETFAMUSER2   '  'PUTFAMUSER2   '
  2102.   'GETPERSLABEL  '  'PUTPERSLABEL  '
  2103.   'GETFAMLABEL   '  'PUTFAMLABEL   '
  2104.  
  2105. "Miscellaneous" Commands:
  2106.   'GETDBNAME     '  'GETPERSONWIN  '  'GETFAMILYWIN  '  'GETPROGVERSION'
  2107.   'GETLANGUAGE   '
  2108.  
  2109.  
  2110.  
  2111. ----------------------------------------------------------------------------------
  2112. getdbname
  2113. ----------------------------------------------------------------------------------
  2114. GETDBNAME command:
  2115.     SYNTAX:    GETDBNAME
  2116.  
  2117.     result: Name of current database (could be "Unnamed").
  2118.  
  2119.     The result is returned in the ARexx variable RESULT.
  2120.  
  2121. EXAMPLE USAGE:
  2122.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2123.     Address value MyPort    /* Change ARexx address to that port */
  2124.     GETDBNAME        /* Issue command to Scion Genealogist */
  2125.     Say "Current database name is " RESULT
  2126.  
  2127.  
  2128. ----------------------------------------------------------------------------------
  2129. gettotalirn
  2130. ----------------------------------------------------------------------------------
  2131. GETTOTALIRN command:
  2132.     SYNTAX:    GETTOTALIRN
  2133.  
  2134.     result: Total number of people in the database.
  2135.             NOTE: This also includes any deleted people.
  2136.  
  2137.     The result is returned in the ARexx variable RESULT.
  2138.  
  2139. EXAMPLE USAGE:
  2140.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2141.     Address value MyPort    /* Change ARexx address to that port */
  2142.     GETTOTALIRN        /* Issue command to Scion Genealogist */
  2143.     Say "Number of people in database = " RESULT
  2144.  
  2145.  
  2146. ----------------------------------------------------------------------------------
  2147. gettotalfgrn
  2148. ----------------------------------------------------------------------------------
  2149. GETTOTALFGRN command:
  2150.     SYNTAX:    GETTOTALFGRN
  2151.  
  2152.     result: Total number of family groups in the database.
  2153.             NOTE: This also includes any dissolved family groups.
  2154.  
  2155.     The result is returned in the ARexx variable RESULT.
  2156.  
  2157. EXAMPLE USAGE:
  2158.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2159.     Address value MyPort    /* Change ARexx address to that port */
  2160.     GETTOTALFGRN        /* Issue command to Scion Genealogist */
  2161.     Say "Number of families in database = " RESULT
  2162.  
  2163.  
  2164. ----------------------------------------------------------------------------------
  2165. existperson
  2166. ----------------------------------------------------------------------------------
  2167. EXISTPERSON command:
  2168.     SYNTAX:    EXISTPERSON CurrentIRN
  2169.  
  2170.     where: CurrentIRN is the IRN of the person
  2171.            of interest in the Scion database
  2172.  
  2173.     result: YES if specified person exists in database
  2174.             NO if specified person does NOT exist in database
  2175.  
  2176.     The result is returned in the ARexx variable RESULT.
  2177.  
  2178. EXAMPLE USAGE:
  2179.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2180.     Address value MyPort    /* Change ARexx address to that port */
  2181.     MyIRN = 5        /* Set MyIRN to person 5 */
  2182.     EXISTPERSON MyIRN    /* Issue command to Scion Genealogist */
  2183.     if RESULT = 'YES' then
  2184.     do
  2185.         Say "Person was found in database
  2186.     end
  2187.     else
  2188.         Say "That person does not exist in the database"
  2189.  
  2190.  
  2191. ----------------------------------------------------------------------------------
  2192. getlastname
  2193. ----------------------------------------------------------------------------------
  2194. GETLASTNAME command:
  2195.     SYNTAX:    GETLASTNAME CurrentIRN
  2196.  
  2197.     where: CurrentIRN is the IRN of the person
  2198.            of interest in the Scion database
  2199.  
  2200.     result: The last name of the specified person
  2201.  
  2202.     The result is returned in the ARexx variable RESULT.
  2203.  
  2204. EXAMPLE USAGE:
  2205.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2206.     Address value MyPort    /* Change ARexx address to that port */
  2207.     MyIRN = 5        /* Set MyIRN to person 5 */
  2208.     GETLASTNAME MyIRN    /* Issue command to Scion Genealogist */
  2209.     Say "Person's last name is:" RESULT
  2210.  
  2211.  
  2212. ----------------------------------------------------------------------------------
  2213. getfirstname
  2214. ----------------------------------------------------------------------------------
  2215. GETFIRSTNAME command:
  2216.     SYNTAX:    GETFIRSTNAME CurrentIRN
  2217.  
  2218.     where: CurrentIRN is the IRN of the person
  2219.            of interest in the Scion database
  2220.  
  2221.     result: The first name(s) of the specified person
  2222.  
  2223.     The result is returned in the ARexx variable RESULT.
  2224.  
  2225. EXAMPLE USAGE:
  2226.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2227.     Address value MyPort    /* Change ARexx address to that port */
  2228.     MyIRN = 5        /* Set MyIRN to person 5 */
  2229.     GETFIRSTNAME MyIRN    /* Issue command to Scion Genealogist */
  2230.     Say "Person's first name is:" RESULT
  2231.  
  2232.  
  2233. ----------------------------------------------------------------------------------
  2234. getsex
  2235. ----------------------------------------------------------------------------------
  2236. GETSEX command:
  2237.     SYNTAX:    GETSEX CurrentIRN
  2238.  
  2239.     where: CurrentIRN is the IRN of the person
  2240.            of interest in the Scion database
  2241.  
  2242.     result: The sex (gender) of the specified person
  2243.  
  2244.     The result is returned in the ARexx variable RESULT.
  2245.  
  2246. EXAMPLE USAGE:
  2247.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2248.     Address value MyPort    /* Change ARexx address to that port */
  2249.     MyIRN = 5        /* Set MyIRN to person 5 */
  2250.     GETSEX MyIRN        /* Issue command to Scion Genealogist */
  2251.     Say "Person's gender is:" RESULT
  2252.  
  2253.  
  2254. ----------------------------------------------------------------------------------
  2255. getbirthdate
  2256. ----------------------------------------------------------------------------------
  2257. GETBIRTHDATE command:
  2258.     SYNTAX:    GETBIRTHDATE CurrentIRN
  2259.  
  2260.     where: CurrentIRN is the IRN of the person
  2261.            of interest in the Scion database
  2262.  
  2263.     result: The date of birth of the specified person
  2264.  
  2265.     The result is returned in the ARexx variable RESULT.
  2266.  
  2267. EXAMPLE USAGE:
  2268.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2269.     Address value MyPort    /* Change ARexx address to that port */
  2270.     MyIRN = 5        /* Set MyIRN to person 5 */
  2271.     GETBIRTHDATE MyIRN    /* Issue command to Scion Genealogist */
  2272.     Say "Person's date of birth is:" RESULT
  2273.  
  2274.  
  2275. ----------------------------------------------------------------------------------
  2276. getbirthplace
  2277. ----------------------------------------------------------------------------------
  2278. GETBIRTHPLACE command:
  2279.     SYNTAX:    GETBIRTHPLACE CurrentIRN
  2280.  
  2281.     where: CurrentIRN is the IRN of the person
  2282.            of interest in the Scion database
  2283.  
  2284.     result: The place of birth of the specified person
  2285.  
  2286.     The result is returned in the ARexx variable RESULT.
  2287.  
  2288. EXAMPLE USAGE:
  2289.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2290.     Address value MyPort    /* Change ARexx address to that port */
  2291.     MyIRN = 5        /* Set MyIRN to person 5 */
  2292.     GETBIRTHPLACE MyIRN    /* Issue command to Scion Genealogist */
  2293.     Say "Person's place of birth is:" RESULT
  2294.  
  2295.  
  2296. ----------------------------------------------------------------------------------
  2297. getdeathdate
  2298. ----------------------------------------------------------------------------------
  2299. GETDEATHDATE command:
  2300.     SYNTAX:    GETDEATHDATE CurrentIRN
  2301.  
  2302.     where: CurrentIRN is the IRN of the person
  2303.            of interest in the Scion database
  2304.  
  2305.     result: The date of death of the specified person
  2306.  
  2307.     The result is returned in the ARexx variable RESULT.
  2308.  
  2309. EXAMPLE USAGE:
  2310.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2311.     Address value MyPort    /* Change ARexx address to that port */
  2312.     MyIRN = 5        /* Set MyIRN to person 5 */
  2313.     GETDEATHDATE MyIRN    /* Issue command to Scion Genealogist */
  2314.     Say "Person's date of death is:" RESULT
  2315.  
  2316.  
  2317. ----------------------------------------------------------------------------------
  2318. getdeathplace
  2319. ----------------------------------------------------------------------------------
  2320. GETDEATHPLACE command:
  2321.     SYNTAX:    GETDEATHPLACE CurrentIRN
  2322.  
  2323.     where: CurrentIRN is the IRN of the person
  2324.            of interest in the Scion database
  2325.  
  2326.     result: The place of death of the specified person
  2327.  
  2328.     The result is returned in the ARexx variable RESULT.
  2329.  
  2330. EXAMPLE USAGE:
  2331.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2332.     Address value MyPort    /* Change ARexx address to that port */
  2333.     MyIRN = 5        /* Set MyIRN to person 5 */
  2334.     GETDEATHPLACE MyIRN    /* Issue command to Scion Genealogist */
  2335.     Say "Person's place of death is:" RESULT
  2336.  
  2337.  
  2338. ----------------------------------------------------------------------------------
  2339. getburialdate
  2340. ----------------------------------------------------------------------------------
  2341. GETBURIALDATE command:
  2342.     SYNTAX:    GETBURIALDATE CurrentIRN
  2343.  
  2344.     where: CurrentIRN is the IRN of the person
  2345.            of interest in the Scion database
  2346.  
  2347.     result: The date of burial of the specified person
  2348.  
  2349.     The result is returned in the ARexx variable RESULT.
  2350.  
  2351. EXAMPLE USAGE:
  2352.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2353.     Address value MyPort    /* Change ARexx address to that port */
  2354.     MyIRN = 5        /* Set MyIRN to person 5 */
  2355.     GETBURIALDATE MyIRN    /* Issue command to Scion Genealogist */
  2356.     Say "Person's date of burial is:" RESULT
  2357.  
  2358.  
  2359. ----------------------------------------------------------------------------------
  2360. getburialplace
  2361. ----------------------------------------------------------------------------------
  2362. GETBURIALPLACE command:
  2363.     SYNTAX:    GETBURIALPLACE CurrentIRN
  2364.  
  2365.     where: CurrentIRN is the IRN of the person
  2366.            of interest in the Scion database
  2367.  
  2368.     result: The place of burial of the specified person
  2369.  
  2370.     The result is returned in the ARexx variable RESULT.
  2371.  
  2372. EXAMPLE USAGE:
  2373.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2374.     Address value MyPort    /* Change ARexx address to that port */
  2375.     MyIRN = 5        /* Set MyIRN to person 5 */
  2376.     GETBURIALPLACE MyIRN    /* Issue command to Scion Genealogist */
  2377.     Say "Person's place of burial is:" RESULT
  2378.  
  2379.  
  2380. ----------------------------------------------------------------------------------
  2381. getpersuser1
  2382. ----------------------------------------------------------------------------------
  2383. GETPERSUSER1 command:
  2384.     SYNTAX:    GETPERSUSER1 CurrentIRN
  2385.  
  2386.     where: CurrentIRN is the IRN of the person
  2387.            of interest in the Scion database
  2388.  
  2389.     result: The contents of the "user 1" field of the specified person.
  2390.             By default, this field corresponds to "occupation"
  2391.  
  2392.     The result is returned in the ARexx variable RESULT.
  2393.  
  2394. EXAMPLE USAGE:
  2395.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2396.     Address value MyPort    /* Change ARexx address to that port */
  2397.     MyIRN = 5        /* Set MyIRN to person 5 */
  2398.     GETPERSUSER1 MyIRN    /* Issue command to Scion Genealogist */
  2399.     Say "Person's occupation is:" RESULT
  2400.  
  2401.  
  2402. ----------------------------------------------------------------------------------
  2403. getpersuser2
  2404. ----------------------------------------------------------------------------------
  2405. GETPERSUSER2 command:
  2406.     SYNTAX:    GETPERSUSER2 CurrentIRN
  2407.  
  2408.     where: CurrentIRN is the IRN of the person
  2409.            of interest in the Scion database
  2410.  
  2411.     result: The contents of the "user 2" field of the specified person.
  2412.             By default, this field corresponds to "Comment"
  2413.  
  2414.     The result is returned in the ARexx variable RESULT.
  2415.  
  2416. EXAMPLE USAGE:
  2417.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2418.     Address value MyPort    /* Change ARexx address to that port */
  2419.     MyIRN = 5        /* Set MyIRN to person 5 */
  2420.     GETPERSUSER2 MyIRN    /* Issue command to Scion Genealogist */
  2421.     Say "Personal comment:" RESULT
  2422.  
  2423.  
  2424. ----------------------------------------------------------------------------------
  2425. getpersuser3
  2426. ----------------------------------------------------------------------------------
  2427. GETPERSUSER3 command:
  2428.     SYNTAX:    GETPERSUSER3 CurrentIRN
  2429.  
  2430.     where: CurrentIRN is the IRN of the person
  2431.            of interest in the Scion database
  2432.  
  2433.     result: The contents of the "user 3" field of the specified person.
  2434.             By default, this field corresponds to "References"
  2435.  
  2436.     The result is returned in the ARexx variable RESULT.
  2437.  
  2438. EXAMPLE USAGE:
  2439.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2440.     Address value MyPort    /* Change ARexx address to that port */
  2441.     MyIRN = 5        /* Set MyIRN to person 5 */
  2442.     GETPERSUSER3 MyIRN    /* Issue command to Scion Genealogist */
  2443.     Say "References:" RESULT
  2444.  
  2445.  
  2446. ----------------------------------------------------------------------------------
  2447. getparents
  2448. ----------------------------------------------------------------------------------
  2449. GETPARENTS command:
  2450.     SYNTAX:    GETPARENTS CurrentIRN
  2451.  
  2452.     where: CurrentIRN is the IRN of the person
  2453.            of interest in the Scion database
  2454.  
  2455.     result: The FGRN (Family Group Record Number) for the parents
  2456.         of the specified person
  2457.  
  2458.     The result is returned in the ARexx variable RESULT.
  2459.  
  2460. EXAMPLE USAGE:
  2461.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2462.     Address value MyPort    /* Change ARexx address to that port */
  2463.     MyIRN = 5        /* Set MyIRN to person 5 */
  2464.     GETPARENTS MyIRN    /* Issue command to Scion Genealogist */
  2465.     Say "Parent's FGRN:" RESULT
  2466.  
  2467.  
  2468. ----------------------------------------------------------------------------------
  2469. getmarriage
  2470. ----------------------------------------------------------------------------------
  2471. GETMARRIAGE command:
  2472.     SYNTAX:    GETMARRIAGE CurrentIRN MarriageNum
  2473.  
  2474.     where:  CurrentIRN is the IRN of the person
  2475.             of interest in the Scion database, and
  2476.  
  2477.             MarriageNum is the marriage number for specified person
  2478.         (ie. 0, 1, 2, etc. for first, second, third, etc. marriage)
  2479.  
  2480.     result: The FGRN (Family Group Record Number) for the specified
  2481.         marriage number of the specified person
  2482.  
  2483.     The result is returned in the ARexx variable RESULT.
  2484.  
  2485. EXAMPLE USAGE:
  2486.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2487.     Address value MyPort    /* Change ARexx address to that port */
  2488.     MyIRN = 5        /* Set MyIRN to person 5 */
  2489.     MarryNum = 2        /* Examine 3rd marriage of this person */
  2490.     GETMARRIAGE MyIRN MarryNum    /* Issue command */
  2491.     Say "FGRN of person's marriage number" MarryNum ":" RESULT
  2492.  
  2493.  
  2494. ----------------------------------------------------------------------------------
  2495. existfamily
  2496. ----------------------------------------------------------------------------------
  2497. EXISTFAMILY command:
  2498.     SYNTAX:    EXISTFAMILY CurrentFGRN
  2499.  
  2500.     where: CurrentFGRN is the FGRN of the person
  2501.            of interest in the Scion database
  2502.  
  2503.     result: YES if specified family exists in database
  2504.             NO if specified family does NOT exist in database
  2505.  
  2506.     The result is returned in the ARexx variable RESULT.
  2507.  
  2508. EXAMPLE USAGE:
  2509.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2510.     Address value MyPort    /* Change ARexx address to that port */
  2511.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2512.     EXISTPERSON MyIRN    /* Issue command to Scion Genealogist */
  2513.     if RESULT = 'YES' then
  2514.     do
  2515.         Say "Family was found in database
  2516.     end
  2517.     else
  2518.         Say "That family does not exist in the database"
  2519.  
  2520.  
  2521. ----------------------------------------------------------------------------------
  2522. getprincipal
  2523. ----------------------------------------------------------------------------------
  2524. GETPRINCIPAL command:
  2525.     SYNTAX:    GETPRINCIPAL CurrentFGRN
  2526.  
  2527.     where:  CurrentFGRN is the FGRN of the family
  2528.             of interest in the Scion database, and
  2529.  
  2530.     result: The IRN of the Principal of the specified family
  2531.  
  2532.     The result is returned in the ARexx variable RESULT.
  2533.  
  2534. EXAMPLE USAGE:
  2535.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2536.     Address value MyPort    /* Change ARexx address to that port */
  2537.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2538.     GETPRINCIPAL MyFGRN     /* Issue command */
  2539.     Say "IRN of principal of family:" RESULT
  2540.  
  2541.  
  2542. ----------------------------------------------------------------------------------
  2543. getspouse
  2544. ----------------------------------------------------------------------------------
  2545. GETSPOUSE command:
  2546.     SYNTAX:    GETSPOUSE CurrentFGRN
  2547.  
  2548.     where:  CurrentFGRN is the FGRN of the family
  2549.             of interest in the Scion database, and
  2550.  
  2551.     result: The IRN of the Spouse of the specified family
  2552.  
  2553.     The result is returned in the ARexx variable RESULT.
  2554.  
  2555. EXAMPLE USAGE:
  2556.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2557.     Address value MyPort    /* Change ARexx address to that port */
  2558.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2559.     GETSPOUSE MyFGRN     /* Issue command */
  2560.     Say "IRN of spouse of family:" RESULT
  2561.  
  2562.  
  2563. ----------------------------------------------------------------------------------
  2564. getmarrydate
  2565. ----------------------------------------------------------------------------------
  2566. GETMARRYDATE command:
  2567.     SYNTAX:    GETMARRYDATE CurrentFGRN
  2568.  
  2569.     where: CurrentFGRN is the FGRN of the family
  2570.            of interest in the Scion database
  2571.  
  2572.     result: The date of marriage for the specified family
  2573.  
  2574.     The result is returned in the ARexx variable RESULT.
  2575.  
  2576. EXAMPLE USAGE:
  2577.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2578.     Address value MyPort    /* Change ARexx address to that port */
  2579.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2580.     GETMARRIAGEDATE MyFGRN    /* Issue command to Scion Genealogist */
  2581.     Say "Date of marriage is:" RESULT
  2582.  
  2583.  
  2584. ----------------------------------------------------------------------------------
  2585. getmarryplace
  2586. ----------------------------------------------------------------------------------
  2587. GETMARRYPLACE command:
  2588.     SYNTAX:    GETMARRYPLACE CurrentFGRN
  2589.  
  2590.     where: CurrentFGRN is the FGRN of the family
  2591.            of interest in the Scion database
  2592.  
  2593.     result: The place of marriage for the specified family
  2594.  
  2595.     The result is returned in the ARexx variable RESULT.
  2596.  
  2597. EXAMPLE USAGE:
  2598.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2599.     Address value MyPort    /* Change ARexx address to that port */
  2600.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2601.     GETMARRIAGEPLACE MyFGRN    /* Issue command to Scion Genealogist */
  2602.     Say "Place of marriage is:" RESULT
  2603.  
  2604.  
  2605. ----------------------------------------------------------------------------------
  2606. getcelebrant
  2607. ----------------------------------------------------------------------------------
  2608. GETFAMUSER1 command:
  2609.     SYNTAX:    GETFAMUSER1 CurrentFGRN
  2610.  
  2611.     where: CurrentFGRN is the FGRN of the family
  2612.            of interest in the Scion database
  2613.  
  2614.     result: The contents of the "user 1" field of the specified family.
  2615.             By default, this field corresponds to "celebrant"
  2616.  
  2617.     The result is returned in the ARexx variable RESULT.
  2618.  
  2619. EXAMPLE USAGE:
  2620.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2621.     Address value MyPort    /* Change ARexx address to that port */
  2622.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2623.     GETFAMUSER1 MyFGRN    /* Issue command to Scion Genealogist */
  2624.     Say "Marriage celebrant was:" RESULT
  2625.  
  2626.  
  2627. ----------------------------------------------------------------------------------
  2628. getfamcomment
  2629. ----------------------------------------------------------------------------------
  2630. GETFAMUSER2 command:
  2631.     SYNTAX:    GETFAMUSER2 CurrentFGRN
  2632.  
  2633.     where: CurrentFGRN is the FGRN of the family
  2634.            of interest in the Scion database
  2635.  
  2636.     result: The contents of the "user 2" field of the specified family.
  2637.             By default, this field corresponds to "comment"
  2638.  
  2639.     The result is returned in the ARexx variable RESULT.
  2640.  
  2641. EXAMPLE USAGE:
  2642.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2643.     Address value MyPort    /* Change ARexx address to that port */
  2644.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2645.     GETFAMUSER2 MyFGRN    /* Issue command to Scion Genealogist */
  2646.     Say "Family comment:" RESULT
  2647.  
  2648.  
  2649. ----------------------------------------------------------------------------------
  2650. getchild
  2651. ----------------------------------------------------------------------------------
  2652. GETCHILD command:
  2653.     SYNTAX:    GETCHILD CurrentFGRN ChildNum
  2654.  
  2655.     where:  CurrentFGRN is the FGRN of the family
  2656.             of interest in the Scion database, and
  2657.  
  2658.             ChildNum is the "number" of the specified child
  2659.         (ie. 0, 1, 2, etc. for first, second, third, etc. child)
  2660.  
  2661.     result: The IRN (Individual Record Number) for the specified
  2662.         child "number" of the specified family
  2663.  
  2664.     The result is returned in the ARexx variable RESULT.
  2665.  
  2666. EXAMPLE USAGE:
  2667.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2668.     Address value MyPort    /* Change ARexx address to that port */
  2669.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2670.     ChildNum = 2        /* Examine 3rd child of this family */
  2671.     GETCHILD MyFGRN ChildNum    /* Issue command */
  2672.     Say "IRN of family's child number" ChildNum ":" RESULT
  2673.  
  2674.  
  2675. ----------------------------------------------------------------------------------
  2676. putlastname
  2677. ----------------------------------------------------------------------------------
  2678. PUTLASTNAME command:
  2679.     SYNTAX:    PUTLASTNAME CurrentIRN "Last Name"
  2680.  
  2681.     where: CurrentIRN is the IRN of the person
  2682.            of interest in the Scion database
  2683.  
  2684.            Set the last name of the specified person in the database
  2685.            to the quoted string "Last Name"
  2686.  
  2687.     result: none (database updated)
  2688.  
  2689. EXAMPLE USAGE:
  2690.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2691.     Address value MyPort    /* Change ARexx address to that port */
  2692.     MyIRN = 5        /* Set MyIRN to person 5 */
  2693.     PUTLASTNAME MyIRN "Smith"    /* Issue command */
  2694.  
  2695.  
  2696. ----------------------------------------------------------------------------------
  2697. putfirstname
  2698. ----------------------------------------------------------------------------------
  2699. PUTFIRSTNAME command:
  2700.     SYNTAX:    PUTFIRSTNAME CurrentIRN "First Names"
  2701.  
  2702.     where: CurrentIRN is the IRN of the person
  2703.            of interest in the Scion database
  2704.  
  2705.            Set the first names of the specified person in the database
  2706.            to the quoted string "First Names"
  2707.  
  2708.     result: none (database updated)
  2709.  
  2710. EXAMPLE USAGE:
  2711.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2712.     Address value MyPort    /* Change ARexx address to that port */
  2713.     MyIRN = 5        /* Set MyIRN to person 5 */
  2714.     PUTFIRSTNAME MyIRN "John Robert"    /* Issue command */
  2715.  
  2716.  
  2717. ----------------------------------------------------------------------------------
  2718. putsex
  2719. ----------------------------------------------------------------------------------
  2720. PUTSEX command:
  2721.     SYNTAX:    PUTSEX CurrentIRN "M | F"
  2722.  
  2723.     where: CurrentIRN is the IRN of the person
  2724.            of interest in the Scion database
  2725.  
  2726.            Set the sex of the specified person in the database
  2727.            to male ("M") or female ("F"). Any other value is
  2728.            indeterminate (but permitted).
  2729.  
  2730.     result: none (database updated)
  2731.  
  2732. EXAMPLE USAGE:
  2733.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2734.     Address value MyPort    /* Change ARexx address to that port */
  2735.     MyIRN = 5        /* Set MyIRN to person 5 */
  2736.     PUTSEX MyIRN "M"    /* Issue command to Scion Genealogist */
  2737.  
  2738.  
  2739. ----------------------------------------------------------------------------------
  2740. putbirthdate
  2741. ----------------------------------------------------------------------------------
  2742. PUTBIRTHDATE command:
  2743.     SYNTAX:    PUTBIRTHDATE CurrentIRN "Birth Date"
  2744.  
  2745.     where: CurrentIRN is the IRN of the person
  2746.            of interest in the Scion database
  2747.  
  2748.            Set the birth date of the specified person in the database
  2749.            to the quoted string "Birth Date"
  2750.  
  2751.     result: none (database updated)
  2752.  
  2753. EXAMPLE USAGE:
  2754.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2755.     Address value MyPort    /* Change ARexx address to that port */
  2756.     MyIRN = 5        /* Set MyIRN to person 5 */
  2757.     PUTBIRTHDATE MyIRN "14 Jun 1893"    /* Issue command */
  2758.  
  2759.  
  2760. ----------------------------------------------------------------------------------
  2761. putbirthplace
  2762. ----------------------------------------------------------------------------------
  2763. PUTBIRTHPLACE command:
  2764.     SYNTAX:    PUTBIRTHPLACE CurrentIRN "Birth Place"
  2765.  
  2766.     where: CurrentIRN is the IRN of the person
  2767.            of interest in the Scion database
  2768.  
  2769.            Set the birth place of the specified person in the database
  2770.            to the quoted string "Birth Place"
  2771.  
  2772.     result: none (database updated)
  2773.  
  2774. EXAMPLE USAGE:
  2775.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2776.     Address value MyPort    /* Change ARexx address to that port */
  2777.     MyIRN = 5        /* Set MyIRN to person 5 */
  2778.     PUTBIRTHPLACE MyIRN "St Helen's Maternity"   /* Issue command */
  2779.  
  2780.  
  2781. ----------------------------------------------------------------------------------
  2782. putdeathdate
  2783. ----------------------------------------------------------------------------------
  2784. PUTDEATHDATE command:
  2785.     SYNTAX:    PUTDEATHDATE CurrentIRN "Death Date"
  2786.  
  2787.     where: CurrentIRN is the IRN of the person
  2788.            of interest in the Scion database
  2789.  
  2790.            Set the Death date of the specified person in the database
  2791.            to the quoted string "Death Date"
  2792.  
  2793.     result: none (database updated)
  2794.  
  2795. EXAMPLE USAGE:
  2796.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2797.     Address value MyPort    /* Change ARexx address to that port */
  2798.     MyIRN = 5        /* Set MyIRN to person 5 */
  2799.     PUTDEATHDATE MyIRN "14 Jun 1903"    /* Issue command */
  2800.  
  2801.  
  2802. ----------------------------------------------------------------------------------
  2803. putdeathplace
  2804. ----------------------------------------------------------------------------------
  2805. PUTDEATHPLACE command:
  2806.     SYNTAX:    PUTDEATHPLACE CurrentIRN "Death Place"
  2807.  
  2808.     where: CurrentIRN is the IRN of the person
  2809.            of interest in the Scion database
  2810.  
  2811.            Set the death place of the specified person in the database
  2812.            to the quoted string "Death Place"
  2813.  
  2814.     result: none (database updated)
  2815.  
  2816. EXAMPLE USAGE:
  2817.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2818.     Address value MyPort    /* Change ARexx address to that port */
  2819.     MyIRN = 5        /* Set MyIRN to person 5 */
  2820.     PUTDEATHPLACE MyIRN "Public Hospital"   /* Issue command */
  2821.  
  2822.  
  2823. ----------------------------------------------------------------------------------
  2824. putburialdate
  2825. ----------------------------------------------------------------------------------
  2826. PUTBURIALDATE command:
  2827.     SYNTAX:    PUTBURIALDATE CurrentIRN "Burial Date"
  2828.  
  2829.     where: CurrentIRN is the IRN of the person
  2830.            of interest in the Scion database
  2831.  
  2832.            Set the Burial date of the specified person in the database
  2833.            to the quoted string "Burial Date"
  2834.  
  2835.     result: none (database updated)
  2836.  
  2837. EXAMPLE USAGE:
  2838.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2839.     Address value MyPort    /* Change ARexx address to that port */
  2840.     MyIRN = 5        /* Set MyIRN to person 5 */
  2841.     PUTBURIALDATE MyIRN "17 Jun 1903"    /* Issue command */
  2842.  
  2843.  
  2844. ----------------------------------------------------------------------------------
  2845. putburialplace
  2846. ----------------------------------------------------------------------------------
  2847. PUTBURIALPLACE command:
  2848.     SYNTAX:    PUTBURIALPLACE CurrentIRN "Burial Place"
  2849.  
  2850.     where: CurrentIRN is the IRN of the person
  2851.            of interest in the Scion database
  2852.  
  2853.            Set the burial place of the specified person in the database
  2854.            to the quoted string "Burial Place"
  2855.  
  2856.     result: none (database updated)
  2857.  
  2858. EXAMPLE USAGE:
  2859.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2860.     Address value MyPort    /* Change ARexx address to that port */
  2861.     MyIRN = 5        /* Set MyIRN to person 5 */
  2862.     PUTBURIALPLACE MyIRN "King Cemetery"   /* Issue command */
  2863.  
  2864.  
  2865. ----------------------------------------------------------------------------------
  2866. putpersuser1
  2867. ----------------------------------------------------------------------------------
  2868. PUTPERSUSER1 command:
  2869.     SYNTAX:    PUTPERSUSER1 CurrentIRN "Field contents"
  2870.  
  2871.     where: CurrentIRN is the IRN of the person
  2872.            of interest in the Scion database
  2873.  
  2874.            Set the "user 1" field of the specified person in the
  2875.            database to the quoted string "Field contents".
  2876.            By default, this field is labelled "Occupation"
  2877.  
  2878.     result: none (database updated)
  2879.  
  2880. EXAMPLE USAGE:
  2881.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2882.     Address value MyPort    /* Change ARexx address to that port */
  2883.     MyIRN = 5        /* Set MyIRN to person 5 */
  2884.     PUTPERSUSER1 MyIRN "School teacher"   /* Issue command */
  2885.  
  2886.  
  2887. ----------------------------------------------------------------------------------
  2888. putpersuser2
  2889. ----------------------------------------------------------------------------------
  2890. PUTPERSUSER2 command:
  2891.     SYNTAX:    PUTPERSUSER2 CurrentIRN "Field contents"
  2892.  
  2893.     where: CurrentIRN is the IRN of the person
  2894.            of interest in the Scion database
  2895.  
  2896.            Set the "user 2" field of the specified person in the
  2897.            database to the quoted string "Field contents".
  2898.            By default, this field is labelled "Comment"
  2899.  
  2900.     result: none (database updated)
  2901.  
  2902. EXAMPLE USAGE:
  2903.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2904.     Address value MyPort    /* Change ARexx address to that port */
  2905.     MyIRN = 5        /* Set MyIRN to person 5 */
  2906.     PUTPERSUSER2 MyIRN "Hanged for murder"   /* Issue command */
  2907.  
  2908.  
  2909. ----------------------------------------------------------------------------------
  2910. putpersuser3
  2911. ----------------------------------------------------------------------------------
  2912. PUTPERSUSER3 command:
  2913.     SYNTAX:    PUTPERSUSER3 CurrentIRN "Field contents"
  2914.  
  2915.     where: CurrentIRN is the IRN of the person
  2916.            of interest in the Scion database
  2917.  
  2918.            Set the "user 3" field of the specified person in the
  2919.            database to the quoted string "Field contents".
  2920.            By default, this field is labelled "References"
  2921.  
  2922.     result: none (database updated)
  2923.  
  2924. EXAMPLE USAGE:
  2925.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2926.     Address value MyPort    /* Change ARexx address to that port */
  2927.     MyIRN = 5        /* Set MyIRN to person 5 */
  2928.     PUTPERSUSER3 MyIRN "1876 BDM Index #19536"   /* Issue command */
  2929.  
  2930.  
  2931. ----------------------------------------------------------------------------------
  2932. putmarrydate
  2933. ----------------------------------------------------------------------------------
  2934. PUTMARRYDATE command:
  2935.     SYNTAX:    PUTMARRYDATE CurrentFGRN "Marriage Date"
  2936.  
  2937.     where: CurrentFGRN is the FGRN of the family
  2938.            of interest in the Scion database
  2939.  
  2940.            Set the Marriage date of the specified family in the
  2941.            database to the quoted string "Marriage Date"
  2942.  
  2943.     result: none (database updated)
  2944.  
  2945. EXAMPLE USAGE:
  2946.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2947.     Address value MyPort    /* Change ARexx address to that port */
  2948.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2949.     PUTMARRYDATE MyFGRN "23 Feb 1897"    /* Issue command */
  2950.  
  2951.  
  2952. ----------------------------------------------------------------------------------
  2953. putmarryplace
  2954. ----------------------------------------------------------------------------------
  2955. PUTMARRYPLACE command:
  2956.     SYNTAX:    PUTMARRYPLACE CurrentFGRN "Marriage Place"
  2957.  
  2958.     where: CurrentFGRN is the FGRN of the family
  2959.            of interest in the Scion database
  2960.  
  2961.            Set the Marriage place of the specified family in the
  2962.            database to the quoted string "Marriage Place"
  2963.  
  2964.     result: none (database updated)
  2965.  
  2966. EXAMPLE USAGE:
  2967.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2968.     Address value MyPort    /* Change ARexx address to that port */
  2969.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2970.     PUTMARRYPLACE MyFGRN "Catholic Cathedral"    /* Issue command */
  2971.  
  2972.  
  2973. ----------------------------------------------------------------------------------
  2974. putcelebrant
  2975. ----------------------------------------------------------------------------------
  2976. PUTFAMUSER1 command:
  2977.     SYNTAX:    PUTFAMUSER1 CurrentFGRN "Field contents"
  2978.  
  2979.     where: CurrentFGRN is the FGRN of the family
  2980.            of interest in the Scion database
  2981.  
  2982.            Set the "user 1" field of the specified Family in the
  2983.            database to the quoted string "Field contents".
  2984.            By default, this field is labelled "Celebrant"
  2985.  
  2986.     result: none (database updated)
  2987.  
  2988. EXAMPLE USAGE:
  2989.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  2990.     Address value MyPort    /* Change ARexx address to that port */
  2991.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  2992.     PUTFAMUSER1 MyFGRN "Rev John Smith"    /* Issue command */
  2993.  
  2994.  
  2995. ----------------------------------------------------------------------------------
  2996. putfamcomment
  2997. ----------------------------------------------------------------------------------
  2998. PUTFAMUSER2 command:
  2999.     SYNTAX:    PUTFAMUSER2 CurrentFGRN "Field contents"
  3000.  
  3001.     where: CurrentFGRN is the FGRN of the family
  3002.            of interest in the Scion database
  3003.  
  3004.            Set the "user 2" field of the specified Family in the
  3005.            database to the quoted string "Field contents".
  3006.            By default, this field is labelled "Comment"
  3007.  
  3008.     result: none (database updated)
  3009.  
  3010. EXAMPLE USAGE:
  3011.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3012.     Address value MyPort    /* Change ARexx address to that port */
  3013.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  3014.     PUTFAMUSER2 MyFGRN "No children recorded"   /* Issue command */
  3015.  
  3016.  
  3017. ----------------------------------------------------------------------------------
  3018. putnewperson
  3019. ----------------------------------------------------------------------------------
  3020. PUTNEWPERSON command:
  3021.     SYNTAX:    PUTNEWPERSON
  3022.  
  3023.                 Create a new personal record in the database.
  3024.  
  3025.     result: IRN of new record created. A return value of 0 signifies
  3026.             a command failure because of no free space remaining.
  3027.  
  3028. EXAMPLE USAGE:
  3029.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3030.     Address value MyPort    /* Change ARexx address to that port */
  3031.     PUTNEWPERSON
  3032.     If RESULT = 0 then say "Command failed"
  3033.     else say "IRN of new record = " RESULT
  3034.  
  3035.  
  3036. ----------------------------------------------------------------------------------
  3037. putnewfamily
  3038. ----------------------------------------------------------------------------------
  3039. PUTNEWFAMILY command:
  3040.     SYNTAX:    PUTNEWFAMILY CurrentIRN
  3041.  
  3042.     where: CurrentIRN is the IRN of the person that a new family
  3043.            group is required for.
  3044.  
  3045.                Create a new family group record in the database. The person
  3046.            specified by the "CurrentIRN" argument will be established
  3047.            as the Principal of that new family group. If the specified
  3048.            person already has existing marriages, this command will
  3049.            add an ADDITIONAL family group to that person's list of
  3050.            marriages.
  3051.  
  3052.     result: FGRN of new record created. A return value of 0 signifies
  3053.             a command failure because of no free space remaining.
  3054.  
  3055. EXAMPLE USAGE:
  3056.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3057.     Address value MyPort    /* Change ARexx address to that port */
  3058.     MyIRN = 5        /* Set MyIRN to person 5 */
  3059.     PUTNEWFAMILY MyIRN
  3060.     If RESULT = 0 then say "Command failed"
  3061.     else say "FGRN of new record = " RESULT
  3062.  
  3063.  
  3064. ----------------------------------------------------------------------------------
  3065. putspouse
  3066. ----------------------------------------------------------------------------------
  3067. PUTSPOUSE command:
  3068.     SYNTAX:    PUTSPOUSE CurrentFGRN SpouseIRN
  3069.  
  3070.     where: CurrentFGRN is the FGRN of the family group that the spouse
  3071.            will be added to.
  3072.            
  3073.            SpouseIRN is the IRN of the person to add to the family
  3074.            group as the spouse.
  3075.  
  3076.                Add a spouse to an existing family group. Any existing
  3077.            spouse is replaced, but children and other family group
  3078.            details remain unchanged. If "SpouseIRN" = 0, then the
  3079.            existing spouse in the family group is deleted from that
  3080.            group (no new spouse is added).
  3081.  
  3082.     result: A return value of 1 signifies success. Other return values
  3083.             are as follows:
  3084.         
  3085.          0 = invalid command ("SpouseIRN" was probably omitted) or
  3086.              specified family does not exist
  3087.         -1 = specified spouse does not exist.
  3088.         -2 = the spouse's personal record has been previously
  3089.              deleted from the database.
  3090.         -3 = the selected spouse is the same person as the
  3091.              principal of the family group.
  3092.         -4 = the selected spouse has already been married the
  3093.              maximum number of times permitted.
  3094.         -5 = the selected spouse is already a child of the
  3095.              family group.
  3096.         -6 = the selected spouse is a child of one of the children
  3097.              in the family group.
  3098.  
  3099. EXAMPLE USAGE:
  3100.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3101.     Address value MyPort    /* Change ARexx address to that port */
  3102.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  3103.     SpouseIRN = 12        /* Set SpouseIRN to 12 */
  3104.     PUTSPOUSE MyFGRN SpouseIRN
  3105.     if RESULT = 1 THEN Say "Success!"
  3106.     else Say "Failed: Error return value = " RESULT
  3107.  
  3108.  
  3109. ----------------------------------------------------------------------------------
  3110. putchild
  3111. ----------------------------------------------------------------------------------
  3112. PUTCHILD command:
  3113.     SYNTAX:    PUTCHILD CurrentFGRN ChildIRN
  3114.  
  3115.     where: CurrentFGRN is the FGRN of the family group that the child
  3116.            will be added to.
  3117.            
  3118.            ChildIRN is the IRN of the person to add to the family
  3119.            group as a child.
  3120.  
  3121.                Add a child to an existing family group.
  3122.  
  3123.     result: A return value of 1 signifies success. Other return values
  3124.             are as follows:
  3125.         
  3126.          0 = invalid command ("ChildIRN" was omitted) or
  3127.              specified family does not exist.
  3128.         -1 = specified child does not exist.
  3129.         -2 = the family already has the maximum number of children
  3130.         -3 = the child's personal record has been previously
  3131.              deleted from the database.
  3132.         -4 = the selected child already has parents defined
  3133.         -5 = the selected child is one of the parents of the
  3134.              family group.
  3135.         -6 = the selected child is a parent of the principal
  3136.              of the family group.
  3137.         -7 = the selected child is a parent of the spouse
  3138.              of the family group.
  3139.  
  3140. EXAMPLE USAGE:
  3141.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3142.     Address value MyPort    /* Change ARexx address to that port */
  3143.     MyFGRN = 5        /* Set MyFGRN to family 5 */
  3144.     ChildIRN = 12        /* Set ChildIRN to 12 */
  3145.     PUTCHILD MyFGRN ChildIRN
  3146.     if RESULT = 1 THEN Say "Success!"
  3147.     else Say "Failed: Error return value = " RESULT
  3148.  
  3149.  
  3150. ----------------------------------------------------------------------------------
  3151. getpersonwin
  3152. ----------------------------------------------------------------------------------
  3153. GETPERSONWIN command:
  3154.     SYNTAX:    GETPERSONWIN ShowIRN
  3155.  
  3156.     where: ShowIRN is the IRN of the person to display.
  3157.  
  3158.                Move to the specified person's data record and display it.
  3159.            (Bring Personal Window to the front)
  3160.  
  3161.     result: A return value of 1 (TRUE) signifies success. A return
  3162.             value of 0 (FALSE) signifies failure.
  3163.         
  3164.  
  3165. EXAMPLE USAGE:
  3166.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3167.     Address value MyPort    /* Change ARexx address to that port */
  3168.     ShowIRN = 12        /* Set ShowIRN to 12 */
  3169.     GETPERSONWIN ShowIRN    /* Display person's record */
  3170.     if RESULT = 1 THEN Say "Success!"
  3171.     else Say "Failed"
  3172.  
  3173.  
  3174. ----------------------------------------------------------------------------------
  3175. getfamilywin
  3176. ----------------------------------------------------------------------------------
  3177. GETFAMILYWIN command:
  3178.     SYNTAX:    GETFAMILYWIN ShowFGRN
  3179.  
  3180.     where: ShowFGRN is the FGRN of the family group to display.
  3181.  
  3182.                Move to the specified family's data record and display it.
  3183.            (Bring Family Window to the front)
  3184.  
  3185.     result: A return value of 1 (TRUE) signifies success. A return
  3186.             value of 0 (FALSE) signifies failure.
  3187.         
  3188.  
  3189. EXAMPLE USAGE:
  3190.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3191.     Address value MyPort    /* Change ARexx address to that port */
  3192.     ShowFGRN = 12        /* Set ShowFgRN to 12 */
  3193.     GETFAMILYWIN ShowFGRN    /* Display family's record */
  3194.     if RESULT = 1 THEN Say "Success!"
  3195.     else Say "Failed"
  3196.  
  3197.  
  3198. ----------------------------------------------------------------------------------
  3199. getprogversion
  3200. ----------------------------------------------------------------------------------
  3201. GETPROGVERSION command:
  3202.     SYNTAX:    GETPROGVERSION
  3203.  
  3204.                Get version number of Scion Genealogist
  3205.  
  3206.     result: Programme version number
  3207.  
  3208. EXAMPLE USAGE:
  3209.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3210.     Address value MyPort    /* Change ARexx address to that port */
  3211.     GETPROGVERSION        /* Get programme version number */
  3212.     Say "Programme version number is " RESULT
  3213.  
  3214.  
  3215. ----------------------------------------------------------------------------------
  3216. getlanguage
  3217. ----------------------------------------------------------------------------------
  3218. GETLANGUAGE command:
  3219.     SYNTAX:    GETLANGUAGE
  3220.  
  3221.                Get current language that Scion Genealogist is using
  3222.  
  3223.     result: language being used (e.g. "english.language",
  3224.             "deutsch.language")
  3225.  
  3226. EXAMPLE USAGE:
  3227.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3228.     Address value MyPort    /* Change ARexx address to that port */
  3229.     GETLANGUAGE        /* Get current language */
  3230.     Say "Current language is " RESULT
  3231.  
  3232.  
  3233. ----------------------------------------------------------------------------------
  3234. getperslabel
  3235. ----------------------------------------------------------------------------------
  3236. GETPERSLABEL command:
  3237.     SYNTAX:    GETPERSLABEL LabelNumber
  3238.  
  3239.     where: LabelNumber is the "number" of the Personal Details Window
  3240.            user defined label. By default:
  3241.            
  3242.                 1 = "Occupation"
  3243.                 2 = "Comments"
  3244.                 3 = "References"
  3245.  
  3246.                Get Personal Details Window user defined label.
  3247.  
  3248.     result: Current content of user-defined label
  3249.  
  3250. EXAMPLE USAGE:
  3251.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3252.     Address value MyPort    /* Change ARexx address to that port */
  3253.     GETPERSLABEL 1        /* Get label number 1 */
  3254.     Say "User defined personal label #1 is " RESULT
  3255.  
  3256.  
  3257. ----------------------------------------------------------------------------------
  3258. getfamlabel
  3259. ----------------------------------------------------------------------------------
  3260. GETFAMLABEL command:
  3261.     SYNTAX:    GETFAMLABEL LabelNumber
  3262.  
  3263.     where: LabelNumber is the "number" of the Family Details Window
  3264.            user defined label. By default:
  3265.            
  3266.                 1 = "Celebrant"
  3267.                 2 = "Comments"
  3268.  
  3269.                Get Family Details Window user defined label.
  3270.  
  3271.     result: Current content of user-defined label
  3272.  
  3273. EXAMPLE USAGE:
  3274.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3275.     Address value MyPort    /* Change ARexx address to that port */
  3276.     GETFAMLABEL 1        /* Get label number 1 */
  3277.     Say "User defined family label #1 is " RESULT
  3278.  
  3279.  
  3280. ----------------------------------------------------------------------------------
  3281. putperslabel
  3282. ----------------------------------------------------------------------------------
  3283. PUTPERSLABEL command:
  3284.     SYNTAX:    PUTPERSLABEL LabelNumber LabelString
  3285.  
  3286.     where: LabelNumber is the "number" of the Personal Details Window
  3287.            user defined label. By default:
  3288.            
  3289.                 1 = "Occupation"
  3290.                 2 = "Comments"
  3291.                 3 = "References"
  3292.  
  3293.                LabelString is the new label string for the specfied label
  3294.  
  3295.                Set Personal Details Window user defined label.
  3296.  
  3297.     result: A return value of 1 (TRUE) signifies success. A return
  3298.             value of 0 (FALSE) signifies failure.
  3299.  
  3300. EXAMPLE USAGE:
  3301.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3302.     Address value MyPort    /* Change ARexx address to that port */
  3303.     PUTPERSLABEL 1 "Education" /* Set new string for label number 1
  3304.                                       to be "Education" */
  3305.     if RESULT = 1 THEN Say "Success!"
  3306.     else Say "Failed"
  3307.  
  3308.  
  3309. ----------------------------------------------------------------------------------
  3310. putfamlabel
  3311. ----------------------------------------------------------------------------------
  3312. PUTFAMLABEL command:
  3313.     SYNTAX:    PUTFAMLABEL LabelNumber LabelString
  3314.  
  3315.     where: LabelNumber is the "number" of the Family Details Window
  3316.            user defined label. By default:
  3317.            
  3318.                 1 = "Celebrant"
  3319.                 2 = "Comments"
  3320.  
  3321.                LabelString is the new label string for the specfied label
  3322.  
  3323.                Set Family Details Window user defined label.
  3324.  
  3325.     result: A return value of 1 (TRUE) signifies success. A return
  3326.             value of 0 (FALSE) signifies failure.
  3327.  
  3328. EXAMPLE USAGE:
  3329.     MyPort = "SCIONGEN"    /* Point at Scion Genealogist port */
  3330.     Address value MyPort    /* Change ARexx address to that port */
  3331.     PUTFAMLABEL 1 "Priest"    /* Set new string for label number 1
  3332.                                    to be "Priest" */
  3333.     if RESULT = 1 THEN Say "Success!"
  3334.     else Say "Failed"
  3335.  
  3336.  
  3337. ----------------------------------------------------------------------------------
  3338. IRN
  3339. ----------------------------------------------------------------------------------
  3340.                       IRN - Individual Record Number
  3341.  
  3342. Every person in the database is automatically assigned a unique IRN. These
  3343. numbers will NEVER change, even if people are deleted from the database. A
  3344. deleted person's IRN will be automatically reassigned whenever a new person
  3345. is added to the database.
  3346.  
  3347.  
  3348. ----------------------------------------------------------------------------------
  3349. FGRN
  3350. ----------------------------------------------------------------------------------
  3351.                     FGRN - Family Group Record Number
  3352.  
  3353. Every family in the database is automatically assigned a unique FGRN.
  3354. These numbers will NEVER change, even if families are deleted from the
  3355. database. A deleted family's FGRN will be automatically reassigned whenever
  3356. a new family is added to the database.
  3357.  
  3358.  
  3359. ----------------------------------------------------------------------------------
  3360. WildCard
  3361. ----------------------------------------------------------------------------------
  3362.                             "Wildcards"
  3363.  
  3364. In either the "Personal Search" or "Family Search" requesters, the use of
  3365. "wildcards" is permitted in both name fields. Wildcards are also permitted
  3366. in the last name field of "people list" and "family list" requesters.
  3367.  
  3368. WILDCARDS:
  3369.  
  3370.         ?   - matches any single character
  3371.        c*   - matches zero or more occurrences of character c
  3372.        ?*   - matches zero or more occurrences of ANY character
  3373.               (ie. matches anything. These are the default wildcards)
  3374.        c+   - matches one or more occurrences of character c
  3375.        \?   - matches a question mark (?)
  3376.        \*   - matches an asterisk (*)
  3377.        \+   - matches a plus sign (+)
  3378.  
  3379. EXAMPLES:
  3380.  
  3381.     "tom"    - matches only "tom" anywhere in a name
  3382.     "to*m"   - matches "tm", "tom" or "toom", etc.
  3383.     "to+m"   - matches "tom", "toom" or "tooom", etc.
  3384.     "to?*m"  - matches any part of a name beginning with "to"
  3385.                and ending in "m", e.g. "toejam"
  3386.     "ab\+c"  - matches only "ab+c"
  3387.  
  3388. Note that the search patterns are "un-anchored" - this means that the name
  3389. entered in a field will match that name ANYWHERE in the database. For
  3390. example, a search for a Last Name of "Smith" will match with "Smithson" and
  3391. "Blacksmith" as well as "Smith".
  3392.  
  3393.  
  3394. ----------------------------------------------------------------------------------
  3395. FreeFormNotes
  3396. ----------------------------------------------------------------------------------
  3397.                               Free Form Notes
  3398.  
  3399. Scion Genealogist allows you to create and edit note files of any size
  3400. using any editor of your choice. The editor to use is set up by selecting
  3401. the 'Choose Editor' option from the 'Prefs' menu.
  3402.  
  3403. Personal notes are accessed by clicking on the 'Edit Notes' gadget in the
  3404. Personal Details Window, and family notes are accessed by clicking on the
  3405. 'Edit Notes' gadget in the Family Details Window.
  3406.  
  3407. 'Tested Editors'
  3408.  
  3409.  
  3410. ----------------------------------------------------------------------------------
  3411. Pictures
  3412. ----------------------------------------------------------------------------------
  3413.                               Viewing Pictures
  3414.  
  3415. Scion Genealogist allows you to view IFF picture files using any picture
  3416. viewer of your choice. The viewer to use is set up by selecting the
  3417. 'Choose Viewer' option from the 'Prefs' menu.
  3418.  
  3419. Personal pictures are accessed by clicking on the 'View Picture' gadget in
  3420. the Personal Details Window, and family pictures are accessed by clicking
  3421. on the 'View Picture' gadget in the Family Details Window.
  3422.  
  3423.  
  3424. ----------------------------------------------------------------------------------
  3425. Hints
  3426. ----------------------------------------------------------------------------------
  3427.                            SOME COMMON QUESTIONS
  3428.  
  3429. WHAT IS THE BEST WAY TO SET ABOUT CREATING MY DATABASE?
  3430.  
  3431.       PREPARE!   PREPARE!   PREPARE!   PREPARE!   PREPARE!   PREPARE!
  3432.  
  3433.       Make sure that you have ALL possible information available
  3434.       before you start (with all the inter-personal and family relations
  3435.       sorted out). It will make things MUCH easier if you have a good
  3436.       idea what you are planning to do before you start!
  3437.  
  3438.       It is recommended that you enter all the information you can about
  3439.       the various people making up your database FIRST, working in the
  3440.       Personal Details Windows. Then establish the relationships between
  3441.       these people by "marrying" couples and adding children to the
  3442.       resulting family groups.  Parents are established by adding people
  3443.       to a family group as children.
  3444.  
  3445.  
  3446. HOW DO I GET THE PROGRAMME TO PRINT THE LIST OF PEOPLE IN THE DATABASE
  3447. IN ALPHABETICAL ORDER INSTEAD OF IN NUMERICAL ORDER?
  3448.       Before printing the report, select 'Extras' from the menu bar and
  3449.       choose the 'Sorting On/Off' menu item.
  3450.  
  3451.       If the report is to be printed alphabetically, an [S] ("sorted")
  3452.       marker will be displayed in the window title bar. If the report is
  3453.       to be printed in IRN numerical order, this marker will be absent.
  3454.  
  3455. HOW DO I PRINT REPORTS TO A DISK FILE RATHER THAN TO THE PRINTER?
  3456.       Use the AmigaDOS command "CMD" to re-direct printer output to a file.
  3457.       Refer to your Amiga manual for more information.
  3458.  
  3459.       NOTE: The pedigree charts printed by Scion Genealogist rely on
  3460.             the back-spacing capability of your printer. Pedigree charts
  3461.         printed to a file might not be readily interpreted.
  3462.  
  3463. HOW DO I PRINT THE FREE-FORM NOTES I HAVE CREATED?
  3464.       Use the printing features of your chosen text editor to print the
  3465.       notes. If your editor does not support printing, use the AmigaDOS
  3466.       command "PrintFiles". Refer to your Amiga manual for more
  3467.       information.
  3468.  
  3469. HOW DO I ASSIGN A NAME TO MY DATABASE?
  3470.       When you select the 'Save As...' item from the 'Project' menu you are
  3471.       presented with a file requester. Simply type the new name for your
  3472.       database in the box near the bottom of the requester. The name of
  3473.       the database will also be used as a "suffix" for your free form
  3474.       notes and picture files.
  3475.  
  3476.       NOTE: It is strongly recommended that you "name" your database as
  3477.             soon as you start working on it. For example, add one person
  3478.         to the database and then save the database with a suitable
  3479.         name. This will then establish its name (for notes, etc).
  3480.  
  3481.  
  3482. I TRY TO LOAD MY DATABASE FILE AND NOTHING HAPPENS!
  3483.       It probably means that your database file is too big for the
  3484.       remaining memory in your computer. Either:
  3485.  
  3486.       (1) you created the database on a computer with more memory, in
  3487.           which case you will need to continue with the other computer
  3488.       or buy more memory, or
  3489.  
  3490.       (2) you have one or more other application programmes running at
  3491.           the moment, in which case you should close them down to free
  3492.       up some memory.
  3493.  
  3494.  
  3495. WHEN I CLICK ON ONE OF THE "EDIT NOTES" GADGETS, ALL I GET IS A BRIEF
  3496. FLASH OF THE WORKBENCH SCREEN?
  3497.       Either:
  3498.  
  3499.       (1) your specified editor is not available (have you removed the
  3500.           disk, where it is located, from your disk drive?), or
  3501.  
  3502.       (2) you do not have enough memory left to run the editor, or
  3503.  
  3504.       (3) your chosen editor will not run from this environment (try
  3505.           using a different editor). 'Tested Editors'
  3506.  
  3507.  
  3508. WHEN I CLICK ON ONE OF THE "VIEW PICTURE" GADGETS, ALL I GET IS A BRIEF
  3509. FLASH OF THE WORKBENCH SCREEN?
  3510.       Either:
  3511.  
  3512.       (1) the picture file you have specified does not exist, or
  3513.  
  3514.       (2) your specified picture viewer is not available (have you
  3515.           removed the disk, where it is located, from your disk drive?),
  3516.       or
  3517.  
  3518.       (3) you do not have enough memory left to run the picture viewer
  3519.           (try using a different viewer), or
  3520.  
  3521.       (4) your chosen picture viewer will not run from this environment.
  3522.  
  3523.  
  3524. WHEN I TRY TO USE THE EDITOR OR VIEWER I GET "Error 103 detected"
  3525. MESSAGES. I HAVE PLENTY OF FREE MEMORY, SO WHY THE ERROR?
  3526.       You have probably 'launched' Scion Genealogist via one of the
  3527.       utility 'launching' programmes such as "AmiDock", "ToolsDaemon",
  3528.       or "ToolsManager" with Scion Genealogist specified as a 'CLI'
  3529.       type of programme.
  3530.  
  3531.       These 'launching' programmes require you to specify whether the
  3532.       programme you wish to launch is a "CLI" or "Workbench" type of
  3533.       programme. To eliminate these "Error 103 detected" messages when
  3534.       using one of these 'launching' programmes, make sure you specify
  3535.       Scion Genealogist as a "Workbench" type programme.
  3536.  
  3537. WHAT ARE THE FILES NAMED "PN1.unnamed", "FN1.unnamed", ETC. THAT I
  3538. FIND IN MY DATABASE DIRECTORY (DRAWER)?
  3539.       You have created free form notes without first naming the database.
  3540.       Refer to 'Edit Personal Notes' and 'Edit Family Notes'
  3541.  
  3542.  
  3543. HOW DO I MARRY A PERSON MORE THAN ONCE?
  3544.       Establish the first marriage for the person by clicking on the
  3545.       'Set 1st Marriage' gadget in the Personal Details Window for
  3546.       that person. This will place you in the first Family Details Window
  3547.       with that person as "Principal".
  3548.  
  3549.       To create another marriage for that Principal, click on the
  3550.       'New Marriage' gadget in the Family Details Window. You will be
  3551.       asked if you want to create a new family group for that Principal.
  3552.       Answer "yes" and continue as you did for the first marriage by first
  3553.       adding a new Spouse (for the second marriage) and then adding the
  3554.       children of the second marriage.
  3555.  
  3556.  
  3557. HOW DO I MAKE THE "SPOUSE" IN A FAMILY DETAILS WINDOW INTO THE "PRINCIPAL"?
  3558.       Either:
  3559.  
  3560.       (1) Click on the 'Exchange' gadget in the Family Details window, or
  3561.  
  3562.       (2) From the Family Details Window, click on the 'S' (Select Spouse)
  3563.           gadget. You will be returned to the Personal Details Window for
  3564.       the Spouse. Now click on the 'Spouse/Children' gadget for that
  3565.       person. You will be returned to the Family Details Window with
  3566.       the person now listed as the Principal.
  3567.  
  3568. HOW DO I CHANGE THE SPOUSE IN A FAMILY GROUP TO A DIFFERENT PERSON?
  3569.       From the appropriate Family Details Window, click on the
  3570.       'Set Spouse' gadget. You will be asked if you wish to remove
  3571.       the existing spouse and (optionally) replace with a new spouse.
  3572.  
  3573.       Answer "yes".
  3574.  
  3575.       You will then be presented with a list of the people currently in
  3576.       the database. Click on the name of the person that you wish to be
  3577.       the new spouse.
  3578.  
  3579. HOW DO I DELETE A SPOUSE FROM A FAMILY GROUP?
  3580.       From the appropriate Family Details Window, click on the
  3581.       'Set Spouse' gadget. You will be asked if you wish to remove
  3582.       the existing spouse and (optionally) replace with a new spouse.
  3583.  
  3584.       Answer "yes".
  3585.  
  3586.       At this point the existing spouse will be removed, and you will be
  3587.       presented with a list of the people currently in the database. Click
  3588.       on the "Cancel" gadget at the bottom of the list. The original
  3589.       spouse has now been removed from the family group.
  3590.  
  3591.       NOTE: If you need to re-instate the original spouse to the family
  3592.             group, click on the "Set Spouse" gadget again and add
  3593.         them (from the displayed list) to the family group.
  3594.  
  3595. HOW DO I QUICKLY MOVE FROM PERSON TO PERSON WHERE ALL THE PEOPLE OF
  3596. INTEREST HAVE THE SAME LAST NAME?
  3597.       Click on "Personal Search" gadget, and enter the last name in which
  3598.       you are interested into the Last Name field of the requester. Click
  3599.       on "Find First", "Find Next" or "Find Prev" to locate the next
  3600.       person.
  3601.  
  3602.       From the Personal details window (with no data entry field active)
  3603.       press "P" to bring up the search requester, and then either "N" or
  3604.       "P" to find the next or previous person with that same last name.
  3605.  
  3606.       In this way, repeatedly pressing "P" then "N" will progressively
  3607.       display the next person in the database with the name of interest.
  3608.  
  3609.       NOTE: This same technique may be used to "browse" families, but
  3610.             the search will be initiated by pressing the "F" key (for
  3611.         "Family Search", and then followed by "N" or "P".
  3612.  
  3613. I HAVE MORE THAN 1000 PEOPLE IN MY DATABASE. HOW DO I COPE WITH THIS?
  3614.       Split your database in half. For example, if you are tracing your
  3615.       OWN family tree, try making one database starting with your father
  3616.       and another database starting with your mother.
  3617.  
  3618.  
  3619.  
  3620. ----------------------------------------------------------------------------------
  3621. LDS
  3622. ----------------------------------------------------------------------------------
  3623.                          LDS Compatibility
  3624.  
  3625. The Church of Jesus Christ of Latter Day Saints (LDS for short), requires
  3626. that additional information particular to that church be recorded.
  3627.  
  3628. To achieve a level of LDS compatibility, use the user-defined field labels
  3629. in the following manner:
  3630.  
  3631.     Select the 'Set User Labels' option under the 'Prefs' menu.
  3632.     Set Personal Label 1 to "Baptism"
  3633.     Set Personal Label 2 to "Endowment"
  3634.     Set Personal Label 3 to "C/P Sealing"
  3635.     Set Family Label 1 to "W/H Sealing"
  3636.  
  3637. Use these fields to enter information as follows:
  3638.  
  3639.     Baptism     - enter baptism date and temple.
  3640.                   Eg. "23 May 1947  Temple: Hamilton, NZ
  3641.  
  3642.     Endowment   - enter endowment date and temple.
  3643.                   Eg. "23 Jun 1983  Temple: Hataitai, NZ
  3644.  
  3645.     C/P Sealing - enter child to parents sealing date and temple.
  3646.                   Eg. "14 Aug 1972  Temple: Christchurch, NZ
  3647.  
  3648.     W/H Sealing - enter wife to husband sealing date and temple.
  3649.                   Eg. "11 Nov 1957  Temple: Wellington, NZ
  3650.  
  3651. (Don't forget to type the word "Temple:" into the entry field!)
  3652.  
  3653. ----------------------------------------------------------------------------------
  3654. TestedEditors
  3655. ----------------------------------------------------------------------------------
  3656. The following editors have been tested for compatibility with Scion
  3657. Genealogist:
  3658.  
  3659. These DO work:
  3660.  
  3661. 1: "Mg2a" (formerly MicroGnuEmacs) Text Editor. Copyright various
  3662.  
  3663. 2: "Mg3a" (formerly MicroGnuEmacs) Text Editor. Copyright various
  3664.  
  3665. 3: "MicroEMACS" V2.1 Text Editor. Copyright © 1986 by Commodore-Amiga, Inc.
  3666.     (Authors David Conroy & Andy Finkel). Supplied with Amiga computer
  3667.  
  3668. 4: "Scribble!" V2.00 Word Processor. Copyright © by Micro-Systems Software
  3669.  
  3670. 5: "TurboText" Text Editor. Copyright © 1991 by Martin Taillefer
  3671.  
  3672. 6: "MicroEMACS" V3.9 Text Editor. Copyright © 1987 by David M Lawrence
  3673.  
  3674. 7: "CygnusEd Professional" Text Editor. Copyright © by CygnusSoft Software
  3675.  
  3676. 8: "VizaWrite" Word Processor. Copyright © Viza Software
  3677.  
  3678. 9: "Excellence!" Word Processor. Copyright © by Micro-Systems Software
  3679.  
  3680. 10:"Ed" V2.0 Text Editor. Copyright © 1991 by Commodore-Amiga, Inc.
  3681.     (Authors David Conroy & Andy Finkel). Supplied with Amiga computer
  3682.  
  3683. 11:"Final Copy II". Copyright © by Softwood Inc.
  3684.  
  3685. 12:"DME". Copyright © by Mathew Dillon.
  3686.  
  3687. 13:"PageLiner". Copyright © by Soft-Logik Publishing Corp.
  3688.  
  3689. 14:"Articel Editor". Copyright © by Gold disk.
  3690.  
  3691.     My thanks to Peter Billing of Yinnar, Australia, for supplying me with
  3692.     "compatibility" information for numbers 11 - 14 inclusive.
  3693.  
  3694. These do NOT work:
  3695.  
  3696. 1: "QED" V1.0 Text Editor. Copyright © 1989 by Darren M. Greenwald
  3697.  
  3698. 2: "Text Plus" V3.0 Text Editor. Copyright © by Martin Steppler
  3699.  
  3700. 3: "WordPerfect" Word Processor. Copyright © by WordPerfect Corporation
  3701.  
  3702. 4: "Textra" V1.13 Text Editor. Copyright © 1993 by Mike Haas
  3703.  
  3704.  
  3705. ----------------------------------------------------------------------------------
  3706. Specification
  3707. ----------------------------------------------------------------------------------
  3708.                   Programme Specification and Requirements
  3709.  
  3710. Database stored in RAM for maximum speed.
  3711.  
  3712. Works with floppy and/or hard disk drives.
  3713.  
  3714. Maximum number of people per database = 999
  3715. Maximum number of marriages per person = 10
  3716. Maximum number of children per family group = 40
  3717.  
  3718. Available reports:
  3719.         List of People (in IRN numerical order or alphabetical order)
  3720.     List of Family Groups
  3721.     Personal Summary
  3722.     Family Group Sheet
  3723.     Pedigree Chart
  3724.     Descendant Chart
  3725.  
  3726. REQUIREMENTS:
  3727.  
  3728.     1 Mbyte of RAM required for maximum sized database. Reduced size
  3729.     databases possible with 512 kbytes.
  3730.  
  3731.     Kickstart/Workbench v2.04 (or later) required. Version 2.10 (or
  3732.         later) required for locale support (alternative languages).
  3733.  
  3734.     Any preferences supported printer capable of printing 80 columns
  3735.     in normal mode, and 130 columns in condensed (fine) mode. Back-
  3736.     spacing capability required for printing pedigree charts.
  3737.  
  3738. See 'Version Information' for more about the features of each release
  3739. version of the programme.
  3740.  
  3741.  
  3742. ----------------------------------------------------------------------------------
  3743. VersionInfo
  3744. ----------------------------------------------------------------------------------
  3745.                           Version Information
  3746.  
  3747. 3.04:   This was the first public release of the programme, when it was
  3748.         known as ArJay Genealogist.
  3749.  
  3750. 3.05:   Internal beta release of 3.06 (see below). Not released publicly.
  3751.  
  3752. 3.06:   Programme renamed to Scion Genealogist.
  3753.  
  3754.       - Some bug fixes:
  3755.             (1) Programme did not support shortcut keys correctly
  3756.             with European mapped keyboards. This has now been
  3757.         corrected, and shortcut keys are "simple" keyboard
  3758.         characters (rather than ALT characters) to conform
  3759.         with interface guidelines.
  3760.         (2) There was a very subtle bug that got past ALL my
  3761.             debugging tools (including enforcer - which SHOULD
  3762.         have found it!). This bug caused the programme to
  3763.         think that a child (being added to a family group)
  3764.         was (erroneously) a parent of one of its own parents.
  3765.         HOPEFULLY this has been fixed.
  3766.             (3) Circumvented a bug in "amigaguide.library"® (it didn't
  3767.                 release a lock on the help file). The disk icon will
  3768.                 now go away when the disk is ejected.
  3769.         (4) Some very minor bugs that nobody reported or probably
  3770.             even noticed!
  3771.  
  3772.       - New features:
  3773.             (1) "Pick list" of last names added to reduce typing and
  3774.             to help ensure name spelling is consistent. See 'Pick'.
  3775.             (2) Database loading is now about 2½ times faster.
  3776.             (3) Can now type in IRN (or FGRN) to go directly to a
  3777.             particular record (using the '^' gadget in the Personal
  3778.         Details Window, or the '^' gadget in the Family
  3779.         Details Window).
  3780.             (4) "Add Spouse" gadget changed to 'Set Spouse'. This gadget
  3781.             now permits removal of an existing spouse (without
  3782.         dissolving the whole family group), the changing of an
  3783.         existing spouse to another, or adding a new spouse (as
  3784.         before).
  3785.             (5) An additional data field has been added to the Personal
  3786.             Details Window.
  3787.             (6) The last three data fields in the Personal Details
  3788.             Window and the last two fields in the Family Details
  3789.         Window now have user configurable labels. (Possible
  3790.         LDS compatibility)
  3791.             (7) The original 'Spouse/Children' gadget is now purely a
  3792.             "navigation" gadget and will take you to the Family
  3793.         Details Window for the current person's spouse and
  3794.         children. To establish the FIRST marraige (family
  3795.         group) for the current person, use the new
  3796.         'Set 1st Marriage' gadget.
  3797.  
  3798.         Similarly in the Family Details Window, the "».." (next
  3799.         marriage) gadget is also now purely a "navigation" gadget.
  3800.         To establish further marriages for the current principal,
  3801.         use the new 'New Marriage' gadget.
  3802.         (8) Some changes to the menus layout.
  3803.         (9) "Find Previous" gadget added to search requester. Search
  3804.             requester can now be conveniently used as a "browser".
  3805.            (10) Option to print IRN's of each person on a descendant
  3806.             chart.
  3807.            (11) New 'Go to Family' and 'Go to Person' gadgets to go
  3808.             directly to the appropriate details window when the FGRN
  3809.         or IRN is known.
  3810.            (12) New 'Fath' (Go to Father) and 'Moth' (Go to Mother)
  3811.             gadgets to go directly to the Personal Details Window for
  3812.         the currently displayed person's father or mother.
  3813.            (13) New 'Set Behaviour' menu item that allows the user to set:
  3814.                 - Whether confirmation is required on "Add New Person"
  3815.                 - Whether first names should be capitalized
  3816.                 - Whether event place names (such as Birth Place) should
  3817.           be capitalized
  3818.         - Whether the current Last Name should automatically be
  3819.           carried over into the Last Name field of a new person.
  3820.            (14) New "Save" menu item (in addition to "Save As..." option).
  3821.            (15) Children of a family group are sorted by date of birth.
  3822.             See also 'Dates'.
  3823.  
  3824. 3.07:   Internal beta release. Not released publicly.
  3825.  
  3826. 3.08:   Internal beta release. Not released publicly.
  3827.  
  3828. 3.09:   Internal beta release. Not released publicly.
  3829.  
  3830. 3.10:   Internal beta release. Not released publicly.
  3831.  
  3832. 3.11:   Internal beta release. Not released publicly.
  3833.  
  3834. 3.12:   Internal beta release. Not released publicly.
  3835.  
  3836. 3.13:   New public release.
  3837.  
  3838.       - Some minor bug fixes
  3839.  
  3840.       - New features:
  3841.             (1) Programme is now localized with catalogs for German, Dutch
  3842.             and French. Kickstart/Workbench v2.10 (or later) is required
  3843.                 for locale support.
  3844.             (2) Filtering of people in people lists and filtering of
  3845.                 partners in family lists. See 'List People' and 
  3846.                 'List Families'.
  3847.             (3) New ARexx commands :
  3848.                 'PUTNEWPERSON  '   'PUTNEWFAMILY  '
  3849.                 'PUTSPOUSE     '   'PUTCHILD      '
  3850.                 'GETPERSONWIN  '   'GETFAMILYWIN  '
  3851.         'GETPROGVERSION'
  3852.  
  3853.  
  3854. ----------------------------------------------------------------------------------
  3855. Credits
  3856. ----------------------------------------------------------------------------------
  3857.   ________________________________________________________________________
  3858.  
  3859.                            Scion Genealogist
  3860.   ________________________________________________________________________
  3861.  
  3862.   Scion Genealogist is a genealogical database programme for managing
  3863.   information about your "family tree" and printing a variety of reports.
  3864.  
  3865.   This programme is FREEWARE and is NOT to be sold (although a nominal
  3866.   charge may be made for copying). If you would would like to make a
  3867.   contribution to its author, or report on any bugs or suggested
  3868.   enhancements, please address any correspondence to:
  3869.  
  3870.                             Robbie J Akins
  3871.                         5 Austin Street
  3872.                 Wellington 6001
  3873.                 NEW ZEALAND
  3874.  
  3875.                 EMAIL: rakins@BCLEng.co.nz
  3876.  
  3877.   Thanks to Jan van den Baard for "GadToolsBox" © Copyright 1991,92 Jaba
  3878.   Development - it certainly made programming the user interface a lot
  3879.   less painful!
  3880.  
  3881.   Particular thanks also to the following people for their invaluable help
  3882.   and suggestions:
  3883.  
  3884.         Ralf Schulz in Borsfleth, Germany
  3885.         Freddy Ariës in Harreveld, The Netherlands
  3886.         Peter Billing in Yinnar, Australia
  3887.         Nick Kurn in Addlestone, England
  3888.         Alain Bourgery in Charleville-Mézières, France
  3889.  
  3890.   German translation: Ralf Schulz
  3891.   Dutch translation: Freddy Ariës
  3892.   French translation: Alain Bourgery
  3893.  
  3894.  
  3895. ----------------------------------------------------------------------------------
  3896. ErrorMessages
  3897. ----------------------------------------------------------------------------------
  3898.          Explanation of Error Message Returned by Scion Genealogist
  3899.          ==========================================================
  3900.  
  3901. "Couldn't allocate the about gadgets"
  3902.     Programme was unable to allocate the gadgets in the window used
  3903.     by Scion Genealogist to display the "about" requester.
  3904.     Probably due to memory running short.
  3905.  
  3906. "Couldn't allocate the ancestor gadgets"
  3907.     Programme was unable to allocate the gadgets in the window used
  3908.     by Scion Genealogist to display the on-screen ancestor chart.
  3909.     Probably due to memory running short.
  3910.  
  3911. "Couldn't allocate the family gadgets"
  3912.     Programme was unable to allocate the gadgets in the window used
  3913.     by Scion Genealogist to display family details. Probably due to
  3914.     memory running short. Fatal error.
  3915.  
  3916. "Couldn't allocate the list Gadgets"
  3917.     Programme was unable to allocate the gadgets in the list window
  3918.     used by Scion Genealogist to display people, family and marriage
  3919.     lists. Probably due to memory running short.
  3920.  
  3921. "Couldn't allocate the number gadgets"
  3922.     Programme was unable to allocate the gadgets in the window used
  3923.     by Scion Genealogist to get IRN or FGRN input from the user.
  3924.     Probably due to memory running short.
  3925.  
  3926. "Couldn't allocate the person gadgets"
  3927.     Programme was unable to allocate the gadgets in the window used
  3928.     by Scion Genealogist to display personal details. Probably due to
  3929.     memory running short. Fatal error.
  3930.  
  3931. "Couldn't allocate the pick gadgets"
  3932.     Programme was unable to allocate the gadgets in the window used
  3933.     by Scion Genealogist to display last name pick list. Probably due
  3934.     to memory running short.
  3935.  
  3936. "Couldn't allocate the range gadgets"
  3937.     Programme was unable to allocate the gadgets in the range window
  3938.     used by Scion Genealogist to get range information from the user.
  3939.     Probably due to memory running short.
  3940.  
  3941. "Couldn't allocate the search gadgets"
  3942.     Programme was unable to allocate the gadgets in the search window
  3943.     used by Scion Genealogist to get search information from the user.
  3944.     Probably due to memory running short.
  3945.  
  3946. "Couldn't allocate the SetBehave gadgets"
  3947.     Programme was unable to allocate the gadgets in the window
  3948.     used by Scion Genealogist to get user-definable behaviour from
  3949.     the user. Probably due to memory running short.
  3950.  
  3951. "Couldn't allocate the SetUser gadgets"
  3952.     Programme was unable to allocate the gadgets in the window
  3953.     used by Scion Genealogist to get user-definable information from
  3954.     the user. Probably due to memory running short.
  3955.  
  3956. "Couldn't attach family menus"
  3957.     Programme was unable to attach the programme menus to the window
  3958.     used by Scion Genealogist to display family details. Probably
  3959.     due to memory running short. Fatal error.
  3960.  
  3961. "Couldn't attach person menus"
  3962.     Programme was unable to attach the programme menus to the window
  3963.     used by Scion Genealogist to display personal details. Probably
  3964.     due to memory running short. Fatal error.
  3965.  
  3966. "Couldn't initialize the about gadgets"
  3967.     Programme was unable to initialize the gadgets in the window used
  3968.     by Scion Genealogist to display the "about" requester.
  3969.     Probably due to memory running short.
  3970.  
  3971. "Couldn't initialize the ancestor gadgets"
  3972.     Programme was unable to initialize the gadgets in the window used
  3973.     by Scion Genealogist to display the on-screen ancestor chart.
  3974.     Probably due to memory running short.
  3975.  
  3976. "Couldn't initialize the family gadgets"
  3977.     Programme was unable to initialize the gadgets in the window used
  3978.     by Scion Genealogist to display family details. Probably due to
  3979.     memory running short. Fatal error.
  3980.  
  3981. "Couldn't initialize the list Gadgets"
  3982.     Programme was unable to initialize the gadgets in the list window
  3983.     used by Scion Genealogist to display people, family and marriage
  3984.     lists. Probably due to memory running short.
  3985.  
  3986. "Couldn't initialize the number gadgets"
  3987.     Programme was unable to initialize the gadgets in the window used
  3988.     by Scion Genealogist to get IRN or FGRN input from the user.
  3989.     Probably due to memory running short.
  3990.  
  3991. "Couldn't initialize the person gadgets"
  3992.     Programme was unable to initialize the gadgets in the window used
  3993.     by Scion Genealogist to display personal details. Probably due to
  3994.     memory running short. Fatal error.
  3995.  
  3996. "Couldn't initialize the pick gadgets"
  3997.     Programme was unable to initialize the gadgets in the window used
  3998.     by Scion Genealogist to display the last name pick list. Probably
  3999.     due to memory running short.
  4000.  
  4001. "Couldn't initialize the range gadgets"
  4002.     Programme was unable to initialize the gadgets in the range window
  4003.     used by Scion Genealogist to get range information from the user.
  4004.     Probably due to memory running short.
  4005.  
  4006. "Couldn't initialize the search gadgets"
  4007.     Programme was unable to initialize the gadgets in the search window
  4008.     used by Scion Genealogist to get search information from the user.
  4009.     Probably due to memory running short.
  4010.  
  4011. "Couldn't initialize the SetBehave gadgets"
  4012.     Programme was unable to initialize the gadgets in the window
  4013.     used by Scion Genealogist to get user-definable behaviour from
  4014.     the user. Probably due to memory running short.
  4015.  
  4016. "Couldn't initialize the SetUser gadgets"
  4017.     Programme was unable to initialize the gadgets in the window
  4018.     used by Scion Genealogist to get user-definable information from
  4019.     the user. Probably due to memory running short.
  4020.  
  4021. "Database was saved using a more modern version of the programme. You will
  4022.  need to update Scion!"
  4023.     The file that you tried to load was created using a more modern
  4024.     version of Scion Genealogist than you are currently using. Change
  4025.     to the correct (or later) version of the programme.
  4026.  
  4027. "Editor not defined"
  4028.     You tried to edit a file without first defining the editor to use.
  4029.     Define the editor by selecting "Choose Editor" from the
  4030.     "Prefs" menu.
  4031.  
  4032. "Editor or viewer filename too long"
  4033.     The name of the editor or viewer that you have chosen is too long.
  4034.  
  4035. "Error number <number> detected"
  4036.     This error message will be displayed if AmigaDOS detects an error.
  4037.     Refer to your AmigaDOS manual for an explanation of the error
  4038.     number.
  4039.  
  4040. "Error saving file"
  4041.     An error occurred while you were attempting to save a database
  4042.     file. Refer to your AmigaDOS manual for more information.
  4043.  
  4044. "File is write protected"
  4045.     The database file you tried to save has its 'protected from
  4046.     writing' flag set. Use the AmigaDOS 'protect' command to change
  4047.     this protection bit. Refer to your AmigaDOS manual for more
  4048.     information.
  4049.  
  4050. "Incomplete file has been deleted"
  4051.     The destination disk became full when you saved a database and the
  4052.     resulting incomplete file has been deleted. Try saving your
  4053.     database to a different disk with more available space.
  4054.  
  4055. "Invalid range specified"
  4056.     The range that you specified in a 'print range' requester is
  4057.     invalid. The end of the range must be greater than the start of
  4058.     the range, the start range must be less than or equal to the total
  4059.     number of people or families in the database, and neither the start
  4060.     range nor end range may be zero or negative.
  4061.  
  4062. "Maximum number of children reached"
  4063.     The current family group already has 40 children, the maximum
  4064.     number permitted for any one family group.
  4065.  
  4066. "Maximum number reached"
  4067.     Either: (1) You have reached the maximum number of people you
  4068.                 can have in a database (999), or,
  4069.             (2) you have reached the maximum number of families you
  4070.             can have in a database (999).
  4071.  
  4072. "Maximum number would be exceeded"
  4073.     When you attempted to 'bulk add' people to the database using
  4074.     the 'Add People' option under the 'Extras' menu, the number you
  4075.     tried to add would have exceeded the limit of the programme (999).
  4076.  
  4077. "No database name specified"
  4078.     You did not specify a database name when you tried to save that
  4079.     database. Either select an existing database from the "Save As..."
  4080.     file requester, or type in a new name for the database in the file
  4081.     requester.
  4082.  
  4083. "No database name specified. Save using "Save As" option."
  4084.     When you tried to save a database using the "Save" option, there
  4085.     was either no database name already defined, or else the name of
  4086.     the database was the default "Unnamed". Use the "Save As..."
  4087.     option to save the database with a name.
  4088.  
  4089. "No family notes file specified"
  4090.     You have not specified a note file to edit. Enter an appropriate
  4091.     name in the file requester displayed when you click on the "Edit
  4092.     Notes" gadget in the Family Details Window.
  4093.  
  4094. "No family picture file specified"
  4095.     You have not specified a picture file to view. Enter an
  4096.     appropriate name in the file requester displayed when you click on
  4097.     the "View Picture" gadget in the Family Details Window.
  4098.  
  4099. "No personal notes file specified"
  4100.     You have not specified a note file to edit. Enter an appropriate
  4101.     name in the file requester displayed when you click on the "Edit
  4102.     Notes" gadget in the Personal Details Window.
  4103.  
  4104. "No personal picture file specified"
  4105.     You have not specified a picture file to view. Enter an
  4106.     appropriate name in the file requester displayed when you click on
  4107.     the "View Picture" gadget in the Personal Details Window.
  4108.  
  4109. "Not a valid Scion database"
  4110.     The file that you tried to load was not a valid Scion database.
  4111.     Make sure that you selected the correct file.
  4112.  
  4113. "On-line help is not currently available"
  4114.     'amigaguide.library' could not be opened when the programme was
  4115.     started, and therefore on-line help is not available.
  4116.  
  4117. "On-line help will not be available"
  4118.     The 'amigaguide.library' could not be opened, and hence on-line
  4119.     help will not be available. Make sure that you have installed the
  4120.     supplied 'amigaguide.library'.
  4121.  
  4122. "Out of memory"
  4123.     You ran out of memory when trying to 'bulk add' people to the
  4124.     database using the 'Add People' option under the 'Extras' menu.
  4125.  
  4126. "Printer is not online"
  4127.     Either: (1) The printer is not on-line, or,
  4128.             (2) the printer is not turned on, or,
  4129.         (3) the printer cable is not connected.
  4130.  
  4131. "Printer is out of paper"
  4132.     The printer is out of paper.
  4133.  
  4134. "The person selected already has parents defined"
  4135.     The child you tried to add to a family group (using the "Add Child"
  4136.     gadget) already has it's parents defined by being a member of
  4137.     another family group.
  4138.  
  4139. "The person selected has been deleted from the database"
  4140.     You have tried to select the record corresponding to a person
  4141.     who has subsequently been deleted from the database.
  4142.  
  4143. "The selected child is a parent of the Principal"
  4144.     The child you tried to add to a family group (using the "Add Child"
  4145.     gadget) is a parent of the Principal of the current family group.
  4146.  
  4147. "The selected child is a parent of the Spouse"
  4148.     The child you tried to add to a family group (using the "Add Child"
  4149.     gadget) is a parent of the Spouse of the current family group.
  4150.  
  4151. "The selected spouse has already been married for the maximum number of
  4152.  times"
  4153.     The spouse that you have selected for a family group (using "Add
  4154.     Spouse") has already been married 10 times, the maximum number
  4155.     of marriages permitted for any one individual.
  4156.  
  4157. "The selected spouse is a child of one of the children of the family"
  4158.     The spouse that you have selected for a family group (using "Add
  4159.     Spouse") is actually a child of one of the children of that family
  4160.     group.
  4161.  
  4162. "The selected spouse is already one of the children of the family"
  4163.     The spouse that you have selected for a family group (using "Add
  4164.     Spouse") is actually one of the children of that family group.
  4165.  
  4166. "Unable to gain access to the printer. Maybe it is in use?"
  4167.     When trying to print a report, the programme was unable to gain
  4168.     access to the printer. Maybe another programme is using the printer
  4169.     or has not released it properly after use.
  4170.  
  4171. "Unable to get VisualInfo from the screen"
  4172.     Programme was unable to obtain information about the custom screen
  4173.     used by Scion Genealogist. People, family and marriage lists will
  4174.     not be available. Possibly due to memory running short. If this
  4175.     error occurs during startup, it is a fatal error.
  4176.  
  4177. "Unable to open 'library' version 'version number' (or greater)"
  4178.     The programme was unable to open the AmigaDOS library 'library'
  4179.     with a version number of 'version number' (or later).
  4180.     If 'rexxsyslib.library' could not be opened, ARexx functions will
  4181.     not be available. All other library open failures are 'fatal'. The
  4182.     required libraries are either not present, or the library version
  4183.     is not modern enough.
  4184.  
  4185. "Unable to open about window"
  4186.     Programme was unable to open window used by Scion Genealogist to
  4187.     display the "about" requester. Probably due to memory running
  4188.     short.
  4189.  
  4190. "Unable to open ancestor window"
  4191.     Programme was unable to open window used by Scion Genealogist to
  4192.     display the on-screen ancestor chart. Probably due to memory
  4193.     running short.
  4194.  
  4195. "Unable to open family window"
  4196.     Programme was unable to open the window to be used by Scion
  4197.     Genealogist to display family details. Probably due to memory
  4198.     running short. Fatal error.
  4199.  
  4200. "Unable to open help file"
  4201.     There was a problem detected when 'amigaguide' help system tried
  4202.     to open the Scion.guide help file.
  4203.  
  4204. "Unable to open list window"
  4205.     Programme was unable to open the list window to be used by Scion
  4206.     Genealogist to display people, family and marriage lists. Probably
  4207.     due to memory running short.
  4208.  
  4209. "Unable to open number window"
  4210.     Programme was unable to open the window to be used by Scion
  4211.     Genealogist to get IRN or FGRN input from the user. Probably
  4212.     due to memory running short.
  4213.  
  4214. "Unable to open personal window"
  4215.     Programme was unable to open the window to be used by Scion
  4216.     Genealogist to display personal details. Probably due to memory
  4217.     running short. Fatal error.
  4218.  
  4219. "Unable to open pick window"
  4220.     Programme was unable to open the window to be used by Scion
  4221.     Genealogist to display the last name pick list. Probably due to
  4222.     memory running short.
  4223.  
  4224. "Unable to open range window"
  4225.     Programme was unable to open the range window to be used by Scion
  4226.     Genealogist to get range information from the user. Probably
  4227.     due to memory running short.
  4228.  
  4229. "Unable to open screen"
  4230.     The programme could not open its required custom screen. Probably
  4231.     due to a shortage of memory. Fatal error.
  4232.  
  4233. "Unable to open search window"
  4234.     Programme was unable to open the search window to be used by Scion
  4235.     Genealogist to get search information from the user. Probably
  4236.     due to memory running short.
  4237.  
  4238. "Unable to open SetBehave window"
  4239.     Programme was unable to open the window to be used by Scion
  4240.     Genealogist to get user-definable behaviour from the user.
  4241.     Probably due to memory running short.
  4242.  
  4243. "Unable to open SetUser window"
  4244.     Programme was unable to open the window to be used by Scion
  4245.     Genealogist to get user-definable information from the user.
  4246.     Probably due to memory running short.
  4247.  
  4248. "Unable to open Topaz font"
  4249.     The programme could not open the system font 'topaz 8'. Fatal
  4250.     error (this font should always be available!).
  4251.  
  4252. "Unique ARexx port could not be created. ARexx functions will not be
  4253.  available."
  4254.     The programme could not create a unique ARexx port name. Only 10
  4255.     possible unique names are supported.
  4256.  
  4257. "Viewer not defined"
  4258.     You tried to view a picture file without first defining the viewer
  4259.     to use. Define the viewer by selecting "Choose Viewer" from the
  4260.     "Prefs" menu.
  4261.  
  4262. "WARNING: Memory is almost exhausted! Recommend saving your database NOW!"
  4263.     Scion Genealogist has detected that memory is running low. Save
  4264.     your database AT ONCE as functions (including the ability to save
  4265.     the database) may cease to be available if you continue adding
  4266.     people and/or families to the database. If you have other
  4267.     applications running, close them down to free up some more memory.
  4268.  
  4269. "You are trying to make one of the parents their own child"
  4270.     The child you tried to add to a family group (using the "Add Child"
  4271.     gadget) is already defined as either the Principal or Spouse
  4272.     of the current family group.
  4273.  
  4274. "You are trying to marry the Principal of this family to themselves!"
  4275.     The spouse that you have selected for a family group (using "Add
  4276.     Spouse") has already been set as the principal of that family
  4277.     group.
  4278.  
  4279.