1 Introduction 1.1 What is GenTree? The Genealogical/Family Tree Program for the Amiga Series of computers is a multi-media program for creating, organizing, and maintaining family trees. Using GenTree, you can create family trees containing unlimited number of members. It orga- nizes your data, binding text with graphics, sounds, and annotated text. You can create and print pedigree charts, descendant charts, and family groups. 1.2 Copyright Notice And Disclaimer This manual and the software described in it are Copyright © 1994 Thomas G. Grubb. All rights reserved. The software is delivered "as is", you rely on the program and results solely at your own risk. The software is shareware. If you like it and use it, please send $20 to: Thomas G. Grubb 15439 Empress Way Bowie, Md. 20716 USA When you register the software, you will be mailed (either electronically or tradi- tionally) the program GEDCOMConverter. This is a utility which converts GenTree da- tabases to the Genealogical Data Communications (GEDCOM) Standard files. The software must be distributed with this notice and all files intact. You are free to copy and distribute this archive. No fees may be charged beyond a nominal copying fee (less than $6). 1.3 Major Feature List GenTree is a very powerful genealogical program. Some features are: · Provides unlimited number of members (limited by ram for the central database file) distributed over an unlimited number of storage media. · Provides unlimited number of pictures (displayable on the computer) that may be associated with members. You can compile a family album for your family. Pic- tures, brushes and anim brushes are all directly supported by GenTree. With the correct player, you can show 24-bit IFF and full screen animations. · Provides unlimited number of sounds (playable on the computer) that may be associated with members. Listen to digitized samples of your relative's voices or even their favorite songs. · Provides unlimited number of annotated notes about member records. · Provides unlimited number of source references about member records. · Provides member records that may have an unlimited number of spouses, chil- dren, occupations, and residences. · Provides compatibility with other genealogical programs by converting GenTree databases from and toGEDCOM Files (this feature is provided through the utility you receive when you register). · Runs under AmigaDOS 1.3, 2.x, and 3.x. · Runs on the Workbench (in any resolution) to save memory. · Supports AppEvents under AmigaDOS 2.0+. · Uses Preferences to allow you to configure GenTree for your use including Bit- mapped and Outline fonts. Also, you may specify your own favorite picture viewer in order to take advantage of picture formats like JPEG or AGA. · Saves Preferences with each database allowing different databases to have dif- ferent preferences. · Creates Pedigree Charts as many generations deep as desired (or practical). · Creates Descendant Charts as many generations deep as desired (or practical). · Creates Family Groups. · Prints your entire, or a subset, GenTree database in many different ways: indi- vidual names, birth and death information, family information, supplemental infor- mation, lists of pictures or sounds, notes, and sources. · Saves changes to the database in memory so that your modifications are not fi- nal until you save them. 1.4 System Requirements GenTree requires at least 2 Meg of memory to run. The program works well un- der AmigaDOS 1.3, 2.x, or 3.x. In addition, GenTree supports the 2.0 App Event. The program may be used from a floppy or a hard disk. Note: It is strongly recommended that you use a hard disk and an accelerator. While GenTree will work using floppies and the 86000 CPU, response time is greatly increased (and user frustration decreased) with HD and a 68020+. 1.5 Installation GenTree is distributed as a LZH archive. Simply extracting the archive will cre- ate the proper directories and files needed by the program. The directories; Pictures, Sounds, Notes, Sources, and Persons; may be placed anywhere. In fact, each direc- tory could be a separate disk. 1.6 Document Organization This document is divided into several sections and appendices: · Introduction - The section you are reading now. It describes GenTree and its features in a basic way. Cost, system requirements, and installation are included as well. · GenTree Database Organization - Contained in this chapter are structures and variables used by the program. They are provided to help give a conceptual un- derstanding of GenTree's workings. · Tutorial - This section guides you in making a family tree. It provides a quick start to using GenTree. You learn how to start GenTree, create a family tree, add pictures, sounds, notes and sources to your family tree, save your work, dis- play pedigree and descendant charts, and print your family tree. · Reference - This section provides a reference to all the functions of the GenTree program. Each screen, its menus, buttons, and purpose are detailed. · Appendices - The appendices discuss date formats, GenTree Genealogical Data Communications (GEDCOM) standard support, future plans, history, and error messages. 2 GenTree Database Organization GenTree divides data into 3 basic components. First, there is the GenTree data- base file. This file lists all members (and their associated member records) in the cur- rent database, the media databases to use with the member records, and other general information. Second, there are member records themselves which contain information about 1 member each: name, sex, birth date, spouses, children, residences, etc. Fi- nally, there are Media databases which track all multimedia (pictures, sounds, text) sup- port files used by the current GenTree database. 2.1 GenTree Database The GenTree database is the main "product" GenTree produces. It tracks every member in the database and where their member records are located. It also points to the media databases used by the member records. The GenTree database is the limit to the number of member records you may create. The entire database file must be able to fit into memory. 2.2 Media Databases There are four media DBs produced by GenTree: pictures, sounds, notes, and sources. Each DB tracks all the files of its type for the current database. They contain a logical and a physical name for each file. The physical name points to the exact loca- tion on disk of the media file. The logical name is what is used to refer to the file within your program. For example, you could have a picture file named TGrubb.Pic on your DH0: hard drive. The physical filename for the file would be "DH0:TGrubb.Pic." However, in the program you refer to it with a logical name (255 characters Max) like "Thomas G. Grubb, Year 1993, Age 26, at the annual family picnic." The Source Media database is slightly different than the others. Like the other media types, you have a logical name and possibly a physical file. But, sources also contain many other fields to completely define the source reference: classification, origi- nator information, pubilication information, etc. The file formats supported by GenTree are listed in Appendix C. 2.3 Member Records Each member in your family tree will have a member record. A member record contains personal information about that member: name, sex, birth date, family, religion, ... essentially all the information you enter in the Data Entry Windows (the Personal, Family, and Supplemental windows defined in the reference section). Two important pieces of member information are a member ID and personal media databases. Note: Member records are tracked in the GenTree Database for the family. As such, member records could be saved anywhere i.e. you are not limited to 1 floppy or even 1 hard drive for all your member records. New member records are saved in your current default persons directory. The default persons directory is changed in the preferences screen. It only affects new records. 2.3.1 IDs Member IDs uniquely identify a member of your family tree. Conceivably, you could have two members with the same surname, givenname, and birth date so these cannot be used as unique identifiers. The member ID is used by GenTree to track that member. Ordinarily, you won't have to worry about member IDs. GenTree assigns them automatically when you create a member. Even when you need to specify a member from the database, you may use requesters that list relevant members to select. 2.3.2 Personal Media Databases Each member has his/her own personal media databases. The personal media databases are used to associate media files (pictures, sounds, notes, and sources) to the given member. In actuality, these databases point to media files tracked in a Media DB. This is a powerful feature since you can refer to the same file in the same manner from several different member records. Not only does it help consistency between members, it saves disk space. For example, you could have a picture of your family with a logical name "Family Reunion, August 7th 1992". Each member of the family could then point to this file in the Picture Media DB using their personal picture DB. 3 Tutorial 3.1 Starting GenTree You can start GenTree from the Workbench or the CLI. Workbench: Open the drawer in which GenTree is installed. Double-click on the Gen- Tree icon. This procedure loads GenTree with a new database. Alternatively, if you have a database already created, double-click on your project icon and GenTree will load with your family tree already loaded. CLI: Change directories until you are in the GenTree directory. Type "GenTree" to load the program. Type "GenTree Path&Filename" to load a previously created database. 3.2 Creating Your Family Tree To create a new family tree, select the New menu item (see figure) from the main window's project menu. If you have just started GenTree you can skip this step. For the tutorial, we are go- ing to create the following family: Godsey, Margery Ann Born: 28-Jan-1932 Died: Father: Godsey, Keith Foster Born: 6-Jul-1897 Died: 16-May-1980 Mother: Arnold, Leah Placida Born: 23-Apr-1892 Died: 23-Mar-1972 Spouse(s): Grubb, Samuel Parry, Jr. Start Date: About 1957 End Date: About 1970 Wedding Location: Falls Church, Virginia Children: Grubb, Samuel Parry, III Grubb, Thomas Gerard Grubb, Alexandria Kathleen Born: 3-Jan-1988 Died: Father: Grubb, Samuel Parry, III Mother: Meeks, Julie Lynette Grubb, Elizabeth Michelle Born: 3-Sep-1990 Died: Father: Grubb, Samuel Parry, III Mother: Meeks, Julie Lynette Grubb, Samuel Parry, III Born: 3-Jul-1959 Died: Father: Grubb, Samuel Parry, Jr. Mother: Godsey, Margery Ann Spouse(s): Meeks, Julie Lynette Start Date: 27-Aug-1983 End Date: Wedding Location: Gatesville, Texas Children: Grubb, Alexandria Kathleen Grubb, Elizabeth Michelle Grubb, Samuel Parry, Jr. Born: About 23-Oct-1931 Died: Father: Grubb, Samuel Parry Mother: Rhodes, Helen Spouse(s): Godsey, Margery Ann Start Date: About 1957 End Date: About 1970 Wedding Location: Falls Church, Virginia Children: Grubb, Samuel Parry, III Grubb, Thomas Gerard Grubb, Thomas Gerard Born: 7-Aug-1966 Died: Father: Grubb, Samuel Parry, Jr. Mother: Godsey, Margery Ann Meeks, Julie Lynette Born: 15-Feb-1962 Died: Spouse(s): Grubb, Samuel Parry, III Start Date: 27-Aug-1983 End Date: Wedding Location: Gatesville, Texas Children: Grubb, Alexandria Kathleen Grubb, Elizabeth Michelle To enter members into family trees, select the Update Person menu item (see the figure above) from the database menu (main screen). This will bring up the per- sonal information screen. The personal information screen allows you to enter a member's name, sex, birth date & place, and death date & place. On entering the screen, the cursor will be in the Given name field. Type the following ( is a carriage return): Margery Ann Godsey f 28 Jan 1932 (If you typed everything correctly, your screen should look like thefigure to the below.) OK, let's enter Margery's family information. Click the button labeled Family Info on the right of the screen. The Family Info screen allows you to connect the members of your family tree through the various relation- ships: spouses, children, father, and mother. A member may have as many spouses or children as needed. You can specify relationships with other members already de- fined in the database. Alternatively, GenTree allows you to enter names from this screen. The program will auto- matically create new records for you, and each member will have the correct links en- tered. It saves time to let GenTree do the work, so for our tutorial enter the following information for the spouse: Samuel Parry, Jr. Grubb Falls Church, Virginia about 1957 about 1970 Your cursor should now be in the given name field for the children. If it isn't, se- lect that field with your mouse. Now we want to enter the children. Enter "Samuel Parry, III". After you hit the carriage return, GenTree automatically filled in the sur- name for the child. GenTree automatically enters the surname of the current record if the member is male or the surname of the current spouse. Since this is what we want, let's skip the field and press re- turn. Enter "M" in the gender field. Enter the birth date (July 3 1959). The screen should now look like the figure at the left. Finish the family information by typing in Margery's father and mother (Keith Foster, Godsey, July 8 1897, May 16 1980, Leah Placida, Arnold, April 23 1892, and March 23 1972). At this point, GenTree has not created any new records. You can always tell when a record is in the data- base because it has been assigned an ID. To create the records, you just have to per- form any action which requires GenTree to clear the screen. For our purposes, we will select Verify from Record menu. Usually, Verify checks your cur- rent member record for correct information. However, since we added a spouse, you will instead see a requester asking if you want this spouse to be the husband of Margery's children (see fig- ure). Select Yes with the mouse. Next, GenTree shows another requester asking you if you want the parents you added to be mar- ried. This serves our purposes nicely so select Yes again. Finally, after a few moments GenTree will display an information requester stating there are no errors (If you do get errors, check the dates and other data you entered.) We forgot to add one of Margery's child (Thomas Gerard). We can add children by selecting the button labeled Children (1 of 1) which would clear the child fields for a new child. This button is a radio button (as is the Spouse (1 of 1) button) which allows us to cycle through all the current children and create new children. However, at this point, if we added a child this way, only the mother link would be updated. The father link would not be made because GenTree only makes these links when records are cre- ated (if you added another spouse, the new child could have the new spouse as father added automatically). Instead, what we are going to do is duplicate the child Samuel Parry, III's record. Duplicating a record copies ALL information (names, dates, supple- mental information, and family links) except for spouse information. First, go to the child record by select Child... from the record menu. Duplicate is only available as an option from the Record menu of the Personal info screen. Therefore, select the Personal Info button to go to that screen. Select Duplicate from the record menu. The only changes you will see is that the ID will have changed. Also, the window title will change to reflect the member record added to the family tree. Change the given name to "Thomas Ger- ard" and the birth date to "August 7 1966" (Right-Amiga-X will clear the current field). That's it. If you want, you can go to the family information screen to verify the links. Our next step will be to add the children of Samuel Parry, III: Alexandria and Elizabeth. First, let's enter Alexandria's information. From the Personal Information screen, select New under the Record menu. You will see a blank record with a new ID (in this case ID 7). Enter "Alexandria Kathleen", "Grubb", "Female" (or just "f"), and "January 3, 1988". You'll notice that every time you enter a date, GenTree formats the date into a standard type: DD-Mon-YYYY. This tutorial has had you enter the date in many different formats to show the power of GenTree's date rec- ognition. Press the Family Information button to go to Alexandria's family. So far, it's blank. Click on the button labelled Father. This button will bring up a list requester (see figure) containing all of the members in the database that could be Alexandria's father (based on sex and age). Double-click on Sam- uel Parry, III to select him as the father. GenTree will automati- cally fill in the ID, name, and date's for the father fields. The list requesters that GenTree provides are very handy if you forget the ID of a family member. If you had remembered Samuel Parry, III's ID number you could also have entered the ID in the father ID. After hitting return, GenTree would have filled the father fields from the family member with that ID. If the ID didn't exist, no fields would be filled. GenTree would assume you are entering a new member and are specifying what you would like the ID to be. Member list requesters are available for spouses, children, father, and mother. Now, let's enter the mother's information (Julie Meeks). She doesn't exist yet so we can't use the list requester. Type in "Julie Lynette", "Meeks", "Feb 15, 1962". Select the Personal Info button. A requester will appear saying the father's information has changed (we added a child); do we want to change his record? Select Yes. Then, a requester will appear asking if you want Alexandria's parents to be mar- ried. Again select Yes. When the Personal Information window appear, duplicate the record. Change the given name to "Elizabeth Michelle" and the birth date to "September 3, 1990". The last bit of information we need to enter is the marriage information for Julie Meeks and Samuel Parry Grubb, III. You could use the Father or Mother menu item from the record menu, but for the tutorial we are going to use GenTree's search abilities. Select the Search menu item from the record menu or the Search button (the magnifying glass at the bottom of the screen). After a few moments the Search requester will appear (see figure). The Search requester allows you to search for members in the database for which all data that you enter matches. Alternatively, you can depress New and the requester will return you to the Person Information screen with a new record to enter. Let's look for Samuel Parry Grubb, III's record. Enter "Parry" in the name field (case does not matter) and "After 1950" in the birth date field. After pressing the Search button, GenTree will search your database for all records that have Parry in their names and who were born January 1st, 1951 or later (members with blank birth dates would also be returned). GenTree displays the Per- sonal Information screen. Using the left and right arrows at the bottom of the screen (or the Next and Previous menu items) would scroll you through all the records satisfying the query. In this case, only 1 record matches the query so the arrows are disabled. Go to the Family Information screen. As you can see, GenTree has updated the family member's information (added Julie as a spouse and Elizabeth as a child). Change the marriage information: "Gatesville, Texas" for the location and "August 27, 1983" for the wedding date. Select the Verify menu item. GenTree will inform that the marriage information has changed, and, asks if you want the spouse's marriage information changed (see figure). Select Change. If you didn't mean to change anything you could have selected Cancel. Selecting No will leave the spouse's information untouched (for instance, if the spouse had a different reason for the end of the marriage). After a moment, verify will come back with no errors. OK, we have finished entering the member information. In the next section, you will learn how to attach media (pictures, sounds, notes, or sources) to your family tree members. 3.3 Adding Pictures, Sounds, Notes, And Sources GenTree allows you to connect pictures, sounds, notes, and sources (references) to your family members. The four buttons at the bottom left of the Per- sonal, Family, or Supplemental Info screens (see figure) are for the different media (from left to right): pictures, sounds, notes, and sources. Clicking any of the Media icons will display the Personal Media window. This window is used to choose the pictures you want from the current family tree's media databases. Assuming you are still in Elizabeth's Personal Info screen, click the Picture Icon. The Personal Media window (see figure) allows you to attach media (in this case pictures) to the current member. The list at the left of the window displays the logical names for all pictures currently associated with the member. The buttons at right allow you to add to the list, remove from the list, and search the list. If we were adding notes or sources, there would be two other buttons: Edit loads the current selected name into the editor (the editor is chosen through preferences), and Editor calls the chosen editor without any files (to allow you to create new notes). The final button, Media DB, brings up the Media DB window. To perform an operation, we can click on the button or press the key underlined in the button's label. Note: The important thing to remember is that the Personal Media Window only allows you to work with Media ALREADY in the family tree. You must define me- dia using the Media Database Window. Another important thing about media records: you do not work with files from the system, rather logical names refer to the media in your family tree. Since we don't have any media stored in our family tree, click the Media DB but- ton (or press "M") so that we can add some. See the figure below. The Media DB win- dow looks a lot like the Personal Media window. From here, you essentially make a catalog of all the files you want to use with your family tree. You can add new media records, edit text media files, update entries in the database, search the database, and bring up the editor. Again, the Edit button and Editor button are only available with note and source media. There is no provision for deleting entries. You can effectively delete entries by using Update. Note that this is the Picture Media DB shown. The Per- sonal Media window always calls up the relevant Media DB win- dow. Let's create some entries. Select the New button (or press "N"). Immediately, a requester will appear asking you to select a physical filename. Select any file. Don't worry about whether it's an actual picture file; GenTree doesn't care until it actually has to display the files. (This feature allows you to add pictures in formats GenTree cannot show and use your own picture viewer through the preferences). Select the file and press OK. Now a logical name requester appears. A logical name is a 255 character string that refers to this file. You will use this logical name throughout the program in- stead of the physical filename. It provides you with a level of data transparency. If it's easier, just think of it as a unique comment about the file. Put anything you like in the requester, say "Elizabeth M. Grubb, Age 2, at Damascus House (12/92)" and click OK. Select a few more pictures if you like. Double-clicking on items in the list request will display the picture (or play the sound, or view the note,...). Double-clicking also works in the Personal Media window. When you are done, select OK to exit the window. Se- lecting Cancel will lose all your changes. Now we are back at the Personal Media window. All the changes in the Media DB window will not show up here. Using the Add button (or "A" key), add a picture (or two) for Elizabeth. Click OK to save your changes. The procedures described above work the same for picture, sound, and note me- dia. However, the source media records are treated a little differently. Let's return to the Media Database Window for sources. Select the Source icon (the footprint on a page icon at the bottom of the Personal Info window, Family Info window, or Supple- mental window). This action brings up the Personal Media Window. Select the Media DB button to enter the Media Database Window. Media database records for sources are considerably more detailed. This allows you to enter exact information describing the sources of information you have rather than a loose collection of text in some file. Sources are one of the most important pieces of genealogy. Without adequate documentation of your sources, other genealo- gists cannot trust your information. GenTree allows you to enter many fields for sources: classification, title, quality, fidelity, originator information to just name a few. Also, like other media types, you can point to a physical media file on disk. To illustrate the difference, select the New button (or press the "n" key) in the Media Database window. The Source Data Entry Window will appear (see Figure). It's a bewildering number of fields at first. Fortunately, GenTree helps you in this window as well by providing lists. Click to the left of many of the fields and available options will appear. Select Cancel and navigate your way back to the Personal Information Window. 3.4 Saving Your Family Tree GenTree keeps all work within memory. If you turned off your computer right now (or quit), all of your changes would be lost. Let's return to the main window. Select Return to Main from the Project Menu (if you are in the Personal Info Window, the close gadget will also return you to the main window). Select Save from the Project Menu of the main window. A file requester will ap- pear asking you where you want to place your family tree (and media databases). Enter a path and filename and select OK. After a few moments, your family tree will have been saved. GenTree saves your family tree and media databases in the directory you specified. Each member also has a file containing their unique information. These files are saved in the current Persons Directory (specified in preferences). As disk space fill up, you will want to change the Persons directory so that any new members will be saved somewhere else (GenTree will prompt you for a new name if the disk fills up or there is some other error saving a member file). It is a good idea to have one directory exclusively for the member files. Note that you also free up memory by saving your work to disk. Warning: Do NOT delete, rename, or move member files. GenTree stores their physical location in the family tree DB. If GenTree cannot find a file, it will display a file requester asking you where it is. However, this can get tedious if you have moved many member files. If you want to move your family tree, use Save As. Use Delete from the Main window's project menu to delete family trees. 3.5 Displaying Pedigree Charts, Descendant Charts, And Family Groups GenTree can create other documents to show relationships within your family. There are pedigree charts (Alexandria was born of Samuel and Julie who were born of...), descendant charts (Margery begat Tom and Sam who begat...), and family groups (husband, wife, and all their children). You can create these charts from the main window or the Info windows (Personal, Family, and Supplemental). Let's create a descendant chart for Margery Ann Godsey. From the main window, select Descendant Chart from the Display menu. The Descendant Chart requester will appear (see figure). The requester prompts you for the ID of the member you want to display. Enter "1" for the Member ID and Chart number. If you couldn't remember, you could have pressed the Member ID button. A list of the members in the family tree would have appeared to choose from (like with the father ID in the Family Info window). Click Display. After a few moments, Margery's descendant chart will ap- pear (see figure). The square box on the lower left allows you to view charts which won't all fit on one screen. If you click your mouse pointer on one of the names displayed on the chart, GenTree will create a new descen- dant chart with that member as the head. The left arrow button in the lower left corner loads the previous generation as the chart head. Gen- Tree would first prompt you for whether to load the father or the mother as the head. Under the Display menu, there are four check mark items: Pedigree, Family Group, Descendant, and Personal Information. Please notice that the Descendant menu item is currently checked. These menu items control what type of operation Gen- Tree performs when you click on a name. Either a pedigree, descendant, or family group chart would be displayed or the member's information would be loaded and you would be taken to the Personal Information Window. To change the chart, just select one of the menu items, the next time you click on a name the new operation will be per- formed. Finally, under the Display menu there is a menu item to print this chart to printer or file. After you are finished, click the Close window gadget or select Return from the menu to return to the main window. 3.6 Printing Your Family Tree The final thing you need to learn is how to print your family tree. In the previous section you learned how to print the pedigree charts et al. In this section, you will learn how to print everything. GenTree allows great control over which information you wish to print. You can just print member names (for a quick list of names and IDs in the data- base), dates, family relationships, supplemental information, pedigree and/or descen- dant charts, and media lists (and the notes or sources). The print option creates an ASCII stream of characters that may be sent to the printer or a file. GenTree cannot print pictures or sounds (printing a sound would be a trick). However, lists of the pictures and sounds each member has can be printed. Select Print... from the main window's project menu. The Print Requester will appear (see figure). From this re- quester, you can pick and choose what family tree informa- tion you wish to print. In addition, you can print all the mem- bers in your database, only updated member records, or only a subset of members. Clicking the Subset radio button will bring up the Search requester you used in the Info win- dows. From the print requester, you also choose the order of the members output. GenTree allows you to sort by name, id, birth date, birth country, death date, death country, or no sort at all. After you have configured everything to your liking, click OK. GenTree will now display a requester asking where you want the output to go. The default is to the PRT: device. However, you may type in a different destination. Clicking the Destination but- ton will display a file requester. When you have selected a destination, press return or click the Print button to print. Warning: Printing pedigree or descendant charts for an entire family tree can take a LONG time. Be sure this is really what you want to do before selecting these options. The options that require member records to be loaded (and slow print processing thereby) are Family Members, Supplemental Info, Charts, and Media. This concludes our tutorial. Have Fun and Good Luck creating your family tree! 4 Reference This section provides a reference of the different windows and their functions. 4.1 Main Window GenTree's main window (figure at right) provides access to the different windows used by GenTree to enter, print, and display your family tree. In addition, the main window is used to read family trees from and write family trees to disk. 4.1.1 Menus Project Menu - Create, open, join, save, delete, and print your family trees. Also, modify GenTree preferences. New Create a new family tree. Any old work will be lost so you will be prompted to see if you are sure. Open... Open a previously saved family tree saved in GenTree's database format. Any old work will be lost so you will be prompted to see if you are sure. Join... Navigates you to the Join Window to join the current database with another GenTree database saved on disk. This allows you to con- catenate your family tree with another's. WARNING: The Join operation, unlike all the edit operations, permanently changes the database on disk! Be absolutely sure you want to perform a join or work with a backup copy! Save Saves your updates to disk. If your family tree has never been cre- ated before a file requester will prompt you for the database name. Save As... Saves your current database (and all support files) to a new data- base you specify with a file requester. Delete... Deletes a GenTree database (and all support files) from disk. You cannot delete the current database in memory. You need to select new first and then delete. Print... Navigates to the Print window to print information from the current family tree. About... Displays the program version, contact information, free memory, and the number of members, pictures, sounds, notes, and sources defined in the current family tree. Info... Displays information about the current family tree: the name of the family tree, number of members, number of male and female mem- bers (note that the sum of the male and female members may be less than the number of members), number of pictures, number of sounds, number of notes, number of sources, and the new/unsaved members. Preferences... Navigates to the Preferences window where you can set GenTree preferences. Quit Exits the program. If you have any unsaved data, you will be prompted to see if you are sure. Database Menu - Navigates you to the windows to create, edit, and delete members, pictures, sounds, notes, and sources. Update Person... Navigates to the member entry windows. If your family tree is not empty, it brings up a requester to query on records to edit or you may select to create new records. Update Picture... Navigates to the Media Database window where you may up- date your picture media database. If you want to edit personal me- dia database entries, you must enter the member entry windows. Update Sound... Navigates to the Media Database window where you may up- date your sound media database. If you want to edit personal me- dia database entries, you must enter the member entry windows. Update Note... Navigates to the Media Database window where you may update your note media database. If you want to edit personal media data- base entries, you must enter the member entry windows. Notes are any text entries about a member or group of members. Update Source... Navigates to the Media Database window where you may up- date your source media database. If you want to edit personal me- dia database entries, you must enter the member entry windows. Sources are the references from where you obtained your family information. Display Menu - Display pedigree charts, descendant charts, and/or Family Group forms from this menu. Pedigree... Display the pedigree chart for a member of your family tree. A pedigree chart displays a member, his/her parents, grandparents, great-grandparents, etc. You are prompted for the member ID for the member to display. In addition, you may specify the chart ID. By default, GenTree builds a pedigree chart with a generation depth that will fit on the display window using the current display font (specified in preferences). You may override this default and state an explicit number of generations. Family Group... Display the Family Group for two member of your family tree. A family group is a male (usually the husband), a female (usually the wife), and all their children (and their wives). You are prompted for the member ID for the member and their spouse to display. In ad- dition, you may specify the chart ID. Descendant... Display the descendant chart for a member of your family tree. A descendant chart displays all the children of a member, the children's children, etc. You are prompted for the member ID for the member to display. In addition, you may specify the chart ID. By default, GenTree builds a descendant chart with a generation depth that will fit horizontally on the display window using the cur- rent display font (specified in preferences). You may override this default and state an explicit number of generations. The number of descendants per generation is not limited in any way. Use the pro- portional gadget in the display window to see parts offscreen. 4.1.2 AppEvent The main window also supports the Workbench 2.0+ App event. Drop a Gen- Tree family tree icon on the main window and the family will automatically be loaded. The old family tree is erased from memory. 4.2 Member Information And Data Entry Windows GenTree has three data entry windows: personal information window, family in- formation window, and supplemental information window. These windows are the heart of the GenTree program. From them, you create, edit, and delete members in your family tree. Each window contains many fields to enter specific types of information about that member. In addition, you may connect the current member to entries in your media databases. Each member has a unique ID associated with him/her. Normally, you do not need to enter values for the Personal ID. The only time you need to know entries is for entering family relationships. Please see section 2.3 for more details. When you enter the member entry windows, you will always start at the personal information window. If you selected New for your query, you are presented with a blank page. If you queried the family tree for a subgroup, you will see the first record of the sorted query. The window title displays the member you are editing and the place within the query list. 4.2.1 Buttons Next to many of the fields in the member entry win- dows are invisible buttons (which ones may be discovered through experimentation). These buttons display a list re- quester (see figure) from which you select the value you want in the field. These list requesters provide an easy way to enter information. You can use them to standardize your entries as well. The list requester displays text files (contained in the GenTree/Lists directory) which you may edit with any word processor. The list requester itself allows you to add, delete, and edit entries and search the list. Double-click on a entry to exit the requester and have that value placed in the corre- sponding field. The two buttons to the right of the member entry window navigate you to the other member entry windows. You cannot leave the personal information window until an ID, and name have been entered. The four buttons to the lower left of the member en- try windows (see figure) navigate you to the personal me- dia DB windows. From left to right, the buttons navigate you to the picture, sound, note, and source personal media databases. From these windows, you attach entries in your media databases to the current member. The three buttons on the lower right (see figure) dis- play the previous member of a query list, the next member of a query list, and search the database to create a query list respectively. 4.2.2 Menus Each of the three member entry windows have the same general menus and menu items. The personal and supplemental information windows additionally contain Copy and Paste menu items, and the personal information window has New, Duplicate, and Delete as well. Project Menu - Save and configure your family tree. Display database information, and return to the main window. Save Saves your updates to disk. If your family tree has never been cre- ated before a file requester will prompt you for the database name. Info... Displays information about the current family tree: the name of the family tree, number of members, number of male and female mem- bers (note that the sum of the male and female members may be less than the number of members), number of pictures, number of sounds, number of notes, number of sources, and the new/unsaved members. Preferences... Navigates to the Preferences window where you can set GenTree preferences. Return to Main. Navigates you back to the main window. The member record you are working on is verified and saved to the database. Record menu - Create and edit member records. Go to records within the query. Undo Undoes any changes you have made since you entered this win- dow. Undo does not restore changes you have made from before entering this window (say, if you had moved from the personal to the family information window). Revert Restores the member record from disk. All changes made to the member are deleted. Verify Verify the information you have entered about this member. New Save the current member and create a new member record. Copy Copy the current member to RAM. All of the member's information except for family links and personal media databases are copied. Copy and Paste are intended for copying records between family trees. Duplicate Duplicate the current member in the family tree. All information is copied. Only the member's ID changes. Paste Paste a member you previously copied into this family tree. Clear Clear specific fields of the current member: the entire record, per- sonal information, current spouse, current child, parents, residents, occupations, or supplemental information. What fields are available to be cleared is dependent on the window you are in. Delete Delete the current member from the family tree (and delete all fam- ily ties). This function only deletes the member from member. It is not permanent until you save the family tree. Parent Father Go to the record for the current member's father. Mother Go to the record for the current member's mother. Spouse... Go to the record for the spouse of the current member. If there is more than one spouse, you may choose the specific spouse from a list requester. Child... Go to the record for the child of the current member. If there is more than one child, you may choose the specific child from a list requester. Search For... Go to the search requester to perform a subquery on the family tree. First Display the first record in the query list. Previous Display the previous record in the query list. Next Display the next record in the query list. Last Display the last record in the query list. Display Menu - Display pedigree charts, descendant charts, and/or Family Group forms from this menu. By default, GenTree selects the current member ID. Pedigree... Display the pedigree chart for a member of your family tree. Family Group... Display the Family Group for two member of your family tree. Descendant... Display the descendant chart for a member of your family tree. 4.2.3 Windows From these windows you enter a member's information. The three data entry windows are the Personal Information window, the Family Information window, and the Supplemental Information window. Use the RETURN key or TAB key to jump from one field to the next. The SHIFT-TAB key jumps you to the previous field. Any information you need to add for which there is not a field, you should use the notes media database. 4.2.3.1 Personal Information Window The personal information window allows you to create, edit, and delete member records. You may enter the member's ID, name, gender, birth date and place, and death date and place. List requesters exists for the gender, and birth/death location, city, county, state, country, and cause of death. 4.2.3.2 Family Information Window The family information window is where you tie your family tree together. From here, you select (or create) your member's spouses, children, and parents. List re- questers exists for the spouse ID, child ID, father ID, and mother ID. The two radio buttons, Spouses and Children, cycle through the member's spouses and children respectively. To enter a new spouse or child, press the radio but- ton until the fields clear. Do NOT use the clear button; you will delete the family tie be- tween that member and that relation. 4.2.3.3 Supplemental Information Window The supplemental information window allows to add supplemental information about your member. You may enter the member's different jobs, residences, military service, religion, immigration information, baptismal and confirmation dates. List re- questers exist for the occupation type; residence city, state, and country; immigration location, and religion. The two radio buttons, Occupations and Residences, cycle through the member's jobs and homes respectively. To enter a new job or residence, press the ra- dio button until the fields clear. Do NOT use the clear button; you will delete the member's job or residence. 4.3 Media Databases GenTree allows you to link media (pictures, sounds, notes, and sources) to the members of your family tree. There are four global media databases (one for each me- dia type) that hold all media files you have defined in your family tree. Each member may also have four personal media databases which point to specific entries of the glo- bal media databases. Multiple members may use the same entries from the global media databases. Note that this makes it easy to make global changes. 4.3.1 Global Media Databases The media databases store picture, sound, note, and source references inside your family tree for coupling with your family members. Members may have their own unique references within the media databases, or several members may refer to the same picture (, sound, note, etc.). The media databases only store references, not the actual media. If you delete or move a media file from AmigaDOS, GenTree will not be able to find it. All media types work generally the same except for the source references. Sources store much more specific information than just the logical name and a file- name. When you create or update a source, the Source Data Entry window appears. See section 4.3.3 for more information on the Source Data Entry window and how to work with sources. The sizes of the media databases are limited only by memory. The more memory you have, the more references you may have. However, since GenTree only stores the physical filename, even in a small memory system you can store hundreds of references. You enter references into the media databases using the same media database window (see figure). From this window, you may add new entries, update current entries, edit note and source files using your default editor, and search the media database for a specific reference. In addition, double-clicking on an entry will have that file loaded and displayed (or played if you are using the sound media database window). To add picture, sound, or note entries to a media database: · Click on the New button. A file requester will appear. The default directory for the file requester is the default directories you specified for the media in prefer- ences. · Select a file using the file requester and click OK. You may select any type of file. GenTree doesn't restrict the type to allow for new file types GenTree may not understand, but which your default player or viewer may. · Enter a unique logical name for this file and press return. The logical name is what you will use to refer to this media file throughout the rest of the program. The logical name may be any characters you wish and has a maximum length of 255 characters. Note: The logical name must only be unique for the specific media database; dif- ferent media databases may have the same logical name. Also, the same physi- cal filename may be referenced multiple times within the same (or even different) database. (This is a waste of space, but you may find it necessary if you want tailored logical names for different members). To add source entries to the source media database: · Click on the New button. The Source Data Entry window will appear. · Enter information into the fields. You must enter a title (this is the same thing as the logical name for the other media types). · Select OK to exit the window. To update picture, sound, or note entries in a media database: · Find the entry you want to view/play using the scroll bar or searching for the logi- cal name. Highlight your selection. · Click on the update button. A file requester will appear already pointing to the file tracked by this reference. · If this is the correct file, just click OK. Otherwise, use the file requester to find the correct file and then click OK. The logical name will then be shown. · Again, you may edit the logical name or leave it as is. Click OK. To update source entries in the source media database: · Find the entry you want to view/play using the scroll bar or searching for the logi- cal name. Highlight your selection. · Click on the update button. The Source Data Entry window will appear with all the information you have previously filled in. · If this is the correct file, just click OK. Otherwise, change the fields to what you desire. · Click OK to save your changes. To delete entries in a media database: · You cannot directly delete entries in a media database. Instead, use the update procedure to overwrite the entry with a new entry. To view/play entries in a media database: · Find the entry you want to view/play using the scroll bar or searching for the logi- cal name. · Double-click on the entry. If you are in the picture media database window, GenTree will try to display the picture/brush/brushanim/... If you are in the sound media database, the program will try to play the sound. If you are in the note or source media database, it will try to display the ASCII text. GenTree uses the default viewers/players you define in preferences. If no viewer/player is defined, GenTree will use its internal routines. Please refer to Appendix C to see what file formats are supported. To edit text files (notes or sources): · Find the entry you want to view/play using the scroll bar or searching for the logi- cal name. Highlight the entry. · Click the Edit button. GenTree uses the default editor you define in preferences. If no editor is defined, GenTree will use MomentED, its internal ASCII editor. Please refer to the MomentED section for more details on this editor. The file- name for the note or source is automatically loaded into the editor. Sometimes nothing seems to happen. Usually, this means that the editor is not properly de- fined in preferences. Editors known to work are ED and Final Copy II. · Make your changes, save them and quit. To use the editor without loading any file (you might want to do this if there are no text files on disk to add), select the Editor button. To make a text file (for notes or source information not in the Source Data Entry win- dow): · Click the Editor button to load your editor. · Type in your note and save it. · Quit the editor. · Follow the procedures for adding an entry outlined earlier. 4.3.2 Personal Media Databases Your members' personal media databases point to specific media tracked within the media databases. Each member may have unlimited media connected to him/her. Again, you are only limited by memory or disk space. The personal media databases are stored in the member file. If you lose this file, you lose the links (the entries still ex- ist in the media databases though). You enter references into a member's record by using the per- sonal media window (see figure). This window is only reachable through the member entry windows. The member you are currently displaying on the member entry window is the personal media data- base that you are modifying. From the personal media window, you may add entries to your member record, delete entries from the mem- ber (but not the media database itself), edit notes and sources using your default editor, and search the personal media database for a spe- cific reference. In addition, double-clicking on an entry will display (or play) the entry. You may also go to the media database window in order to edit the media database. To add entries to a member's personal media database: · Click on the Add button. A list requester will appear containing all of the entries in the relevant media database. You cannot add entries until entries exist in the media database. If you need to add entries to the global media database, select the Media DB button. · Double-click on the entry you want. To remove entries from a member's personal database: · Find the entry you want to view/play using the scroll bar or searching for the logi- cal name. Highlight the entry. · Click the Remove button. To view/play entries: · Find the entry you want to view/play using the scroll bar or searching for the logi- cal name. · Double-click on the entry. To edit notes or sources: · Find the entry you want to view/play using the scroll bar or searching for the logi- cal name. Highlight the entry. · Click the Edit button. GenTree uses the default editor you define in preferences. · Make your changes, save them and quit. To use the editor without loading any file (you might want to do this if there are no text files on disk to add), select the Editor button. Any changes you make to the file will be reflected for all member personal databases that reference that file. 4.3.3 Source Data Entry Window This window (See figure) provides you with fields for completely entering source information. Sources represent the submitter's justification for the opinions asseted in the family tree. It provides the evidence obtained for the infor- mation and gives an idea of how much confidence other ge- nealogists can have in the data. The Title field is the same as the logical name for the other media types. It is the only required field. Other fields are optional and depend on the classification of the source. 4.3.3.1 Buttons Next to many of the fields are buttons which will display a list of choices for that field. Click the button and select the choice (by double-clicking on the choice or high- lighting the choice and selecting OK). The following fields have lists: classification, quality, fidelity, originator type, and publication type. 4.3.3.2 Fields The following fields enable you to meet the minimum standards for defining source references for a family tree. Classification. A code which classifies the source which contained the evidence data. For example, an official census or a church record. Title A descriptive string for the source. For example, 1890 Census Records. Quality The submitter's assessment of he reliability of the source. Please use the list requester for this field. Fidelity A code which provides an assessment of the exactness of the source material. For example, an original record being cited, a photocopy of the original, a transcription of the original, or an abridgement of the original. Page Description. A description which identifies the page within the source. It may be a page number, range, or anything other description of hor to find the referenced information within the source. For example, Page 212 - middle paragraph. Originator Name. The name of the person or organization that created the source. For example, the US Government. Originator Type. The type of organization or person that created the source. For example, author, organization, or interviewer Publication Title. The name of the publication such as a book name, periodical name, or newspaper. For example, The Washington Star. Publication Type. The type of publication that is the source. For example, a book, periodical, newspaper, etc. Publication Publisher. The name of the publisher that created the source. For example, Simon & Schuster. Publisher Address. The address of the publisher that created the source. Publication Date. The date the source was published. For example, 12-May-1800. Publication Edition. A description of the specific version of the publication being referenced. For example, 2nd Printing. Physical Filename. An optional file that may be attached to the source. It may be any type of file: a picture of the evidence, a descriptive voice an- notation, etc. 4.4 Genealogical Charts GenTree provides genealogical charts for outputting your family tree. You can display pedigree charts, descendant charts, and family groups. You can create these charts from the main window or the member entry windows. 4.4.1 Pedigree Charts Pedigree charts lists a member's pedigree (i.e. par- ents, grandparents, great grandparents, etc.) To display a pedigree chart, select the pedigree menu item from the dis- play menu. A requester (see figure) will appear prompting you for whom you want to display. You must enter a mem- ber ID. There is a list requester available by pressing the Member ID button. In addition, you may enter the chart ID and the number of generations to display. By default, GenTree displays as many gen- erations as will fit on the display screen using the display font (set in preferences). For each member displayed in the pedigree chart (except the last generation), GenTree dis- plays the ID, name, birth/death date and place, and, under the male, the marriage date if any. Finally, you may turn off the display of birth/death place by deselecting the check-marked button. After clicking the Display button (or hitting carriage return), the pedigree informa- tion will be compiled and displayed. Click the close button to exit back to your window. 4.4.2 Descendant Charts Descendant charts show the descendants of one member (his/her children, their children, etc.) To display a descendant chart, select the descendant menu item from the display menu. A requester (see figure at left) will ap- pear prompting you for whom you want to display their de- scendants. You must enter a member ID. There is a list requester available by pressing the Member ID button. In addition, you may enter the chart ID and the number of generations to display. By de- fault, GenTree displays as many generations as will fit on the display screen horizon- tally using the display font (set in preferences). For each member displayed in the de- scendant chart, GenTree displays the ID, name, and the birth/death dates and places. You may turn off the display of birth/death places by deselecting the check-marked but- ton. After clicking the Display button (or hitting carriage return), the descendant infor- mation will be compiled and displayed. Click the close button to exit back to your win- dow. 4.4.3 Family Groups A family group shows one family i.e. a father, a mother, and any children. To display a family group, select the family group menu item from the display menu. A re- quester (see figure at left) will appear prompting you for a member and their spouse to display. You must enter the member's ID. There is a list requester if you forget available by pressing the Member ID button. There also exists a spouse ID requester which will list all of the spouses of the member in the member ID field. Members without a spouse may leave the spouse ID field blank. If the member has a spouse, you must enter the ID. Finally, you may enter the chart ID for recordkeeping purposes. After clicking the Display button (or hitting carriage return), the family group infor- mation will be compiled and displayed. Click the close button to exit back to your win- dow. 4.4.4 Printing Charts You may also print your charts and family groups. The charts may be output to file or to the printer. If you want to output to the printer, GenTree uses the application specified in the GFXPrint field for preferences. The default printing application is GenTree's internal application. For other printer application, GenTree will grab the screens for the charts, save them to RAM, and create a script file containing the filena- mes and paths. The script filename is inserted into the GFXPrint screen at the asterisk. For example, "SYS:Utilities/Display from * opt bp t=1" becomes "SYS:Utilities/Display from Ram:T/GT/scriptlist opt bp t=1". This string is fed as a CLI command to AmigaDOS. To print a chart or family group: · Display a chart/group using the procedure outlined in the previous sections. · From the Display screen, select Print from the menu. A print requester will appear (see figure previous page). · Click the print button to send the output to the printer. If you want the display to go to file, click the Destination button and fill in a path and filename first. 4.5 MomentED The Moment Editor (MomentED) is a full-featured ASCII editor integrated into the GenTree program. It is called the Moment Editor because it took me only a "moment" to create. MomentED provides a superb example of CanDo; it took me approximately 3 days to complete. MomentED provides the following features: · Document sizes are limited only by memory · Unlimited number of documents open at once (again limited by RAM) · Undo feature · Block and line copy and paste in same document or between documents · Sort Document or block in ascending order ignoring case · Find and Replace utilities If you have used a word processor or text editor before, you will be entirely com- fortable with MomentED. You access the editor by selecting the Edit or Editor button from the Media windows (Personal or Global). The current document's name is dis- played in the window title bar. Here is a list of MomentED's menus and their functions: Project Menu - Create, open, and save documents. New Create a new, blank document. The new document will become the current document. Other documents in memory are not lost. Open... Open a previously saved document. The opened document will become the current document. Other documents in memory are not lost. Close Close the current document. If there are other documents avail- able, MomentED will swap to one of those. Otherwise, a new, blank document will appear. Save Save the current document using the current name. Only the cur- rent document is saved. Save As... Save the current document using a new name. A file requester ap- pears from which you select the path and filename. Only the cur- rent document is saved. Print... Print the current document. A requester appears from which you may specify the destination of the document. The default destina- tion is the printer. Only the current document is printed. About... Displays the version of MomentED. In addition, memory usage, the number of documents loaded, and the size of the current docu- ment (in characters and lines) are displayed. Quit... Exits the program. If any of the documents currently loaded have been changed, you are requested to see if you are sure. Edit Menu - Edit the document. Undo Undo your last change. Beware, switching between documents means you cannot undo your change. Cut Cut the currently selected block from the document. You must first select a block using the mark begin and end keys (detailed below). Copy Copy the currently selected block from the document. You must first select a block using the mark begin and end keys (detailed be- low). Paste Paste the block you cut, copied, or sorted at the current cursor po- sition. Sort block Sort the currently selected block. The block is sorted on the first character of each line of the block in ascending order. The case of words is ignored. Clear Clear the current document. Utilities - Modify text for the document. Find... Displays the Find Requester (see fig- ure). You can search for characters by word or string, case-sensitive or not. Change... Displays the Change requester (see figure). From this requester, you can search for an occurrence of a certain string and replace it with another string. You have the option of search- ing by word or string and with- case-sensitivity or not. After the string is found, you have the option to make the change, skip this occurrence, or replace all occurrences. Margins... Displays the Margin requester (see figure next page). From this requester, you can change the margins for the entire document. You specify the left margin and the right margin. Any left margin greater than one will cause all lines to have spaces inserted on the left to "left justify" the lines. Sort Sort the entire current document. The document is sorted on the first charac- ter of each line in ascending order. The case of words is ignored. Window Menu - Display help screen or switch the current document. Help Displays the help screen listing all hot keys for the editor. Select... Displays a list requester allowing you to select the current docu- ment. First Swaps the current document with the first document in memory. Next Swaps the current document with the next document in memory. Previous Swaps the current document with the previous document in memory. Last Swaps the current document with the last document in memory. Here is a list of MomentED's hot keys and their functions: Ctrl-[ Select the start point of a block. This key is used with the Ctrl-] key to delimit a block. After you have delimited a block, you can cut, copy, or sort the block. Ctrl-] Select the end point of a block. This key is used with the Ctrl-[ key to delimit a block. After you have delimited a block, you can cut, copy, or sort the block. Ctrl-Y Delete the current line. Alt-Y Paste the line last deleted at the current cursor position. LeftAmiga-Y Delete from the current cursor position to the beginning of the line. RightAmiga-Y. Delete from the current cursor position to the end of the line. Ctrl-X Clear the current line. A blank line is left where the line used to be. Ctrl-Up Move the cursor to the top of the document. Ctrl-Down Move the cursor to the bottom of the document. Ctrl-Left Move the cursor to the beginning of the current line. Ctrl-UP Move the cursor to the end of the current line. Shift-Up Move the cursor up one page of the document. Shift-Down Move the cursor down one page of the document. Shift-Left Move the cursor to the beginning of the previous word. Shift-UP Move the cursor to the beginning of the next word. Help Display help screen. 4.6 Preferences GenTree allows extensive control over the appearance and behaviour of the pro- gram. From a preferences screen, you can change fonts, fontsizes, default directories, and other parameters. 4.6.1 Defaults On start-up, GenTree uses the preferences specified in the GenTree.Def file (contained in the same directory) or, if it cannot find this file, internal default prefer- ences. This way, by using the GenTree.Def file, you can set up default preferences for the start of each session. In addition, every family tree you create contains the preferences used at the time you saved it. The preferences window (see figure) allows you to change any of GenTree's preferences. Listed below are the preferences, their definitions, and their defaults as specified internally: Font This parameter specifies the font used in all GenTree execution windows ex- cept the Chart Display window. Any font in your FONT: directory may be used (even outline fonts). The Default font is "Times". Font Size This parameter specifies the size of the default font. The default font size is 11 points. Display Font This parameter specifies the font used in displaying family groups and charts. Any font in your FONT: directory may be used (even outline fonts). The Default font is "Times". Display Font Size. This parameter specifies the size of the display font. The de- fault display font size is 11 points. Year Range This parameter is used with the search requester. When you specify About in the birth or death date, GenTree will search for members that satisfy that date plus or minus Year Range years. This number must be an integer. The default value is plus or minus 5 years. Report Labels Justification. This parameter controls how the labels in a printed report appear: either left-justified, right-justified, or centered. The default value is left-justified. Put Page Breaks in report? This parameter controls whether a line feed or a page break is placed between every member output in a report. The default value is false. SEENOTES is TRUE for sorts? This parameter controls how GenTree interprets the date format: SEENOTES. When sorting, if this option is true, the SEENOTES dates will always be less than, greater than, or whatever the sort is. The default value is true. Create Icons? This parameter controls whether or not GenTree creates an icon for your family tree when it is saved or when something is "printed" to a file. A check means that icons will be created. The default is on. This parameter is closely related to the All Products parameter. All Products? This parameter controls whether or not GenTree creates icons for all files it produces. Since GenTree makes a file for every member in your family tree, this option should be left off. However, for those who just need to waste disk space this option exists. A check means that icons will be created. The default is off. Convert Dates? This parameter controls when GenTree converts dates whether or not it will display the GenTree default date format. By leaving this option off, GenTree will still validate dates. However, the text string you input will remain. This allows you to use display date for- mats you are more comfortable with (for example, spelling out the entire month). The default is on. Compare Full Dates? This parameter controls how GenTree compares dates. When this option is true, GenTree uses the date modifiers (After, Before, Between, and About) and tries to figure out which date is less than (or greater than) another. This can get tricky if GenTree is comparing dates like After 1990 and Before 1991. This options make sorts take longer since the logic is harder. The default value is true. Display Birth/Death Locations? This parameter is used when GenTree generates charts or family groups. You can save space on the display by not showing the birth and death locations in your charts. The default is on. Default Directories (pictures, sounds, notes, sources, and persons). These fields specify the default directories for where GenTree first looks for that type of file. Do not fill in the filename! In the case of the persons directory, the parameter controls where any new members will be saved when you next save the family tree. This allows you to save new members on different disks (or directories) as available space is used up. The defaults for these directories are the directories located in the GenTree default directory. Notes & Sources -- Editor -- This parameter specifies the default editor to use whenever you want to edit a note or source. Leaving this field blank uses the internal GenTree editor, MomentED. Note that you must give the full path and editor name AND, if any spaces exist, you must surround the path and file with quotes. When you select a file to edit, GenTree appends the filename to this field and tries to run it. The default is to use MomentED. Note: I have successfully tested Final Copy II and Ed. Notes & Sources -- Viewer -- This parameter specifies the default text viewer to use whenever you want to view a note or source. Leaving this field blank uses the internal GenTree text viewer. Note that you must give the full path and viewer name AND, if any spaces exist, you must surround the path and file with quotes. When you select a text file to view, GenTree appends the filename to this field and tries to run it. The default is to use the internal text viewer. Note: I have successfully tested More and MuchMore. Pictures & Sounds -- Viewer -- This parameter allows you to extend the function- ality of GenTree by using a third party picture viewer, to display for- mats not supported, GIF, JPEG, IFF24, etc. Leaving this field blank uses the internal GenTree picture viewer. Note that you must give the full path and viewer name AND, if any spaces exist, you must surround the path and file with quotes. When you select a picture to view, GenTree appends the filename to this field and tries to run it. The default is to use the internal viewer. Note: I have successfully tested and use ViewTek (VT). I heartily recommend using this excellent viewer. With it, you can display JPEG, IFF24, and full screen animations. You may also place the filename of an AREXX script in this field. Pictures & Sounds -- Player -- This parameter allows you to extend the function- ality of GenTree by using a third party picture sound player, to play formats not supported. Currently, GenTree will only play IFF 8SVX. Note that you must give the full path and player name AND, if any spaces exist, you must surround the path and file with quotes. When you select a sound to play, GenTree appends the filename to this field and tries to run it. The default is to use the internal player. Note: You may also place the filename of an AREXX script in this field. Pictures & Sounds -- GFXPrint -- This parameter controls the printing of your charts and family groups from the charts window. GenTree uses the value in this field to print the IFF of the screen. GenTree saves the screens to RAM and creates a file called ScriptList. This file lists all files to print. When you select print, GenTree inserts the path and name into the GFXPrint string. The name is inserted at the asterisk. The current default is GenTree's internal code. An- other default might look like "SYS:Utilities/Display from * opt bp t=1." This assumes that Display is in your utilities drawer. 4.6.2 Changing The Defaults You may change any preferences using GenTree's preferences window. Some parameters you modify by checking on/off the button. Others require text input. But- tons next to parameter fields display requesters to aid you in filling in proper text. The Font and Display Font buttons will display the fonts contained in your FONT: directory. Double-click on the font you wish to use. The Font Size and Display Font Size buttons display the sizes available for that font. For outline fonts, a standard list of sizes is dis- played. Under WB 2.0, you may use font sizes not specifically available for that font. The directories and media buttons display a file requester for you to find the relevant file/directory. 4.7 Joining GenTree Databases GenTree provides the ability to join family trees to make one colossal family tree. In fact, if you wish to enter a GEDCOM tree into your database, joining is the only way to do so. After GenTree converts the GEDCOM file to GenTree format, you combine the new tree to your own family tree. You don't have to join your family tree with the en- tire other family tree, GenTree allows you to perform sub- queries on the joining family tree before adding it to yours. To join family trees, you must have a family tree al- ready loaded. After loading your family tree, select Join... from the project menu of the main window. The Join win- dow will appear (see figure) which is where you control how the two family trees are joined. The very first thing you must do is find the GenTree database you want to add. The field at the top of the window informs you what family tree you are adding. You can change this database if you want. By default, GenTree wants to join every member from the entire newdatabase with your current GenTree database. However, you can select only a subset of those members by pressing the Subset of members radio button. GenTree will bring up the Search requester where you may limit the members to join. Also by default, GenTree only imports members, not any of the media databases. If you want to combine the me- dia databases as well, check the appropriates boxes. When everything is to your satisfaction, click the OK button and GenTree will join the two databases. You will then need to go into the Personal information windows to update the links between the families or to delete any unnecessary members. Warning! The join operation is irrevocable. GenTree creates new member records on disk (or whereever the Persons Dir is set in the preferences window) and saves the database. If you are not sure of what you are doing, use a work- ing copy of the your family tree instead. 4.8 Printing GenTree Databases Genealogical information would not be as useful if you couldn't print it out. So, of course, GenTree provides a printing capability. Using the print option, you can dump all or portions of your family tree to the printer or to a file. This print file is an ASCII file which you may later edit. If you want to print the graphic pedigree charts or other charts you made, use the print option from the display window. To print your family tree, select Print... from the project menu of the main window. The Print requester will appear (see figure). From this requester, you decide ex- actly what portions of your family tree to print. Select the All Members (default), Subset of Members radio button or Only Updated Members radio button to choose what members to print. If you select the Subset of Members button, GenTree will provide the Search Re- quester for you to choose the criteria by which members are selected. This is the stan- dard search requester used throughout GenTree allowing you to query by ID, name, gender, and birth/death dates and countries. If the Only Updated Members button is selected, only members changed since the last save will be printed. You can get a list of changed member records by choosing the Info... menuitem from the main window. The two buttons on the right control in what order the members are printed. By cycling through the options, you can print the members unsorted or sorted in ascend- ing/descending order by ID, name, gender, birth date, birth country, death date, or death country. Finally, all the check boxes at the bottom control what parts of a member's infor- mation is printed. A check in the box means that option will be printed. The options are explained below: Members Checking this box displays the members' names and IDs. If this box is unchecked you cannot select the Dates, Places, Family Members, Supplemental or Charts boxes. Birth & Death Dates. Checking this box displays each members' birth date and death date. Birth & Death Places. This box controls the display of each members' birth place and death place. Family Members. Checking this box displays for each member their spouses, children, father, and mother. These members may be displayed later, but this shows the relationship, the family ties. Supplemental. Checking this box displays all the information you entered in the supplemental information window for each member printed. Pedigree Charts. Checking this box directs GenTree to build a Pedigree chart for each member displayed. The pedigree chart is not graphical, rather it shows the relationships through text placement. This op- tion increases the time to print dramatically since GenTree must get multiple records for each member it prints. Descendant Charts. Checking this box directs GenTree to build a Descendant chart for each member displayed. The descendant chart is not graphical, rather it shows the relationships through text placement. This option increases the time to print dramatically since GenTree must get multiple records for each member it prints. List Pictures Checking this box will display the logical names of all the pictures associated with each member printed. List Sounds Checking this box will display the logical names of all the sounds associated with each member printed. List Notes/Full Notes/No Notes. This button cycles through 3 options for display- ing notes. List Notes displays the logical names of the notes asso- ciated with the member. Full notes displays the entire note of all the notes in the member's personal note media database after the member. No Notes displays nothing from the members' note data- base. List Sources/Full Sources/Refer Srcs to EndNotes/No Sources. This button cycles through 4 options for displaying sources (references). List Sources displays the logical names of the sources associated with the member. Full Sources displays the entire source text of all the references in the member's personal note media database after the member. Refer Srcs to EndNotes displays, for each printed mem- ber, the logical names of the sources referenced in their personal media database and prints the entire source text at the end after all members have been printed. No Sources displays nothing from the members' source database.