Otherware

home *** CD-ROM | disk | FTP | other *** search

/ Otherware / Otherware_1_SB_Development.iso / amiga / demos / commerci / origins.lzh / Stuff / Origins_Demo.doc < prev next >

Wrap

Text File | 1992-09-27 | 63.8 KB | 1,256 lines

Instructions for Origins V1.0 ⌐1992 by The Puzzle Factory TABLE_OF_CONTENTS ~~~~~~~~~~~~~~~~~ <Getting Started> How to use the online-help\Getting_Started\ PROJECT_MENU <User Preferences> Changing program behaviour\User_Preferences\ <Change Colors> Changing program colors\Change_Colors\ <Check Free_Memory> Checking available system memory\Check_Free_Memory\ <Edit Source Files> Editing genealogical source file\Edit_Source_Files\ <Item Person Source> Person source files\Item_Person_Source\ <Item Ordinance Source> Ordinance source files\Item_Ordinance_Source\ <Item Marriage Source> Marriage source files\Item_Marriage_Source\ <Edit Note Files> Editing genealogical note files\Edit_Note_Files\ <Item Person Notes> Person note files\Item_Person_Notes\ <Item Ordinance Notes> Ordinance note files\Item_Ordinance_Notes\ <Item Marriage Notes> Marriage note files\Item_Marriage_Notes\ <Item Family Notes> Family note files\Item_Family_Notes\ <About> About Origins\About\ <Quit> Quitting Origins\Quit\ CREATE_MENU <Create Persons File> Creating a Persons File\Create_Persons_File\ <Create Ordinance File> Creating a Ordinance File\Create_Ordinance_File\ <Create Marriages File> Creating a Marriages File\Create_Marriages_File\ <Create Parent/Child Index> Creating the Parent/Child Index\Create_Parent/Child_Index\ <Create Marriage Index> Creating the Marriage Index\Create_Marriage_Index\ UPDATE_MENU <Update Persons File> Editing Person records\Update_Persons_File\ <Update Ordinance File> Editing Ordinance records\Update_Ordinance_File\ <Update Marriage File> Editing Marriage records\Update_Marriage_File\ <Search For> How to search for records\Search_For\ LIST_MENU <List Person's Records> List the Person database\List_Person's_Records\ <List Marriage Records> List the Marriage database\List_Marriage_Records\ <List Parent/Child Index> List the Parent/Child Index\List_Parent/child_Index\ <List Ahnentafel> List Person's direct ancestors\List_Ahnentafel\ <List Soundex> List Persons by Soundex code\List_Soundex\ REPORT_MENU <Person's Data> Generate a detailed report about a Person\Person's_Data\ <Family Group Sheet> Generate a detailed report about a Family\Family_Group_Sheet\ <Pedigree Chart> Generate a Pedigree Chart\Pedigree_Chart\ <Descendant's Charts> Generate a Descendant's Chart\Descendant's_Charts\ <Tiny Tafel> Generate a Tiny Tafel\Tiny_Tafel\ DISPLAY MENU <Display Person> Display Person records\Display_Person\ <Display Ordinance> Display Ordinance records\Display_Ordinance\ <Display Marriage> Display Marriage records\Display_Marriage\ <Display Family Group> Display Family groups\Display_Family_Group\ <Display Pedigree> Display Pedigrees\Display_Pedigree\ <Display Instructions> Display the hypertext help file\Display_Instructions\ THINGS TO KNOW <Entering Data> How to enter data into Origins\Entering_Data\ <About Dates> All about date formats\About_Dates\ <About Searches> How to make searches work for you\About_Searches\ OTHER FEATURES <About Pictures> How do I show pictures of people?\About_Pictures\ <About Notes> How do note files work?\About_Notes\ <Source Documentation> How do I document my information?\Source_Documentation\ <Using Hypertext> How do I use the hypertext reader?\Hypertext_Engine\ <Creating Hypertext> How do I create hyper-documents?\Creating_Hypertext\ <Glossary> \Glossary\ Overview ~~~~~~~~ A data base is a collection of information arranged in an orderly way so as to make quick access to individual pieces possible. A data base program is a piece of software that will maintain a data base for you and operate on it. Origins is a data base program dedicated to managing genealogical information. It accomplishes this with a small, fast data base engine, and a graphical user interface specially designed to work with genealogical data. Because Origins only has to deal with one specialized type of data base, it can be smart about some things that will help make your job as a genealogist easier. For example, when you enter data for a new person into your data base, you will generally describe this person's parents (if known) at the same time. Origins will automatically create two records for these persons when the primary record is saved. Origins will correctly handle multiple marriages, step-children, unmarried parents, and other difficult situations. Records can be searched for Surname, Given Name, Birth Date, Birth City, Birth Country and Gender. Origins uses 3 data bases containing details of the Persons, Ordinances (which includes baptisms and miscellaneous information), and Marriages. These data bases are then cross referenced by a Parent/Child Index file and a Marriage Index file. Additionally, the GenFile is used by the program to save important information about the sizes of the data bases as well as your preferences. Origins is very comprehensive and easy to use. I hope this program will enable you to carry out interesting research into your own family background. Getting_Started ~~~~~~~~~~~~~~~ The first thing you should do is get acquainted with the hypertext system used in Origins. Double-click on the next line to find out about how to use the built-in <hypertext engine> to help you make the\Hypertext_Engine\ best use of these instructions. Now that you know how to use the on-line help system, a complete list of all Origins menu functions follows: PROJECT_MENU ~~~~~~~~~~~~ User_Preferences This item allows you to specify certain preferences for the way you want Origins to work for you. This information is saved in the GenFile if you select SAVE when you are done setting your preferences. If you select USE, the preferences will only remain in effect for the current session. Select CANCEL to change nothing. There are eight preference gadgets. The following are currently active: AutoOrd: Automatically update a matching Ordinance record when a Person record is saved. AutoPCI: Automatically update the <Parent/Child Index> when a Person\Create_Parent/Child_Index\ record is saved. Not recommended. Sources: Automatically create a <specimen> source documentation file\Source_Documentation\ if it doesn't already exist, when a Person, Ordinance, or Marriage record is saved. AutoMin: Automatically update the <Marriage Index> when a Marriage\Create_Marriage_Index\ record is saved. Not recommended. AutoSiz: Disabled in the demo version. Change_Colors Allows you to change the colors of the screen. The SAVE gadget tells Origins to save your selection to the GenFile, while the USE gadget causes the new colors to remain in effect for the current session only. The CANCEL gadget cancels any changes you may have made. Check_Free_Memory Allows you to check system free memory. Edit_Source_Files Origins is capable of saving genealogical <source> documentation both\Source_Documentation\ for your own use, and for the use of others who may be accessing the data that you have assembled. Because the names for these files are based on record numbers, it can be difficult to determine which file to edit. These functions determine the proper source file, and call an ARexx script to load the file into your editor, starting the editor first, if necessary. If the source file doesn't already exist, these functions will exit. To create source files, enable SOURCES in <User_Preferences>, and use\User_Preferences\ the <update record> functions to save the records for which you want\UPDATE_MENU\ source files created. Item_Person_Source Enter the number of the Person whose source file you wish to edit. You may <search> for a person using the normal search attributes.\About_Searches\ Item_Ordinance_Source Enter the number of the Ordinance source file you wish to edit. You may <search> for a person using the normal search attributes, and\About_Searches\ Origins will attempt to convert the result into an Ordinance number. Item_Marriage_Source Enter the number of the Marriage source file you wish to edit. You may <search> for a person using the normal search attributes, and\About_Searches\ Origins will attempt to convert the result into a Marriage number. Edit_Note_Files Origins is capable of accessing anecdotal <note files> both for your\About_Notes\ own use, and for the use of others who may be accessing the data that you have assembled. Because the names for these files are based on record numbers, it can be difficult to determine which file to edit. These functions determine the proper source file, and call an ARexx script to load the file into your editor, starting the editor first, if necessary. If the note file doesn't already exist, you will be asked if you want to create a new one. Item_Person_Notes Enter the number of the Person whose note file you wish to edit. You may <search> for a person using the normal search attributes.\About_Searches\ Item_Ordinance_Notes Enter the number of the Ordinance note file you wish to edit. You may <search> for a person using the normal search attributes, and Origins\About_Searches\ will attempt to convert the result into an Ordinance number. Item_Marriage_Notes Enter the number of the Marriage note file you wish to edit. You may <search> for a person using the normal search attributes, and Origins\About_Searches\ will attempt to convert the result into a Marriage number. Item_Family_Notes Enter the number of a Person. You may <search> for a person using the\About_Searches\ normal search attributes. Then select either PARENT or CHILD to indicate the position of this person in the family. For more information about families, see <Display_Family_Group>.\Display_Family_Group\ About Displays the standard copyright notice. Quit This way to the egress... <Goto Table of Contents>\TABLE_OF_CONTENTS\ <Goto Update Menu>\UPDATE_MENU\ <Goto List Menu>\LIST_MENU\ <Goto Display Menu>\DISPLAY_MENU\ <Goto Glossary>\Glossary\ CREATE_MENU ~~~~~~~~~~~ Create_Persons_File Create_Ordinance_File Create_Marriages_File These menu items are normally used to enlarge their corresponding data bases, and are disabled in the demo version. Create_Parent/Child_Index Create_Marriage_Index Creates a file <indexing> all the parents and children in the Person\indexing\ file, or all marriages in the Marriage file. These functions may be aborted while sorting by clicking on the CLOSEWINDOW gadget of the small window while it is visible. After sorting is completed, the small window will close and the index will be written to disk. If successful, these functions always overwrite the old index. You will not be allowed to use these functions until you have entered one or more person/marriage records. Both the Parent/Child Index and the Marriage Index must exist in order to use some features: Display Family Group Display Pedigree List Alpha Persons List Alpha Marriages Print Pedigree Chart Print Family Group Sheet Print Descendant's Charts Various searches If some functions seem to not find records that you think they should, consider creating new Parent/Child and Marriage indexes. You may always safely search for Persons without using the indexes. If you have a really large genealogy data base, consider entering new information in batches. Then, when you're finished, you can let Origins create new indexes while you do something else. <Goto Table of Contents>\TABLE_OF_CONTENTS\ <Goto Project Menu>\PROJECT_MENU\ <Goto List Menu>\LIST_MENU\ <Goto Display Menu>\DISPLAY_MENU\ <Goto Glossary>\Glossary\ UPDATE_MENU ~~~~~~~~~~~ The Update Menu items allow you to enter data into the Origins data bases. You may enter descriptions of Persons, Ordinances or Marriages as well as additional information about these things. Along the bottom of the update window are five gadgets. These gadgets function in a similar way throughout the update menu, although there are differences between the different functions. Selecting the SAVE gadget writes the record as it is currently displayed to the data base. The PREVIOUS and NEXT gadgets will generally take you to the previous and next record. The SPECIFY gadget will allow you to enter a record number or search for a person. The QUIT gadget will exit the current function. Update_Persons_File This is the main input screen for the program. Selecting this item brings up a requester asking you for the desired record. Type in the desired record number, or enter 0 to display the first <blank record>.\blank_record\ If you are just starting, there are no <records>, so just hit return.\record\ If you click on the <search> gadget, you may enter information\Search_For\ describing a Person. After <entering> a record number or description of a person, you will\Entering_Data\ then be presented with either your requested record, or if not found, a requester will ask if you would like a <blank record>. Click on\blank_record\ OK to get a blank record, or CANCEL to return to the number requester. Once you have a blank record to edit, enter the information requested in the appropriate fields. When you first describe a person, Origins will search for the first two blank records it finds in the Person file and assign them to the Father's and Mother's Record Number <fields>. By entering data in the\field\ Record Number and Surname fields you can create both new records and assignments. Create new records by entering the names of the Father and Mother into the Surname and Given Name fields, leaving the Record Number fields alone. When you save this record, Origins will create new records for the Father and Mother. Create assignments by editing the Father's and Mother's Record Number fields to link existing Person records, and leaving the other fields alone. Next to the Code field are two cycle gadgets labeled AI and DI, corresponding to Ancestor Interest and Descendant Interest. These gadgets are for use in generating <Tiny-Tafels>. If you will not be\Tiny_Tafel\ using Tiny-Tafels, these gadgets may be ignored. Selecting SAVE writes the record as it's currently displayed to the data base. If anything was entered in the Father or Mother surname fields, those records will be created and saved to the data base as well. Selecting any other gadgets without selecting SAVE first, will bring up a requester asking you if you would like to save the new information. After the Person's record is saved, and if you have turned on <Sources>, Origins will look for the source documentation file and, if\User_Preferences\ it is not found, will ask you if you would like it to be created. If you click on OK, a specimen file will be created. If the ARexx resident process is running on your system, you will be asked if you would like to <edit> the source file. This will happen whether the\Edit_Source_Files\ file has just been created, or already exists. If you click on OK, Origins will call an ARexx script to load the file into your editor, starting the editor first, if necessary. Next, you will be asked if you would like to update the Parent/Child Index, if <AutoPCI> has been activated. If so, click on OK. Origins\User_Preferences\ will go through the Person file and create a new index. If you do not wish to do this, click on CANCEL. See <Create_Parent/Child Index> for\Create_Parent/Child_Index\ more information. Using AutoPCI is not recommended. Finally, you will be asked if you want to update the Ordinance file at this time, if <AutoOrd> has been activated. If so, click on OK. You\User_Preferences\ will be taken to the Update Ordinance screen, and presented either with an existing Ordinance record, or a blank Ordinance record with the Personal Record field filled in with the Person's record number that you just saved. Clicking on SAVE will return you to the Update Person screen after saving the record. Clicking on QUIT will take you back to the Update Person screen immediately. If you do not wish to edit or enter an Ordinance record at this time, click on CANCEL. See <Update Ordinance File> for more information.\Update_Ordinance_File\ The PREVIOUS and NEXT gadgets will take you to the previous and next Person record. If you are already at the first record, the PREVIOUS gadget will take you to the first blank record. If you are at the highest active record, the NEXT gadget will display a requester informing you that there are no more records. After you click on OK, you will be presented with the first blank record. The SPECIFY gadget will allow you to enter a record number or <search>\Search_For\ for a person. After entering your search criteria, clicking on OK will begin the search at record number 1, while clicking on NEXT will begin the search at the record following the last successful search. Do not use zero as a Personal Code. Zero is the "blank" value, and you will not be able to successfully use this value for searches, etc. Update_Ordinance_File This is the input screen with which to add extra details about persons, i.e. baptism, confirmation and immigration dates, occupation, etc. Selecting this item brings up a requester asking you for the desired record. You may type in a desired record number, or enter 0 to display the first <blank record>. If you are just\blank_record\ starting, there are no <records>, so just hit return.\record\ If you click on the <search> gadget, you may enter information\Search_For\ describing a Person. Origins will automatically translate this into an Ordinance record number, if found. After entering a record number or description of a person, you will then be presented with either your requested record, or a blank record to edit. <Enter> the information requested in the appropriate fields.\Entering_Data\ If you are editing a blank record, the first thing you should do is enter the record number of the Person in the "Personal Record #:" field (if this function was started automatically because you had AutoOrd set, this will have been done for you). In this function only, you may enter a zero in the 1st, 2nd or 3rd Spouses fields to tell Origins to erase that name from your Ordinance record. This will not work on other Ordinance fields, or other types of records. After the Ordinance record is saved, and if you have turned on <Sources>, Origins will look for the source documentation file and, if\User_Preferences\ it's not found, will ask if you would like it to be created. If you click on OK, a specimen file will be created. If the ARexx resident process is running on your system, you will be asked if you would like to <edit> the source file. This will happen whether the file has just\Edit_Source_Files\ been created, or already exists. If you click on OK, Origins will call an ARexx script to load the file into your editor, starting the editor first, if necessary. The gadgets are the same as those on the Update Persons screen. Update_Marriage_File This item accepts input concerning marriages; date, place, and other details. Selecting this item brings up a requester asking you for the desired record. You may type in a desired record number, or enter 0 to display the first <blank record>. If you are just starting, there\blank_record\ are no <records>, so just hit return.\record\ If you click on the <search> gadget, you may enter information\Search_For\ describing a Person. Origins will automatically translate this into a Marriage record number, if found. If more than one marriage exists in the data base between the Person described and others, a requester will ask you to choose which marriage you are interested in editing. Click on the desired choice or ABORT. If the latter you will be returned to the number requester. After entering a record number or description of a person, you will then be presented with either your requested record, or a blank record to edit. <Enter> the information requested in the appropriate fields.\Entering_Data\ If you are editing a blank record, the first thing you should do is enter the person record numbers of the Husband and Wife. Now you can enter appropriate information about the wedding. Additionally, there is a comment field where you can leave a note up to 50 characters in length. After the Marriage record is saved, and if you have turned on <Sources>, Origins will look for the source documentation file and, if\User_Preferences\ it's not found, will ask if you would like it to be created. If you click on OK, a specimen file will be created. If the ARexx resident process is running on your system, you will be asked if you would like to <edit> the source file. This will happen whether the file has just\Edit_Source_Files\ been created, or already exists. If you click on OK, Origins will call an ARexx script to load the file into your editor, starting the editor first, if necessary. Do not use zero as a Marriage Code. Zero is the "blank" value, and you will not be able to successfully use this value for searches, etc. The gadgets are the same as those on the Update Persons screen. Search_For The search function allows you to search through all Person records for particular criteria. You may enter search criteria for Surname, Given Name(s), Birth Year, Birth City, Birth Country, Personal Code, and Gender. Additionally, you may enter as many or as few of these criteria as you like. All blank entries will be ignored, and an attempt will be made to find a record that matches all the search criteria you have entered. If successful, that record will be displayed. Otherwise, you will get a chance to edit your criteria, perhaps to be less restrictive, and try again. The Surname and Given Name(s) criteria match any entry in their respective fields from the left, and only for the length of the search criteria. The Birth Year entered may be preceded by < for 'prior to' or by > for 'after', i.e. "<1940" will only find births prior to 1940, while ">1962" will find births since 1962. Of course "1978" will find only births that occurred in 1978. Note that a blank date field in a Person record will match any date in the Search Requester date field. If a search was successful, the next search may begin either at the beginning of the data base, or at the Person record following the one that was found. This is controlled by the OK and NEXT gadgets on the search requester. After entering the search criteria, if you click on OK, the search will be reset to the beginning of the data base. If you click on NEXT, the search will begin at the record following the last successful search. If you selected this function from the menu, it will automatically bring up the Display Person screen, but it is also used in a variety of other functions. In order to search for Persons from other functions, or to do further searches once the Display Person screen is active, you must select the SPECIFY gadget, and then the SEARCH gadget from the number requester. Also see <About Searches>.\About_Searches\ <Goto Table of Contents>\TABLE_OF_CONTENTS\ <Goto Project Menu>\PROJECT_MENU\ <Goto Create Menu>\CREATE_MENU\ <Goto Display Menu>\DISPLAY_MENU\ <Goto Glossary>\Glossary\ LIST_MENU ~~~~~~~~~ The List Menu gleans information from the Origins data bases, and creates condensed lists of the hilights that make it easy to find a particular piece of data. For more detailed information, please see the <Report Menu>.\REPORT_MENU\ You will not be allowed to use any of the List Menu functions until you have entered one or more records in the appropriate database. After selecting any of the List Menu functions, with the exception of the List Soundex function, you will be presented with the List requester. The SCREEN, FILE and PRINTER gadgets select where you desire the output to go. These 3 gadgets are mutually exclusive; you can only select one of them at a time. If listing to the screen, you may hit the spacebar to continue or the escape key to abort the listing at any prompt. If you are listing to a file, select the path and name under which you wish to save the file. Click on OK to continue. Clicking on CANCEL will return you to the List requester. If the list is to be printed, you will be asked if the printer is ready. Click on OK to print, or CANCEL to return to the List requester. NOTE: The FILE and PRINTER gadgets are disabled in the demo version for all List Menu functions except "List Person's Records". The ALPHA gadget will cause the list of Persons or Marriages to be alphabetized by name. Be aware that in the case of listing persons alphabetically, if you have an extensive data base this may take a while. See "About Sorts" in the manual for more information about alphabetizing. The SEARCH gadget will bring up the <Search Requester> and allow you\Search_For\ to limit which Persons are displayed. The results of the last search are ignored in the List Menu functions, so the OK and NEXT gadgets perform identically in this context. The search will always start at the beginning of the data base. Clicking on OK tells Origins to do what you have requested, while clicking on CANCEL will abort the function entirely. The gadgets on this requester function in a similar way throughout the List Menu, although the Alpha gadget is unavailable for Parent/Child Index because it is already sorted. List_Person's_Records Outputs a list of all Persons in the Person file. This list contains the Person's record number, gender, name, birth date, and the record numbers of their Father and Mother. If ALPHA is selected, these are sorted by name. The sort may be aborted by clicking on the CLOSEWINDOW gadget of the small window while it is visible. The list will then be presented in non-sorted order. The criteria entered in the Search Requester, if used, will determine which Persons are included in the listing. List_Marriage_Records Outputs a list of all the marriages in the Marriage file. This list contains the Marriage record number, the Husband's and Wife's name and record number, and the date and city of the marriage. If ALPHA is selected, these are sorted by Husband's surname. If the Search function is used, only those marriages in which the Husband or Wife matches the search criteria will be displayed. List_Parent/Child_Index Outputs a list of the records in the Parent/Child index. This list contains the Father, Mother and Child's names, record number, and birth date. ALPHA is unavailable, because these records are already sorted by Father's surname. If the Search function is used, only those records in which the Father, Mother, or Child matches the search criteria will be displayed. List_Ahnentafel An Ahnentafel lists a person and their direct ancestors, using the same numbering system as a pedigree chart, but with the entries running down the page in numerical order. This is much more compact than a pedigree chart, but you have to use the numbers to see the relationships. A Father has a number twice as large as his Child's, and the Mother's number is one more than the Father's. The List Ahnentafel function uses a slightly different version of the List requester. All the gadgets work the same way as in the normal List requester, except for the string gadget, where you must type in the record number of a Person to be at the head of the Ahnentafel, or click on the SEARCH gadget to enter information describing the Person. List_Soundex This is a search function that looks for Persons based on the way their surname sounds, rather than the way it's spelled. For more information see "About Soundex" in the manual. The List Soundex function uses a slightly different version of the List requester. All the gadgets work the same way as in the normal List requester except for the surname string gadget. Simply enter the surname for which you'd like to search. The conversion is not case-sensitive. Origins will convert the name you entered into a Soundex code, and display it in the titlebar. You will then get a list of all the Persons in the data base whose Soundex codes match the one you entered. REPORT_MENU ~~~~~~~~~~~ While the List Menu creates condensed lists, the Report Menu provides detailed information about Persons, Marriages and related topics. You will not be allowed to use any of the Report Menu functions until you have entered one or more records in the person database. While you will be able to use the Report functions without a Parent/Child Index or Marriage Index, the results will probably not be very satisfying due to the paucity of information available. Selecting an item from the Report Menu brings up a requester asking you for the desired record. You may type in the record number of a Person, Marriage, etc., or click on the SEARCH gadget to enter information describing a Person. Entering zero in the Number requester, or clicking on CANCEL, will cancel the function. After entering a record number or description of a person, you will then be asked to make sure the printer is ready. Clicking on CANCEL will cancel the function. Reports are only directed to the printer. If you wish to save a report to a file, you can use the Amiga program, "Cmd" to do so. See your Amiga manual for more information. Person's_Data This item prints information about a person in the Persons file. In addition, Ordinance and Marriage data are reported. If more than one marriage is found, they will be reported in date order, with the oldest listed first. As usual, blank or invalid date fields will be listed first. If <source documentation> files exist for this Person, they will be\Source_Documentation\ printed starting on a new page. First, PERSOURCEnnnnnn.txt, if it exists, will be printed. Then, ORDSOURCEnnnnnn.txt, if it exists, will be printed. Lastly, MARSOURCEnnnnnn.txt file(s) will be printed, if they exist; one source file for each marriage found. No formatting is done to these files -- they are printed exactly as you save them. When editing source documentation files, use a text editor that can output plain ASCII and newline characters at the end of each line. Family_Group_Sheet This item prints information on various members of the Family Group. Begin by selecting a Person. If this Person has more than one family described, Origins will then ask you to choose which family you would like a report made for. Select your desired choice or ABORT. If the latter you will be returned to the number requester. After verifying that the printer is ready, Origins will print information on this Person and their partner, their marriage if one exists, and their children. When reporting the children of this family, only the first marriage of each child, if any, is reported. Non-existent marriages are reported with a marriage record of zero. Pedigree_Chart This item prints Pedigree charts (Family Trees) for anyone in the Persons file. Standard numbering is used, with the selected Person in the number 1 position. See "About Pedigrees" in the manual. You must have condensed (136 column) printing capability on your printer to use this function. You need not be concerned with setting condensed printing -- Origins will do that for you, and turn condensed printing off when the pedigree chart is done. Attempting to use this function on a printer that does not support condensed printing is likely to produce strange results. After entering a record number or description of a person, you will then be presented with a pedigree chart of that Person with up to four generations displayed. The first marriage that was entered in the data base will be displayed for the selected Person, if found. Persons in the pedigree chart have their record number appended. Positions on the pedigree chart having blank records will not be displayed. For example, if your Maternal Grandfather has not been previously described, he will not be displayed on the pedigree chart. Descendant's_Charts This item prints Descendants Charts. Begin by selecting a Person. Origins will then print out all of this Person's descendants for four generations with appropriate indentations for each generation. Spouses for each Person in each generation will be displayed after their partner, but before their children. Spouses of relationships that did not produce children will not be included. Tiny_Tafel Origins can create a data structure, called a Tiny-Tafel, that is used to exchange genealogy information with others. When this item is selected, you will see a number of string gadgets in which to enter information for the Tiny-Tafel. Of these, only the Name field is required, and if that is blank, your Tiny-Tafel will not be saved. If you think you will be generating a lot of Tiny-Tafels, a header file is provided as an alternative to always typing in the tafel header information. Be sure to customize the sample header to include information about yourself. The Tiny_Tafel fields are: NAME: The name of the person who prepared or is submitting the genealogical information in this Tiny-Tafel. ADDRESS: Up to five lines of address information. Text entry is free-form. TELEPHONE: Area code and phone number. This field is optional. COMMUNICATIONS SERVICE: Enter the services through which you may be contacted. If contact will be made by computer, either this entry or the next one, or both, are required. Otherwise, this field is optional. BULLETIN BOARD: The name of an electronic bulletin board through which you may be contacted. This field is optional. COMMUNICATION PARAMETERS: The capabilities of your computer equipment. This field is optional, but is always included by Origins if you enter anything in the Bulletin Board field. REMARK: Anything. Text entry is free-form. This field is optional. Gadgets to control how the Tiny_Tafel is assembled include: MINIMUM INTEREST LEVEL: This excludes family lines that do not have an interest level flag set to the given level or above, for at least one of the ends of the family line. For example, if you have set the Minimum interest level to 2, then all family lines will be excluded where the two Persons at the ancestor and descendant ends of the line both have an interest level of less than 2. DATE FILL: Tiny-Tafel normally suppresses the output of data for which the birthdates necessary to establish each line of output are missing. When this switch is on, the Tiny-Tafel generator will estimate missing dates by applying a 30 year per generation offset wherever it needs to re-construct missing dates. MULTI NAMES: Tiny-Tafel normally lists a surname derived from the descendant end of each line. Specifying this option lists up to five unique spellings of each surname. PLACE NAMES: When this option is enabled, the place of birth of the ultimate ancestor and the place of birth of the ultimate descendant of a line of output, respectively, are added to the end of the line. SINGLE GEN: Tiny-Tafel normally suppresses lines of output that correspond to a single individual (that is, in which the ancestry and descendance dates are the same). This switch includes single-person items in the output. After deciding which options to use, click on SAVE to create your Tiny-Tafel and save it to disk. Origins will bring up the ARP file requester for you to select a directory and name for your file. The default name is 'Origins.tt', but feel free to change it to your liking. If you click on CANCEL in this case, you will be returned to the Tiny-Tafel data screen, so that you may make any changes you like. After you have selected a file, and clicked on OK, Origins will create your Tiny-Tafel and save it in your selected directory. Click on QUIT to exit from the Tiny-Tafel screen. <Goto Table of Contents>\TABLE_OF_CONTENTS\ <Goto Project Menu>\PROJECT_MENU\ <Goto Create Menu>\CREATE_MENU\ <Goto Update Menu>\UPDATE_MENU\ <Goto Glossary>\Glossary\ DISPLAY_MENU ~~~~~~~~~~~~ The Display Menu displays genealogical information on the screen in various formats including a pedigree, commonly referred to as a family tree. Along the bottom of the display window are seven gadgets. These gadgets function in a similar way throughout the display menu, although there are differences between the different functions. Selecting the PREVIOUS or NEXT gadget will generally take you to the previous and next record. The SPECIFY gadget will allow you to enter a record number or search for a person. The <PICTURE> gadget will\About_Pictures\ show a previously saved picture. The <SOURCES> gadget will display\Source_Documentation\ previously saved source documentation files. The <NOTES> gadget will\About_Notes\ display previously saved textual information. The QUIT gadget will exit the current function. Display_Person Displays data about a person in the same format as found in the <Update Person> item. If any search has been successfully completed\Update_Persons_File\ before selecting this function, that record will be displayed immediately. Selecting PREVIOUS or NEXT will display the previous or next Person record, if it exists. SPECIFY will allow you to enter a Person record number or search for a person. By clicking on the <SOURCES> gadget, it is possible to read previously\Source_Documentation\ saved source files for this person. Origins will look in the GenNotes: directory for a textfile named PERSOURCEnnnnnn.txt, where 'nnnnnn' is the Person's record number, e.g. PERSOURCE000026.txt. Because source files are displayed by the <hypertext engine>, it is\Hypertext_Engine\ possible for your notes to be created as <hypertext>. Please read\Creating_Hypertext\ that section for more information. By clicking on the <NOTES> gadget, it is possible to read previously\About_Notes\ saved notes about this person. Origins will look in the GenNotes: directory for a textfile named PERSnnnnnn.txt, where 'nnnnnn' is the Person's record number, e.g. PERS000026.txt. Because notes are displayed by the <hypertext engine>, it is possible for your notes to\Hypertext_Engine\ be created as <hypertext>. Please read that section for more\Creating_Hypertext\ information. By clicking on the <PICTURE> gadget, it is possible to show a\About_Pictures\ previously saved picture of this person. Origins will look in the GenIff: directory for an IFF file named PERSnnnnnn.iff, where 'nnnnnn' is the Person's record number, e.g. PERS000026.iff. When you are finished viewing the picture, press Escape to return to Display Person. Display_Ordinance Displays ordinance data about a person in the same format as found in the <Update Ordinance> item.\Update_Ordinance_File\ Selecting PREVIOUS or NEXT will display the previous or next Ordinance record, if it exists. SPECIFY will allow you to enter a Person record number or search for a person. Origins will automatically translate this into an Ordinance record number, if found. By clicking on the <NOTES> gadget, it is possible to read previously\About_Notes\ saved notes about this Baptism, Ordination, Confirmation, or whatever. Origins will look in the GenNotes: directory for a textfile named ORDnnnnnn.txt, where 'nnnnnn' is the Ordinance record number, e.g. ORD002755.txt. Because notes are displayed by the <hypertext engine>,\Hypertext_Engine\ it is possible for your notes to be created as <hypertext>. Please\Creating_Hypertext\ read that section for more information. By clicking on the <SOURCES> gadget, it is possible to read previously\Source_Documentation\ saved source files for this ordinance. Origins will look in the GenNotes: directory for a textfile named ORDSOURCEnnnnnn.txt, where 'nnnnnn' is the Ordinance record number, e.g. ORDSOURCE000026.txt. Because source files are displayed by the <hypertext engine>, it is\Creating_Hypertext\ possible for your notes to be created as <hypertext>. Please read\Hypertext_Engine\ that section for more information. By clicking on the <PICTURE> gadget, it is possible to show a\About_Pictures\ previously saved picture of this Baptism, Ordination, Confirmation, or something else entirely. Origins will look in the GenIff: directory for an IFF file named ORDnnnnnn.iff, where 'nnnnnn' is the Ordinance record number, e.g. ORD002755.iff. When you are finished viewing the picture, press Escape to return to Display Ordinance. Display_Marriage Displays data about a marriage in the same format as found in the <Update Marriage> item.\Update_Marriage_File\ Selecting PREVIOUS or NEXT will display the previous or next Marriage record, if it exists. SPECIFY will allow you to enter a Person record number or search for a person. Origins will automatically translate this into a Marriage record number, if found. If SEARCH is used to describe a Person, and if more than one marriage exists in the data base between the Person described and others, a requester will ask you to choose which marriage you are interested in editing. Click on the desired choice or ABORT. If the latter you will be returned to the number requester. By clicking on the <NOTES> gadget, it is possible to read previously\About_Notes\ saved notes about this wedding or other ceremony. Origins will look in the GenNotes: directory for a textfile named MARRnnnnnn.txt, where 'nnnnnn' is the Marriage record number, e.g. MARR000417.txt. Because notes are displayed by the <hypertext engine>, it is possible for your\Hypertext_Engine\ notes to be created as <hypertext>. Please read that section for more\Creating_Hypertext\ information. By clicking on the <SOURCES> gadget, it is possible to read previously\Source_Documentation\ saved source files for this marriage. Origins will look in the GenNotes: directory for a textfile named MARSOURCEnnnnnn.txt, where 'nnnnnn' is the Marriage record number, e.g. MARSOURCE000026.txt. Because source files are displayed by the <hypertext engine>, it is\Hypertext_Engine\ possible for your notes to be created as <hypertext>. Please read\Creating_Hypertext\ that section for more information. By clicking on the <PICTURE> gadget, it is possible to show a\About_Pictures\ previously saved picture of this wedding or other ceremony. Origins will look in the GenIff: directory for an IFFfile named MARRnnnnnn.iff, where 'nnnnnn' is the Marriage record number, e.g. MARR000417.iff. When you are finished viewing the picture, press Escape to return to Display Marriage. Display_Family_Group This item displays information about a family. You begin by selecting a Person, by either typing the Person's record number or clicking on the SEARCH gadget. This Person may then be defined as the Parent or the Child, by clicking on the appropriate gadget. If the SEARCH gadget was used to find a person, the Display Family Group requester will appear a second time and the Person record number (if the search was successful) will appear in the number gadget. You may now specify whether this person should be the Parent or Child, or enter a different number if you choose. At this point there are two possibilities: If there is only one family linked to the person you selected, Origins will attempt to display that family. On the other hand, if there is more than one possible family a requester will ask you to choose which family you are interested in having displayed. Click on your choice or ABORT. If you select ABORT, you will be returned to the number requester. Once your choice has been resolved to a single family, if the Person record is found, both parents, all the children common to both parents, and their birth dates are displayed. If a marriage is recorded in the data base, the marriage date and location is also displayed. Children are listed in birth order. If no birthdate has been entered, or is an invalid date, they are listed in the order in which they were entered in the Person file. For genealogical purposes within Origins, a family is defined as a Father, a Mother and their Children. If a person is selected, either by number or by search, that does not have described relationships to children, and to a partner in the data base, you will be informed that your desired record was not found. Clicking on the PREVIOUS gadget will display the previous generation of the current family group. You will be asked whether you want the parents of the Mother or the Father. After you have chosen, and if they meet the preceding criteria for Family Groups, a new Family Group will be displayed. Otherwise you will be informed that the record does not exist and given a chance to try again. Selecting the NEXT gadget will display the next generation of the current family group. If there is not more than one Child displayed, and if all Persons selected meet the preceding criteria for Family Groups, the Family Group will be shown immediately. If there is more than one Child displayed, you will be asked to choose which one you would like to be displayed as the new parent. After you have chosen, and if all Persons selected meet the preceding criteria for Family Groups, a new Family Group will be displayed. If Origins should report that your selected family does not exist after you have entered a Person number, or selected PREVIOUS or NEXT, be sure that the particular family selected does indeed consist of a mother, a father, and at least one child. By clicking on the <NOTES> gadget, it is possible to read previously\About_Notes\ saved notes about this Family Group. Origins will look in the GenNotes: directory for a textfile named FAMffffffmmmmmm.txt, where 'ffffff' is the Father's record number, and 'mmmmmm' is the Mother's record number in the Person file, e.g. FAM000137000286.txt. Because notes are displayed by the <hypertext engine>, it is possible for your\Hypertext_Engine\ notes to be created as <hypertext>. Please read that section for more\Creating_Hypertext\ information. By clicking on the <PICTURE> gadget, it is possible to show a\About_Pictures\ previously saved picture of this Family Group. Origins will look in the GenIff: directory for an IFF file named FAMffffffmmmmmm.iff, where 'ffffff' is the Father's record number, and 'mmmmmm' is the Mother's record number in the Person file, e.g. FAM000137000286.iff. When you are finished viewing the picture, press Escape to return to Display Family Group. Display_Pedigree Selecting this item brings up a requester asking you for the Person you desire to be at the root of the pedigree. You may either directly enter the number of a Person record, or you may enter information describing a Person by clicking on SEARCH. After entering a record number or description of a person, you will then be presented with a pedigree of that Person with up to four generations displayed. Persons in the pedigree chart have their position number prefixed in color 3, and their record number appended in color 1. Positions on the pedigree chart having blank records will not be displayed. For example, if your Maternal Grandfather has not been previously described, he will not be displayed on the pedigree chart, and neither will his ancestors, even if they have been previously described. See "About Pedigrees" in the manual. Once the pedigree chart is displayed, you may click on any of the names to display a new pedigree chart with that person at the root. A quiet beep will confirm that you have clicked on the selected name. If you click on the name in position 1, that Person's child will be displayed in the root position of the new pedigree chart. If that Person has several children, you will be asked to choose which one you would like displayed or ABORT. If you select ABORT, you will be returned to the previous display with no changes. If the Person has no children, a requester will inform you of this, and ask if you would like to choose someone else. Click on OK to do so. Unlike most of the other functions in Origins, clicking on CANCEL will not abort the function, but return you to the unchanged pedigree chart. In case you would like to see a pedigree of someone not on the current chart, clicking on SPECIFY will redisplay the number requester. Next to the SPECIFY gadget is the PICTURE gadget. Clicking on the PICTURE gadget will cause it to be highlighted. From now until you deselect it, anytime you click on a name, an IFF <picture> of the\About_Pictures\ person you clicked on will be shown, if one has been previously saved as a <PERSnnnnnn.iff> file. When you are finished viewing the\Display_Person\ picture, press Escape to return to Display Pedigree. The PICTURE gadget must be deselected for you to again move around the Pedigree chart. To exit this function, click on the QUIT gadget in the lower right corner. Display_Instructions ~~~~~~~~~~~~~~~~~~~~ Allows you to select parts of the <hypertext> help file to display.\Hypertext_Engine\ Things_to_Know ~~~~~~~~~~~~~~ Entering_Data All data entry in Origins is done through Intuition string gadgets. Always remember to press the RETURN key after entering data into a string gadget. This is the only way Origins has of knowing that you have entered or changed the data in the gadget. In some functions, this is very important so that you may be alerted if there is a problem with the way the data was entered. If you are using OS V2.0 or later, you may press the TAB key to cycle through the string gadgets in a forward direction, and Shift-TAB to cycle in a reverse direction. String gadgets may be edited in the normal way. You cannot delete records in Origins. This is really a philosophical issue. If, for some reason, you feel you absolutely must get rid of a record, you may enter some new data over the old, and you'll never know it was there. Make sure to update the indexes while you're at it. About_Dates Date string formats in Origins are fairly rigorous. Only two date formats are acceptable. Either the more commonly used, "dd mmm yyyy", or, for when you are unsure about the exact date of an event, "c.yyyy" (the 'c' stands for 'circa'). Valid example of absolute date: "03 Jan 1978" Not valid: "3 Jan 1978" Valid example of relative date: "c.1908" Not valid: "c1908" These formats are not case sensitive; "JAN" is the same as "jan" is the same as "jAn". All spaces in the 1st format are required. No spaces in the 2nd format are accepted, but both the 'c' and the period are required. Leading zeros are required on all numbers. No other characters are allowed in date strings. Valid representations for months are: JAN FEB MAR APR MAY JUN JUL AUG SEP OCT NOV DEC When date strings are compared in searches and sorts, blank and invalid strings always have highest priority. This is done so that the records containing them are not unintentionally lost. About_Searches Remember that you are always searching for the description of a Person. This is important because unsuccessful searches may happen because you are currently in the "Display Marriages" function, and that person either doesn't have a marriage recorded, or the marriage index is out of date, for example. If you enter no search criteria at all, you will always be presented with either the first active record in the data base, or the next active record, if there is one, and if the last search was successful. A blank or invalid date field in a Person record will match any date in the Search Requester date field. When finished entering search criteria, click on the OK gadget to begin the search. If successful, that record will be displayed. Otherwise, you may edit your criteria and try again. Clicking on the CANCEL gadget will exit in most functions. If the last search was successful, click on OK to begin the search at the beginning of the data base. Click on NEXT to begin the search at the record following the last successful search. Here are some tips on making searches work for you: First of all, don't think of the search criteria as being things that match a particular Person record -- think of them as being exclusionary. This means that the search criteria exclude records that don't match. It also means that a great number of records may be included. To make your searches faster, when looking for a particular record, always enter as many criteria as you know for sure. This will exclude as many records as possible. Don't enter criteria that you only suspect, because this may cause you to miss the record you wanted, and waste the time it takes for a complete data base search. If you are looking for a class of records, such as all the "Smiths", of course the above does not apply. Also see <Searches>.\Search_For\ Other_Features ~~~~~~~~~~~~~~ About_Pictures Pictures of each Person, Ordinance, Wedding, or Family Group may be shown when displaying records of these items. Origins will look in the GenIff: directory for an IFF file with one of these names. If found it will be immediately displayed. If it is not found, a requester will inform you of this, and ask you if you would like to see a different file. If you click on OK, you will be presented with the ARP file requester to choose a file to view. If you click on CANCEL you will be returned to the original function, e.g. Display Person. While the picture is displayed, and if the picture is larger than your screen size, you may scroll around in the picture by using the arrow keys. Alt-UpArrow will take you immediately to the top of the picture, and Alt-LeftArrow will take you immediately to the left edge of the picture. When you are finished viewing the picture, press Escape to return to the original function. About_Notes Notes about each Person, Ordinance, Wedding, or Family Group may be read when displaying records of these items. Origins will look in the GenNotes: directory for a textfile with one of these names. If found it will be immediately displayed. If it is not found, a requester will inform you of this, and ask you if you would like to see a different file. If you click on OK, you will be presented with the ARP file requester to choose a file. If you click on CANCEL you will be returned to the original function, e.g. Display Person. Source_Documentation In the normal course of assembling genealogical information, you may find it helpful to document your sources, both for your own use, and for the use of others who may be accessing the data that you have assembled. Origins will look in the GenNotes: directory for source files. Source files will be printed as part of a report on a Person. Source files may also be displayed by the hypertext engine from the Display Person, Display Marriage, and Display Ordinance functions. When the <Sources> option in User Preferences is enabled, specimen\User_Preferences\ source files will be saved for you automatically, if they don't already exist. If a source file exists, <Report Person's Data> will print it along\Person's_Data\ with the rest of the report. No formatting is done to this file -- it is printed exactly as you save it. Hypertext_Engine ~~~~~~~~~~~~~~~~ When you select any of the "Instruction" items from the menu, you see a window open and display this instruction file. The window is actually your portal to a small, simple, hypertext engine. Additionally, in many of Origins's functions you may use the Help-Key to get immediate online help about that subject. String gadgets "eat" the Help-Key, preventing Origins from knowing that it was pressed. So whenever a string gadget is active, and a cursor is displayed, it's necessary to click on an area of the screen where there are no string gadgets before the online help function will operate. This function is not active any time there is a requester displayed. The following keys and mouse actions control the hypertext engine: With the mouse pointer on the same line as a keyword enclosed in <angle brackets>, double click the left mouse button to immediately\Hypertext_Engine\ get more information on that subject. Up arrow gadget: Scroll 1 line towards the top of the file. Down arrow gadget: Scroll 1 line towards the bottom of the file. UpArrow key: Scroll 1 line towards the top of the file. DownArrow key: Scroll 1 line towards the bottom of the file. Shift-UpArrow key: Move 1 window towards the top of the file. Shift-DownArrow key: Move 1 window towards the bottom of the file. Alt-UpArrow key: Move to the top of the file. Alt-DownArrow key: Move to the bottom of the file. LeftArrow key: Return to previous location. The windows may be freely sized at any time. If the window is made too small, all the text on each line may not be visible, but will reappear when the window is made larger again. You may close the window at any time by clicking on the close gadget. Click here to return to <Getting Started>\Getting_Started\ Creating_Hypertext ~~~~~~~~~~~~~~~~~~ It is possible for your notes and other documentation to be created as hypertext. When adding hypertext links to your documents, here are some hints to help you be more effective. Hypertext links are made by enclosing a text string in backslashes like so: This is a line of text ... \\searchstring\\ The text string tells the hypertext engine what to look for. The backslashes identify it as a link. If the first character on a line is a letter of either case, all characters up to the first space will be rendered in color #3. The remaining text will be rendered in color #1. In order to make links clear, set out the word that contains the link from the remainder of the text: There is a link in this line. Can you <guess> which word it is?\Creating_Hypertext\ Make sure not to accidentally include the angle brackets, or whatever you use, in the text string itself unless they're really part of the string as it appears in the document. Note that the angle brackets do not constitute a link; they are there only for the benefit of the reader. <Goto Table of Contents>\TABLE_OF_CONTENTS\ <Goto Project Menu>\PROJECT_MENU\ <Goto Create Menu>\CREATE_MENU\ <Goto Update Menu>\UPDATE_MENU\ <Goto List Menu>\LIST_MENU\ <Goto Display Menu>\DISPLAY_MENU\ Glossary ~~~~~~~~ blank_record - A record in the data base cleared to nulls, except for the record number, which is negative. data_base - A collection of similar records about a specific subject. For example, the person file is a data base containing records about persons. field - An individual piece of information in a record, such as 'Surname' or 'Birth date'. given_names - What's left after you subtract the family name. For example, the given names of 'John Quincy Adams' are 'John Quincy'. indexing - A method of quickly finding a given record by multiplying the record number by the size of each record. An index file may have its entries in a different order than the file being indexed, for example, alphabetically. Instead of looking through the primary data base for the first name, and then looking through all the records for the second name, we take advantage of having a sorted index, and use it to tell us which record is next. link - A connection between records in different data bases, or posssibly in the same data base, that allows information to be cross- referenced. This also facilitates faster searches and displays. marriage_file - The file created and maintained by Origins to track information about weddings, such as date, location, etc. Each record in the marriage file is linked to the records of two persons. marriage_index - A small file that contains alphabetically sorted information about each marriage record: Marriage record number, Husband's Person record number, and Wife's Person record number. The use of a small index file obviates the need to read through the larger Marriage file when searching for a particular record. ordinance_file - The file created and maintained by Origins to track supplementary information about persons, such as baptism, confirmation and immigration dates, occupation, etc. Each record in the ordinance file is linked to a record of a person. parent/child_index - A small file that contains alphabetically sorted information about each Person in the data base: Father's record number, Mother's record number, and Child's record number. This last is the same as the Person's record number. The use of a small index file obviates the need to read through the larger Person file when searching for a particular record. person_file - The file created and maintained by Origins to track primary information about persons, such as name, parents, date & place of birth, etc. Other files used by Origins are all linked to this file. record - A collection of information in a data base that relates to one subject. For example, the person file is composed of a number of records, each about 1 person. surname - Your family name. For example, the surname of 'John Quincy Adams' is 'Adams'. You should generally enter the name someone was born with in this field. If your parents are Mr. & Mrs. Smith, and your mother was born with the name 'Alice Jones', you would generally enter 'Jones' in her personal record. ---------------------------------------------------------------------- Amiga, Workbench, and Preferences are trademarks of Commodore-Amiga, Inc. ---------------------------------------------------------------------- Every effort has been made to supply complete and accurate information. However, The Puzzle Factory assumes no responsibility for its use, nor for any infringements of patents or other rights of third parties which would result. Copyright⌐1992 The Puzzle Factory, Inc. World rights reserved. ----------------------------------------------------------------------