PEDIGREE Version 2.3 Ken Murphy 74025,731 INTRODUCTION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 WHAT PEDIGREE DOES . . . . . . . . . . . . . . . . . . . . . . . . . . 3 Features . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 General Functions and Processing . . . . . . . . . . . . . . . . . 4 Special Processing . . . . . . . . . . . . . . . . . . . . . . . . 6 SYSTEM REQUIREMENTS . . . . . . . . . . . . . . . . . . . . . . . . . . 7 INSTALLATION . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 The Program . . . . . . . . . . . . . . . . . . . . . . . . . . . 8 The Distribution File . . . . . . . . . . . . . . . . . . . . 8 The Program Files . . . . . . . . . . . . . . . . . . . . . . 8 After Installation . . . . . . . . . . . . . . . . . . . . . 9 The Epson-Compatible Printer . . . . . . . . . . . . . . . . . . . 9 GEDCOM DATA INPUT . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 General . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10 Dates . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13 GEDCOM 4.0 . . . . . . . . . . . . . . . . . . . . . . . . . 13 PAF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14 PEDIGREE's Date Processing . . . . . . . . . . . . . . . . . 14 USING "PEDIGREE" . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 Limitations . . . . . . . . . . . . . . . . . . . . . . . . . . . 15 The First Printer Test . . . . . . . . . . . . . . . . . . . . . . 15 Starting The Program . . . . . . . . . . . . . . . . . . . . . . . 16 The First Executions . . . . . . . . . . . . . . . . . . . . . . . 16 Choosing 4 or 5 Generation Charts . . . . . . . . . . . . . . . . 17 Why Choose 4 Generation Charts? . . . . . . . . . . . . . . . 17 Why Choose 5 Generation Charts? . . . . . . . . . . . . . . . 17 Screen Displays . . . . . . . . . . . . . . . . . . . . . . . . . 18 Banner . . . . . . . . . . . . . . . . . . . . . . . . . . . 18 Parameters . . . . . . . . . . . . . . . . . . . . . . . . . 18 Chart Printing Mode . . . . . . . . . . . . . . . . . . 18 Chart Style . . . . . . . . . . . . . . . . . . . . . . 19 Print Quality . . . . . . . . . . . . . . . . . . . . . 19 GEDCOM File Path . . . . . . . . . . . . . . . . . . . . 20 Personalized Name . . . . . . . . . . . . . . . . . . . 20 Upper Case? . . . . . . . . . . . . . . . . . . . . . . 21 Font Name . . . . . . . . . . . . . . . . . . . . . . . 21 Display Lines . . . . . . . . . . . . . . . . . . . . . 22 Print Age At Death? . . . . . . . . . . . . . . . . . . 22 Print Marriage Dates? . . . . . . . . . . . . . . . . . 23 1 Character Set . . . . . . . . . . . . . . . . . . . . . 23 GEDCOM File Loading . . . . . . . . . . . . . . . . . . . . . 24 Starting Person Selection . . . . . . . . . . . . . . . . . . 24 The Display . . . . . . . . . . . . . . . . . . . . . . 25 Moving Around the List . . . . . . . . . . . . . . . . . 25 Name Searching . . . . . . . . . . . . . . . . . . . . . 26 Printing The List . . . . . . . . . . . . . . . . . . . 26 The Pedigree Display . . . . . . . . . . . . . . . . . . . . 27 Printing The Pedigree . . . . . . . . . . . . . . . . . . . . 28 Errors . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28 Key Commands Summary . . . . . . . . . . . . . . . . . . . . . . . 30 Parameter Specification Screen . . . . . . . . . . . . . . . 30 Select Starting Person Screen . . . . . . . . . . . . . . . . 30 Pedigree Chart Screen . . . . . . . . . . . . . . . . . . . . 31 Other . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 REGISTERING PEDIGREE . . . . . . . . . . . . . . . . . . . . . . . . . 32 THE REGISTERED VERSION . . . . . . . . . . . . . . . . . . . . . . . . 33 PEDIGREE TECHNICAL SPECS . . . . . . . . . . . . . . . . . . . . . . . 34 USER SUPPORT . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 DISCLAIMER . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 FUTURE VERSIONS . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 REVISION HISTORY . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 EPSON BUILT-IN CHARACTER SETS . . . . . . . . . . . . . . . . . . . . . 37 REGISTRATION FORM . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 2 I. INTRODUCTION Development of this program grew out of my need to draw "presentable" pedigree charts that I could give to others. By "presentable" I mean something reasonably attractive and more than your basic genealogical database program can produce. Additionally, the charts had to be drawn using my 24-pin dot matrix LQ printer. After looking around for other software available, I discovered there was only one program that would make "display quality" pedigree charts on my printer, and it cost more than $60. Besides the cost, I would have had to re-input all my genealogical data into it's database. An alternative that some genealogists used was to employ a word processor and a laser printer to make pleasing pedigree charts in landscape mode. Again, that wasn't an acceptable alternative since all I had was my trusty 24-pin dot matrix printer. Where to turn ...? I wasn't after monk-drawn parchment stuff - just something I felt comfortable giving to my grandmother. Well, it seems as if I'd found an excuse to do some programming! Note: as you read this you'll notice all references to keyboard keys or keystroke sequences are enclosed within <>. For example, means to press the F1 key. The sequence means to hold down the key while pressing the key. Then let up the and keys and press the key by itself. Don't type the <>. Thank you for using PEDIGREE, and enjoy the program! II. WHAT PEDIGREE DOES PEDIGREE prints display-quality, 4 and 5 generation pedigree charts on an Epson LQ compatible 24 pin dot matrix printer at 180 dots-per-inch using standard GEDCOM data as input. The 4 generation charts have boxes for 15 individuals, and the 5 generation chart has boxes for 31 individuals. Each box contains names, birth and death dates and, optionally, the age at death. Marriage dates of parents can optionally be printed next to siblings. You can choose from 8 different pedigree chart designs. PEDIGREE can be also used as a GEDCOM "viewer" with or without printing. Use it's on-screen scrolling pedigree display to "view" a pedigree generated from a GEDCOM file. Or you can use PEDIGREE to print a list of individuals and families in a GEDCOM file without asking for a pedigree. You can also "mark" selected individuals in the list to print a standard column report from the list. A. Features The features noted with (R) are available only with the registered version. 3 ú Parameter screen - no command line parameters ú Automatically saved/reloaded parameters ú Standard GEDCOM format used for input data ú On-screen scrolling pedigree display ú Scrolling picklist to select the pedigree's starting person ú Name search within the starting person picklist (R) ú Graphics-based pedigree chart on an LQ dot matrix printer ú GEDCOM pedigree "viewer" ú Special printer fonts (supplied) for names & dates (R) ú "Personalized" pedigree chart with any name you choose (R) ú Selectable screen sizing for EGA and VGA displays (R) ú Option to force UPPER CASE when printing a chart (R) ú Context-sensitive help for parameters ú Help data for all screen displays ú 8 styles of printed pedigree charts (R) ú Age (in years) at time of death optionally printed (R) ú Marriage dates optionally printed (R) ú GEDCOM standard list report of "marked" or all individuals ú Selectable 13 Epson built-in international character sets ú Both 4 and 5 generation charts ú Single-sheet feed "pre-printed" chart option ú Options to control chart appearance quality ú Compressed chart image files to conserve disk space B. General Functions and Processing PEDIGREE's primary purpose is to print display-quality 4 and 5 generation pedigree charts on a 24-pin dot matrix printer. That's right, you don't need to cough up those $$ for a laser printer to get presentable pedigree charts. Nor do you need to custom build a chart with a word processor. With PEDIGREE, you can use your current genealogical database program to make a GEDCOM file, and PEDIGREE will print attractive pedigree charts using that GEDCOM file. Another useful purpose is to view and/or chart data in GEDCOM files given to you by another genealogist. PEDIGREE uses "industry standard" GEDCOM files as it's data input source. Yes, I know that the GEDCOM format isn't "standard" and it's still evolving, but it's the closest thing we genealogists have to a common denominator data format as I write this. Using GEDCOM as input means that this program will be usable by the widest possible genealogical data processing community. PEDIGREE allows you to select the specific 4 (or 5) generations to print using a "picklist" of the persons in the GEDCOM file and on-screen scrolling of the pedigree. You can "walk" the pedigree using the cursor control arrow keys. Using a picklist to scroll within the list of individuals is an essential feature if you have several family lines within the GEDCOM data. PEDIGREE can also be used as a GEDCOM data file "viewer" without printing. Suppose you've just received a new GEDCOM, and you want to 4 see what the pedigrees are like before you load it into your database? No problem. PEDIGREE will show you exactly what the GEDCOM data contains person-by-person and by ancestry. And PEDIGREE can be used as a simple GEDCOM lister. There's an option to print a standard column- type report from the GEDCOM list. These last features operate completely independent of any "pedigree" processing to display or print charts. You can optionally "mark" those individuals to be listed or you can print the entire list. PEDIGREE lets you select the style of printed chart. You can choose from 8 (yes ... eight) different styles of charts. Each style uses boxes to contain the individual's data. Both the border style and box style are different in each chart as is the text font. Pick the chart style that pleases you from among the 8 choices. PEDIGREE also provides a feature to print a blank pedigree chart. I found this useful for making blanks on which I (or my relatives) could write. Of course, once you've made the first blank, you could run off a bunch of copies on a copier just as easily. That's fine. A registered user is free to reproduce the chart as often as needed for personal use. Reproducing a blank chart originally printed on a dot matrix printer will often look better than the original because you can adjust the copier controls. This is a good technique when you want to use a chart you've enhanced through copying or pen-and-ink work. PEDIGREE has an option that will allow you to single-sheet feed these "Pre-printed" charts into your printer. Using this mode of charting, PEDIGREE will send only the pedigree data to the printer and not the chart graphics. PEDIGREE will expect, of course, that you've mounted one of it's own designs into the printer. As noted above, PEDIGREE will print a standard, column-oriented report that looks exactly like the on-screen picklist of individuals. That is, rather than printing a pedigree chart, you can print the list of individuals in standard report fashion. Additionally, PEDIGREE allows you to "mark" as many individuals (one or all) to be printed. Printing in list form is a good idea if you're dealing with a new or unknown GEDCOM file. You can examine the entire printed list at your leisure without the confines of a display screen. After you've reviewed the standard report, you can return to the computer to do your "chart" work. PEDIGREE also provides access to the Epson printer's built-in international character sets. An Epson 850/950/1050 has 14 built-in international character sets. PEDIGREE allows you to select which character set you want the printer to use. PEDIGREE allows selection of 13 of the built-in 14 international sets. PEDIGREE has an option to "emphasize" a printed result. It does this through micro vertical positioning of the paper and reprinting. Although an "emphasized" chart takes twice as long to print, it very often has a marked improvement in appearance. PEDIGREE also permits a "draft" printing of a pedigree chart by not using the appearance 5 improvement options to speed printing. As you can see, PEDIGREE provides a wealth of options for you to customize the pedigree chart. You have control over almost all aspects of print style and content. C. Special Processing PEDIGREE has several routines designed to "clean up" GEDCOM data to make it as presentable as possible. PEDIGREE removes all leading and trailing spaces and any consecutive spaces from every GEDCOM data element. For example, if the GEDCOM data string " ABT 1654 " is input, PEDIGREE will reduce it to "ABT 1654". If PEDIGREE senses a date in the format YYYYMMDD, it will convert it to MMM DD YYYY. For example, "18320423" will display and print as "Apr 23 1832". Names in GEDCOM can be very long. They often include titles, middle names, and so forth. Names are treated by PEDIGREE in the following manner when preparing charts and displays. PEDIGREE attempts first to build a name in the format "LAST NAME, ALL FIRST NAMES". If that cannot be contained within the space allotted to a chart box, PEDIGREE attempts to remove all but the "first" first name to build the field "LAST NAME, FIRST NAME". If that cannot be contained within a chart box, PEDIGREE will resort to "LAST NAME, FIRST-NAME-INITIAL". If that can't be contained (one heck of a last name!), PEDIGREE truncates the last name to fit (about 28 characters). D. The Charts There are 8 different chart designs available in the registered version. Each of them uses boxes to "contain" the data for each individual. The boxes are connected with lines to show familial relationship. Some chart designs use shaded boxes, and others use unshaded boxes. Some chart styles use straight line boxes while others used "plaque" style boxes. The border is different on each chart as is the text font for "preprinted" words. Above the central person's box is the word "FATHER", and below it is the word "MOTHER". In every case, the Father's box appears above the sibling while the Mother's box appears below. Each chart has a border around the perimeter of the page, and it's different for each chart. At the top of the chart is the word "PEDIGREE" in large letters. On 3 charts, the title "PEDIGREE" appears in the middle of the top border. On one chart it appears in the upper left corner of the page, and the top border is unbroken. In the bottom left corner of the page is a graphic of a tree. To the right of that are two lines (one over the other) containing "Family 6 Tree" and "Prepared For:". 7 of the chart designs are 4-generation and the last is a 5-generation chart. Because of the limited space on a 5 generation chart, the lettering is done only in pitch 15 characters. I suggest you print each chart design in the BLANK chart mode so that you'll have a permanent reference. III. SYSTEM REQUIREMENTS You'll need an IBM PC, XT, AT or compatible MS-DOS computer with 512K bytes minimum of main storage to run this program. 640K of memory is strongly recommended. 512K severely restricts the amount of GEDCOM data PEDIGREE can process. PEDIGREE's need for main memory increases as the number of individuals in the GEDCOM input increases. PEDIGREE has successfully processed a GEDCOM file with 4500 individuals and 1200 families using a computer with 618K free main memory and 130K free Upper Memory Blocks. Using a memory manager such as QEMM to load processors into the high (above 640K) RAM frees RAM below 640K. PEDIGREE uses main RAM to store an individual's data. The more individuals in your GEDCOM file, the more main memory PEDIGREE will need. PEDIGREE runs fine with MS-DOS version 3.1 or 5.0. It also runs as a DOS application in Windows 3.1. You'll also need an Epson-compatible 24-pin dot matrix printer of the LQ persuasion (that's what this is all about, right?). The printer you use MUST be fully Epson LQ compatible. If you're going to print a pedigree chart rather than just view it on-screen, you'll get much better results if your printer ribbon is fresh. Secondly, your chart will look much better if your printer handles single sheets and you can use colored paper of heavy stock. I've had good success with an ivory or light beige colored paper. Minimally, you'll need a CGA-compatible color monitor. PEDIGREE looks best when you've got an EGA monitor or better. I've designed PEDIGREE to use EGA colors, but it'll work on a CGA. You do not need memory above 1 MB such as EMS or XMS. The unregistered version of PEDIGREE will run from a floppy disk. Both versions run dramatically better if you install to a hard drive. Trust me on this one. The registered version of PEDIGREE requires installation on a hard disk due to the space requirements of the 8 pedigree chart styles. PEDIGREE, in it's executable form, needs 1.8 MB of disk space for the registered version and 450 KB for the unregistered version. To install the registered version on a hard disk you need 2 MB. After the installation you will delete several of the files from your hard drive which PEDIGREE does not require to run. That will reduce PEDIGREE's needs 7 to 1.8 MB. You'll need 1 MB to install the unregistered version. Again, you can delete several files after installation. IV. INSTALLATION A. The Program 1. The Distribution File PEDIGREE comes to you as a single .ZIP file. It can be unpacked by any of several programs available through CompuServe and other sources that unpack the ZIP format. Central Point's PCTOOLS v8.0, for example, can unpack a ZIP file. PKUNZIP is another popular program that will "unZIP". Before you do anything else, make a backup copy of the distribution file PEDGRE.ZIP. Put the original safely away. Now you're ready to proceed with the installation using the copy. There's nothing unusual to installing the program ... simply copy the PEDGRE.ZIP file you received onto your working disk in the subdirectory where you want PEDIGREE to live. Then use one of "unzipper" programs such as "PKUNZIP" to unpack it. As it's filename extension implies, the distribution file is a ZIP format and will not execute by itself. Assuming the PEDIGREE distribution disk copy is in the A: drive and you're installing to your C: hard drive, type the following from the DOS prompt: C: . make C: the active drive CD \ . make sure we're at the root directory MKDIR PEDIGREE . make new directory PEDIGREE CD PEDIGREE . switch to the new directory COPY A:\PEDGRE.ZIP . copy the distribution file into it PKUNZIP PEDGRE . execute and unpack distribution file Don't type anything beyond this point 2. The Program Files After unzipping, PEDIGREE expands into the following files: a. PEDIGREE.EXE (the executable program) b. PEDIGREx.CHT files (the pedigree chart graphic images) c. PEDIGREE.TXT (what you're reading - the DOC in ASCII text) d. PEDIGREE.DOC (same as above but in WordPerfect 5.1 format) e. Various .LQC files for optional printer fonts f. A READ.ME file. The READ.ME file contains late-breaking or version-specific info about the program that wasn't included in this document. g. A TSTFONTS.BAT file. Execute this to test the special fonts on 8 your printer. h. A TESTONE.BAT file. TSTFONTS.BAT uses this. There's no reason for you to mess with this. i. A FONTTEST.TXT file. Sample text to be used for testing each of the special fonts. 3. After Installation PEDIGREE is now installed on your hard drive along with it's supporting files and documentation. First, print or display the READ.ME file. Next, you'll need to review the program documentation. You can either COPY the PEDIGREE.TXT file to your printer or you can use WordPerfect 5.1 to print the PEDIGREE.DOC file. Using WordPerfect to print the document gets you special graphics and illustration characters not possible in the ASCII .TXT version. It's now safe to remove some of files from your hard disk which PEDIGREE does not need to execute. Once again, make active the directory where PEDIGREE lives, and type in the following DOS commands: ERASE PEDGRE.ZIP ERASE READ.ME ERASE PEDIGREE.TXT ERASE PEDIGREE.DOC The first "ERASE" command removes the original PEDIGREE distribution file. It's not needed to run the program so save the disk space. Besides, you've made a backup of it, right? Later on you'll be able to erase a few more small files. PEDIGREE requires you have the .EXE and .CHT files. The .LQC files are required if you intend to use one of the special fonts. After you've expanded the distribution file you can run any virus scanner with which you're comfortable. No, there are no viruses lurking in my software, but, if you're cautious like me, you're well advised to be "safe rather than sorry". I can guarantee the files as I distribute them, but not those you received from sources other than myself or CompuServe. You do not need to alter your CONFIG.SYS file. You do need to make sure that all of the files generated by unpacking PEDGRE.ZIP are in the same directory. The unzipper program will have put them all in one place. B. The Epson-Compatible Printer The only consideration for using PEDIGREE with your Epson LQ-compatible printer is to assure that any DIP switches are set properly. This generally means leaving them at (or returning them to) the factory defaults. The important settings are: 9 Skip Over Perforation - OFF Auto Line Feed - OFF Character Table - Epson Graphics International Character Set - USA DIP switch settings shouldn't bother PEDIGREE because it sets the printer modes with software commands. I don't recommend that you mess with them unless PEDIGREE has a problem with the printer. The Epson 24-pin printers have a DIP switch setting for selecting an international character set. Your printer can be configured for any character set with the DIP switch, but PEDIGREE software selects whatever international character set you select on the parameter entry screen. That selection remains in effect only until PEDIGREE finishes. Another DIP switch setting chooses between the italics or the Epson Extended Graphics character table. PEDIGREE employs the Epson Extended Graphics character table, and, again, it's software selected. Your Epson LQ-compatible printer must be capable of the following: ú triple-density (180 Dots-per-Inch) printing ú n/180 inch vertical positioning ú Downloadable user fonts (R) ú Switchable between ROM and RAM fonts (R) ú Selectable absolute horizontal print head positioning ú Selectable character tables Note: Some "Epson compatible" printers, while correctly interpreting the Epson printer command codes, do not print on the same page area as a true Epson. Some Panasonics, for example, have a larger non-printable white space margin at the top and bottom of a page. The Epson LQ-850 has a top margin of .33" and a bottom margin of .53" for continuous feed paper. A Panasonic KX-P1123, on the other hand, has top margin of .7" and a bottom margin of 1.0" for continuous fan-fold paper. That means, for the Panasonic, there's more paper that can't be reached than the Epson. Secondly, the margin limits for some printers using single sheets are different than if using continuous feed paper. I've tried to create pedigree chart designs which fit within margin limits of "Epson compatible" printers known to me. If you see charts spilling over onto a second page, you may have one of those printers. Just thought you oughta' know. V. GEDCOM DATA INPUT A. General I've come across quite a few really bizarre "GEDCOM" files out there, and I haven't a clue what software could have made such messes. PEDIGREE has a reasonable amount of "self protectiveness" built in to 10 protect it from some of the more obtuse "GEDCOM" formats. A word of caution ... make sure your GEDCOM input is in good shape. A mangled GEDCOM file will surely bring PEDIGREE to it's bit-mapped knees. The GEDCOM Format supported by PEDIGREE is documented in "The GEDCOM Standard Release 4.0 August 1989" and "Personal Ancestral File, GEDCOM Specifications January 1990" prepared for the Family History Department (by the Projects and Planning Division) of the Church of Jesus Christ of Latter-day Saints. I've seen documents that refer to "GEDCOM 2.0" or "GEDCOM 2.1". As near as I can figure, those specs are the release version of "Personal Ancestral File" which is a genealogical database program developed by the LDS Church. The GEDCOM specifications differ slightly between those two "standards" as is explained later in the section on Dates. The GEDCOM specification employs many different keyword-specific data lines. In GEDCOM terminology they're "tags". The GEDCOM specification documents over 600 tags. PEDIGREE uses only a small subset of them - 9 ... count 'em ... 9. It won't bother PEDIGREE in the least if even the most arcane GEDCOM tag appears in the input file. The first "field" in every GEDCOM record is a "level" number. Level numbers define the hierarchy of the GEDCOM records. Therefore, you cannot move GEDCOM records around in the file. They must remain in position relative to the records around them. The keywords that PEDIGREE uses are: INDI (Individual) NAME (Individual's name) BIRT (date of birth) DEAT (date of death) FAMC (family number in which person is a child) FAMS (family number in which person is a spouse) FAM (Family number identification) MARR (Marriage information) DATE (Various dates) Not all these keywords are required. The INDI, NAME, FAM, FAMC and FAMS keywords are the bread-and-butter data that make pedigrees. Other than those tags, PEDIGREE expects the first record in the GEDCOM file to be a level 0 record with the keyword "HEAD". It also anticipates a last record with a keyword of "TRLR" or "EOF". PEDIGREE "looks" at a GEDCOM file as a two part data stream consisting of "Individual" and "Family" data. Every individual in the file has a GEDCOM number. So does every family. The number is assigned by the program that made the GEDCOM file, and it usually starts with 1. That is, the first individual in the file will be GEDCOM #1, the 2nd GEDCOM #2 and so on. The same numbering applies to families in the GEDCOM file, i.e., the 11 first family is GEDCOM #1, etc. Individuals are "tied" to their offspring and ancestral families by having the numbers of those families included with the individual's data. That's how I can collect all the individuals for any given ancestral family. PEDIGREE does not require that the first individual be GEDCOM #1. Nor does it require that the first family be GEDCOM #1. In fact, PEDIGREE doesn't care a whit what the numbers of the individuals and families are - as long as they do have GEDCOM numbers, and the numbering is consistent. What does it all mean, Ken? Well, you might decide to use your favorite text editor to edit out some of the folks in the file to make things more manageable. That's OK. You can edit the file any way you like. But be warned! Do not alter the GEDCOM formats or the GEDCOM numbers or the relative position of GEDCOM records. If you want to mercilessly block-delete groups of families, go right ahead. Is that going to bother PEDIGREE? Nope. If, for example, PEDIGREE looks for the father of an individual by trying to locate that individual's family and it can't find the family with the correct number, it will let you know on it's on-screen pedigree chart display by showing "Not Available" where the name would normally appear. The GEDCOM standard provides for several character sets for data, i.e. 8 bit ANSEL, ASCII (USA version) and "other" character sets for future use. ANSEL is the "American National Standard for Extended Latin Alphabet Code Character Set for Bibliographic Use", and it's the default character set of GEDCOM. It is the only character set that will handle a wide variety of diacritics and special characters for Romanized languages. ANSEL preserves the full integrity of original Roman-alphabetic languages, including diacritics and special characters. PEDIGREE employs the USA Character Set and The Epson Extended Graphics character table. That includes many of the diacritical characters so you can use them freely within the ASCII data. You do, however, have access, via a parameter, to any one of 13 built-in foreign language character sets if your GEDCOM employs those codes. These character sets are built into the printer - not the PEDIGREE software. 12 Just to reinforce how the GEDCOM numbering scheme works, consider the following diagram. Individual #34:---> Ancestral Family #5 ³ ³ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Family #5:----> Father #23; Mother #24 ³ ³ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄFATHERÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄ´ ³ Individual #23:---> Ancestral Fam #8 ³ Father's family ³ ³ ÚÄÄÄÄÄÄÄÄÄÄÄÄÄÄMOTHERÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÄÙ Individual #24:---> Ancestral Fam #12 Mother's family B. Dates 1. GEDCOM 4.0 The 4.0 GEDCOM standard distinguishes between regular and irregular dates. Regular dates are defined to be bona fide dates from the conventional Gregorian calendar. The following are correctly formatted regular dates: 29 FEB 1960 10 JAN 1802 JUN 1714 1932 7 DEC 1942 Notice that a regular date may have a day and a month, but it will always have a year. If a day and/or month are present, they are presented in the same order all the time, i.e. day followed by month followed by year. The month is always the 3-character abbreviation for the name of the month. GEDCOM also permits the use of irregular dates which differ in form and/or content from the regular dates. Examples of irregular dates are: MDCCCXV Abt. 1850 5 June (year missing) 7-12-84 Before 3 Mar 1913 PEDIGREE does not process irregular dates when calculating age at death or at any other time. An irregular date will be display "as- 13 is", but PEDIGREE will make no attempt to "clean up" or standardize irregular dates. 2. PAF Dates are either standard or "dual year". In addition, an ABOUT, BEFORE or AFTER designation may be appended to a formatted date. In some cases a special code word may be put into a date field in place of an actual date. Standard dates are recorded as YYYYMMDD where YYYY is the year, MM is the month and DD is the day of the month. Years prior to 1000 AD (ACE) and days less than 10 must include a leading zero. Dates prior to 0 AD cannot be recorded with this format. If parts of the date are unknown, the unknown portions are indicated with zeroes. Examples of standard dates are: 19830416 18450500 (day is unknown) 17140000 (month and day are unknown) ABOUT, BEFORE and AFTER dates are indicated by appending an "A", "B" or "F" respectively. E.G. 19380700A 3. PEDIGREE's Date Processing For regular dates, PEDIGREE attempts to convert both GEDCOM 4.0 and PAF forms of dates to an internal form. PEDIGREE will remove extra spaces and otherwise "clean up" a date. PEDIGREE needs a standard internal form in order to calculate the age at death if you elect that option. For the age-at-death option, valid dates must fall between 1/1/1600 and 12/31/3999. PEDIGREE's internal date calculations are done using a date form called "Julian". The term "Julian date" means different things to different people. Among astronomers and historians, it has a very precise and technical meaning. At the present, PEDIGREE does not work with "true" Julian dates. A much broader definition is used for internal calculation with PEDIGREE which infers that a Julian date is "a date stored as an integer value representing the serial number of days from 1/1/1600". The age at death is printed on the pedigree chart to the right of the birth/death dates between parenthesis, e.g. "(74)". As noted, a regular date may have only a year (or only a month and year). If either the day of the month or the month are absent, PEDIGREE replaces them with "01" and "JAN" respectively. This is done only for age-at-death calculations. Therefore, a birth date of "1782" will be assumed to be "1 JAN 1782" for the purposes of calculating the age at death. A date of "ROUGHLY 1875" will be assumed to be "1 JAN 1875". 14 PEDIGREE can process all PAF-type forms of standard dates except dual-year. As per irregular dates in the GEDCOM 4.0 standard, PAF permits many forms of irregular dates none of which receive any special attention from PEDIGREE. VI. USING "PEDIGREE" A. Limitations The unregistered version of PEDIGREE is limited to 400 individuals and 100 families from your GEDCOM input. If your GEDCOM input exceeds those limits, PEDIGREE will display an appropriate error message and keep going. In other words, if you tell the unregistered version to read a GEDCOM file with 550 individuals, PEDIGREE will accept the first 400, display an error message that you've exceeded the limit and then ignore all remaining individuals in the input file. But it keeps on chugging so you can use whatever was loaded. The registered version permits more than 10 times as many families and individuals, and, generally, is limited only by the amount of memory it can use. That works out to roughly 5000 individuals and 1500 families within one GEDCOM file on a 640K computer with most of the memory available. B. The First Printer Test The first thing you should do is test your printer for compatibility with PEDIGREE. If you have an Epson LQ-850/950/1050 there's no need. Executing the TSTFONTS.BAT file from the DOS prompt will send all the test fonts and some text to your printer. Each font, in turn, will be downloaded to your printer followed by test text. The screen displays a message as each font is sent to the printer. Just follow the on-screen instructions to run TSTFONTS.BAT. If the test succeeds, the printer will print every test and stop. You can then examine the printed result. I recommend you keep the test printout. It's a good example of the appearance of each font, and you'll be able to refer to it later when you want to print a pedigree chart. Store the test results with the program's documentation. You can now proceed to the printing a blank pedigree chart. Printing a chart is even more demanding on the printer than this font test. The test may fail in one of several ways. If the printer is not completely Epson LQ compatible then failure, most likely, will be the printer's refusal to print accompanied by some sign of objection from the printer such as a warning light or "beep". Secondly, the printed result may be garbled. If you don't get a successful printer test result and you're sure your printer is Epson compatible, PEDIGREE will still be useable - just avoid using the special fonts. After running the printer test you can delete the following files: 15 TSTFONTS.BAT FONTTEST.TXT TSTONE.BAT C. Starting The Program Assuming you installed PEDIGREE on your "C:" hard drive in the path "\PEDIGREE", PEDIGREE is started by doing the following: 1. From the DOS prompt make the drive where you installed PEDIGREE the active drive. 2. Next, make the subdirectory in which you installed PEDIGREE the active one by entering a "CHANGE DIRECTORY" command. 3. Start PEDIGREE Here's an example of the DOS commands: C: CD \PEDIGREE PEDIGREE D. The First Executions I recommend that you run PEDIGREE in the "BLANK" chart mode the first time. Then you'll know right away whether or not your printer and PEDIGREE are a happy marriage. Printing a chart exercises the printer even more than the TSTFONTS.BAT file. If the printer is compatible, you'll end up with a printed copy of the pedigree chart that you can examine. Also, the "BLANK" chart mode requires no GEDCOM input so you needn't worry about that right now. If the chart prints OK I recommend that you store it with the other PEDIGREE documentation. You'll want to print and save each chart style at least once so you can refer to those illustrations later when selecting a style for a real chart. Make sure your printer is ready, and then start PEDIGREE. Use the "" key to change the chart mode to "BLANK". Then key in . PEDIGREE will attempt to print a blank chart using the default chart style. For the second execution you'll need a GEDCOM file. Find one on your disk. If you don't have one, use your genealogical database program to make one. Write down it's complete disk\path\filename, and then start PEDIGREE. If the chart mode is not "STANDARD", press the bar until it is. Then press the key to accept it. The cursor is now in the CHART STYLE field. Press to accept the default. The cursor is now in the GEDCOM file name field. Enter the complete disk\path\filename of your GEDCOM file. Then key in . PEDIGREE will make sure that the file path is correct and that the file is indeed 16 a GEDCOM. Lastly, key in to accept all parameter screen data. PEDIGREE now proceeds to the loading of the GEDCOM data. After loading, you'll see a window with a list of the names and dates from the GEDCOM file. Use the up and down arrow keys and the and keys to scroll through the list. When the highlight bar is over a person with a father and mother number, press . The pedigree of that person will be displayed. Use the cursor arrows to scroll the PEDIGREE to the father, back to the child and then to the mother. See how the entire pedigree changes? If you attempt to scroll the pedigree to a person with no ancestors, PEDIGREE will "beep". OK, now press . You're back at the window with the list of names. Press . You'll see a check mark appear to the left of the person under the cursor. You've just "marked" a person. Move the highlight cursor bar to another person and press again. That person is now also "Marked". Key in . All the check marks disappear. Press , and PEDIGREE returns to the original parameter screen. Press again and PEDIGREE execution ends. E. Choosing 4 or 5 Generation Charts 1. Why Choose 4 Generation Charts? 4 generation charts allow use of some of PEDIGREE's options not available with a 5 generation chart. First, a 4 generation chart can use the customized fonts feature. The "Customized Fonts" feature is not available with the 5 generation chart. This is due mostly to the very tight printing requirements of a 5 generation chart. A 5 generation chart uses pitch 15 Roman print characters. That could be too small to easily read. If you need the larger lettering, select a 4 generation chart. Also, 4 generation charts have larger boxes and bolder lines and, as such, may be easier to read. There are 7 styles of 4 generation charts, but only one 5 generation chart. Electing a 4 generation chart style gives you more choices of box type and border style. To summarize, use 4 generation charts if: a. You don't have a 5th generation to print b. You don't want the recipient to see the 5th generation c. You want the larger type styles d. You want control over chart box and border style e. You want to use a custom type font 2. Why Choose 5 Generation Charts? Obviously, the 5 generation chart displays twice as many individuals as the 4 generation chart. There's room for 31 people on the 5 17 generation chart versus 15 people on the 4 generation chart. This feature will be sufficiently important for most people to opt for the 5 generation chart. As noted above, however, you give up the ability to control the size and style of print characters as well as the overall chart design. A 5 generation chart uses only the printer's built-in pitch 15 Roman characters. You still have control over the capitalization of the lettering and the use of international fonts, however. F. Screen Displays 1. Banner The first display you'll see is the PEDIGREE banner screen. It identifies the program by name and version. If you have the registered version, you'll see your name at the bottom of the screen. If you have the unregistered version, you'll see a blinking reminder to register. While you're digesting all this, PEDIGREE "doodles" a little on the screen. 2. Parameters PEDIGREE next displays a screen containing the parameter window with a two-part help window at screen bottom. The help at the screen bottom is divided into two sections by a horizontal line. The top section is used for error messages related to parameters which you enter. It's also used for helpful prompts for each field in the parameter window. The bottom section displays keyboard key meanings used within the parameter window. The parameter window has fields for the following parameters: a. Chart Printing Mode The choices are "STANDARD", "BLANK" and "PREPRINT". You scroll through the choices by using the "+", "-" or keys. "STANDARD" is the default mode of PEDIGREE. In this mode PEDIGREE will print a pedigree chart using GEDCOM data which you select. It will merge the pedigree's individual data with the graphic chart image. You also use STANDARD mode if you're using PEDIGREE as a GEDCOM viewer (printing is not mandatory). "BLANK" means no GEDCOM input; just print a blank chart. PEDIGREE will simply print whatever chart style you choose with no individual data on the chart. "PREPRINT" means that you're going to manually insert into the printer a preprinted chart design. The Epson 850/950/1050 printers (as well as most compatible) have a single sheet feed option. In the PREPRINT mode PEDIGREE will send only the pedigree's individual data and not the graphic chart image. This 18 option is useful for using charts which you've manually enhanced using a copier or pen-and-ink. In the PREPRINT mode, PEDIGREE will provide appropriate paper-load messages and warnings. One caveat using the PREPRINT mode - the single sheet must be inserted into the printer's feed path precisely. If you misalign the paper even slightly, PEDIGREE's resultant chart will not please you. For this reason use PREPRINT with caution and only after you've experimented with it and your printer. b. Chart Style There are 8 chart styles. They're called: "SHADED", "PLAIN", "VENICE", "MODERN", "PLAQ1", "PLAQ2", "ORNATE" and "GENER5". You scroll through the picklist of choices using the arrow keys. A "SHADED" pedigree chart uses shading on the bottom and rear edge of each box on the chart. A "Plain" chart is simple boxes with no shading. A "VENICE" chart uses is so named for the style of lettering used on the chart. Also, it has an ornate border completely around the boxes. The box style on "VENICE" is unshaded. A "MODERN" chart also uses boxes, but the border is an elaborate intertwined design, and text fonts are different. The last 3 4-generation styles use plaque style boxes both plain and shaded. GENER5 is a 5 generation chart with mild box shading at the left and bottom of each box. The multiple chart style feature is available only in the registered version. The unregistered version permits use of SHADED and GENER5. c. Print Quality The Print Quality option gives you control over two aspects of chart printing, i.e. whether PEDIGREE uses Unidirectional printing and whether it uses Emphasized printing. Emphasized printing is a technique which prints the same data twice to emphasize (or make bold) the printing. The second pass at printing is done with the paper moved vertically 1/180th of an inch. This is often called "double strike" printing. Emphasized printing, although taking twice as long as non-emphasized printing, can produce a substantial improvement in the appearance of a chart. This is especially true if your ribbon is not in the best shape or if your printer is showing signs of age in head positioning. Emphasized printing will affect all printing both graphics and text. Emphasized printing is a useful option if you intend to make a "boilerplate" prototype chart to be reproduced on a copier. Unidirectional printing improves the printer's ability to position 19 the print head. Unidirectional printing always starts the print head from the left edge of the paper. Bidirectional printing prints both left-to-right and right-to-left. Bidirectional printing is faster than unidirectional printing because the printer does not need to return the print head to the left. Unidirectional printing, on the other hand, can produce a higher quality appearing output since the print head positioning is more precise. Selection of either Emphasized or Unidirectional printing should be made based on the condition of your printer ribbon, the general condition of your printer, and your need for highest quality output. The parameter values for this field are: EU - Emphasized and Unidirectional printing both enabled. EB - Emphasized printing using Bidirectional positioning. NU - Normal (non-emphasized) printing in Unidirectional. NB - Normal printing using bidirectional positioning. The EU quality mode can be considered as the highest "letter quality" mode. The NB mode can be considered as a "draft" mode. You'll need to experiment with your printer to determine which quality mode produces the output that pleases you. If bidirectional printing produces a good looking chart, use it - it will certainly be faster than unidirectional printing. The same is true for emphasized printing, i.e. if you're satisfied with non-emphasized chart printing, there's no point to wasting the extra time for an emphasized chart. In any case, you have complete control of the quality vs. speed tradeoff. d. GEDCOM File Path Type in the full drive\path\filename of the GEDCOM file. If you've selected the chart print mode "BLANK", leave this field empty. PEDIGREE forces all characters in the GEDCOM file name to upper case. If you've already run PEDIGREE at least once, PEDIGREE displays the file path you previously entered. The field contents can be overwritten or edited. If you enter any ASCII character in position 1, PEDIGREE assumes you're replacing the entire path and it will automatically erase the field contents to accept the new path name value. If you've selected a Chart Mode other than BLANK, this field is required. If you've selected a BLANK Chart Mode, this field must be left empty. e. Personalized Name You can enter anything you like. Whatever you enter here will be 20 printed on the pedigree chart alongside the words "Prepared For:". You can create charts for relatives and enter the name of the relative in this field. PEDIGREE automatically capitalizes the first letter of each word. If you type in "ken murphy", PEDIGREE changes it to "Ken Murphy". If you must have a lower case letter starting a word as in the second word of "Grandmom and Grandpop", type in "Grandmomand Grandpop". Then use the cursor arrow key to move the cursor back under the "a". Then, press the bar to insert a space in front of the "and". PEDIGREE will leave the "a" in lower case. The name (or whatever you entered) will be printed using whatever font or international character set you've selected. If you've run PEDIGREE at least once before, it displays the previous value for a personalized name. You can accept or edit this value. If you type in any ASCII character in position 1 of the field, PEDIGREE assumes you're replacing the entire field contents and it will automatically erase the old field contents. The personalized chart feature is, of course, an optional field. It's available only in the registered version. f. Upper Case? This field accepts only "Y" or "N". "Y" means to force all names and dates displayed or printed into upper case. "N" means leave them as input. The default is "N". This feature is only available in the registered version. g. Font Name When you move into this field, another picklist window opens with the names of alternate LQ fonts to use for printing. Highlight the font you want by moving the cursor bar with the < > and < > keys. Register your selection by pressing . To use no special fonts, select the entry "-NONE-". "None" is the default. In this mode PEDIGREE will use letter-quality Roman pitch 12. Custom Fonts are: BOLDTYPE EMERALD CROWN ROMAN GOTHIC OPAL PEARL FRANKFUR RUBY SAPPHIRE The names of these fonts are probably meaningless. Use the test program supplied with PEDIGREE to print them. That's the surest way to see how they'll look on your printer. Note: Use of an international character set and a special font is 21 mutually exclusive. If you select a special font (your selection is not "-NONE-", you can not use a built-in international character set. Customs fonts are available only with the registered version. h. Display Lines VGA display adapters can display 50 lines of text on one screen. EGA display adapters can display up to 43 lines of text. CGA color display adapters are limited to 25 lines of text. PEDIGREE permits selecting the number of display lines irregardless of your display adapter type. I.E., if you have a VGA display, you can run PEDIGREE in the 25-line display mode or the 43-line display mode. This setting effects only the Starting Person selection screen. Displaying 50 lines at one time on a VGA means that the Starting Person selection window can show you many more persons at one time than on a 25-line display. But (and it's a big "but"), the 50 line display can be harder to read because all the text is smaller. With this parameter you can pick the display size you prefer. You cannot, of course, select 43 or 50 line display for a CGA monitor nor can you select a 50 line display for an EGA monitor. The parameter accepts one of the values 25, 43 or 50. To change the value you must whatever is shown and then type in your new value. This feature is available only in the registered version. i. Print Age At Death? This "yes/no" option accepts the single character "Y" or "N". "Yes" will enable PEDIGREE's calculation of the age at death of each individual. That age will be displayed on the Starting Person Selection screen along with birth/death dates. It will also be printed on the pedigree chart. A prerequisite to the ability to calculate the age in years at death is a birth date and a death date in regular form as described earlier. Any deviation from a regular date in either birth or death will result in no age-at-death display. Note: PEDIGREE will always calculate (if possible) the age at death and display it on the Starting Person Selection screen. This option is used only to control whether or not it's printed on the pedigree chart. 22 The option is available only in the registered version. j. Print Marriage Dates? This option is another "yes/no" field which will accept the single character "Y" or "N". "YES" will enable the printing of the year of marriage of parents of each sibling on the chart. The marriage year of parents is printed immediately to the right of the appropriate sibling. It takes the form "M: yyyy" where "yyyy" is the four digit year. This option is available only in the registered version. k. Character Set: The Epson LQ 850/950/1050 printers have built-in international alphabet capabilities. There are 14 built-in sets of special characters used in various alphabets. These special character sets control the symbols used to print 12 ASCII codes. Those codes (in hexadecimal) are: 23, 24, 40, 5B, 5C, 5D, 5E, 60, 7B, 7C, 7D and 7E. PEDIGREE allows selection of 13 of the printer's built-in sets. The possible values for this parameter are: USA, FRANCE, GERMANY, ENGLAND, DENMARK1, DENMARK2, SWEDEN, ITALY, SPAIN1, SPAIN2, JAPAN, NORWAY and LATINO. When the cursor moves into the "Character Set" field, a pick list of the character set names opens. Use the arrow keys to move the highlight bar to the character set you want, and press to register your choice. "USA" is the first in the list, and it's the default. Note: Use of a character set and a special font is mutually exclusive. If you select a special font (your selection is other than "-NONE-") you can not use a built-in Character Set. To use one of the 13 built-in character sets, select font "-NONE-". See the section "Epson Character Sets" for a detailed explanation of the 13 character sets. Be aware that these character sets are built into the printer and not into the PEDIGREE software. PEDIGREE merely provides a way to activate one of the set. If you're using a non-Epson printer, your printer may not have these character sets. Consult your printer manual if you intend to use this feature. Use of an alternate character set applies to both the "standard" report made from the Starting Person picklist and to the pedigree chart. PEDIGREE will save all your parameters in a disk file. The name of the file is "PEDIGREE.PRM". The file is not supplied with the 23 distribution file, but PEDIGREE creates it during the first time it's executed. First-time execution parameters are defaults. When you execute PEDIGREE every time after the first time, the parameters will be reset to whatever they were during PEDIGREE's last execution. PEDIGREE use context-sensitive help for this data entry screen. Pressing will pop-up a window with help information for the field in which the cursor rests. Press to close the help window. When you're satisfied with all your parameter selections, key in . That means hold down the key while pressing the key. That's the signal to PEDIGREE that you're finished with the parameter screen. If, while entering any parameter or when you , PEDIGREE dislikes your selections, it will object by beeping and displaying an appropriate error message. PEDIGREE will not continue until it's satisfied with all parameters. Pressing while the parameter entry screen is displayed will stop PEDIGREE, and the system will return to the DOS prompt. NOTE: All PEDIGREE parameters display on the data entry screen even in the unregistered version. The parameters reserved for the registered version simply don't do anything in the unregistered version. 3. GEDCOM File Loading After the parameter screen, PEDIGREE displays a screen with "rolling" counters of GEDCOM records, persons and families as it processes the file. This screen will only be displayed if you've selected "STANDARD" chart mode. The counters will give you an exact measure of what's in your GEDCOM file insofar as individuals and families. PEDIGREE also displays the full path/filename. If you're printing a blank chart then this screen is skipped. 4. Starting Person Selection The "Starting Person" as used for the purpose of this program is that person that "starts" the pedigree, i.e., the central individual from whom ancestors are derived. On the pedigree display you'll see the starting person at the left in the center of the screen. The Starting Person Selection list is also used to control whether you want a pedigree displayed/printed or whether you want a standard list report printed. The picklist is "multiple-choice" allowing you to "mark" one or more individuals in the list. If you mark 1 or none in the list and press , PEDIGREE assumes you're thinking "pedigree chart". If you mark more than one individual, PEDIGREE assumes you mean "print standard report with marked individuals". 24 a. The Display PEDIGREE automatically determines the type of color monitor you have and adjusts the limits of the "Starting Person Selection" picklist accordingly. If you have a lowly CGA, you'll get a standard 25 line display. EGA users will have a 43 line picklist and VGA users will have a 50 line picklist. The higher level monitors allow me to display more names at one time making it easier to move up and down a large list of names. Within the on-screen "Starting Person Selection" window one line is displayed for every person in the GEDCOM file. This display is a typical "pick list". Use the cursor keys to move the highlight bar up and down to select the starting person for the pedigree. Along the right edge of the Starting Person Selection window is a scroll bar. Scroll bars are usually intended for use with a mouse, but PEDIGREE is rodent-free. I use the scroll bar and it's slider to indicate the current relative position of the cursor highlight bar within the entire list of persons. The slider moves up and down the scroll bar as you move through the list. I.e., if the slider is in the center of the scroll bar, the highlight cursor bar is sitting on a person (excuse the expression) somewhere near the middle of the file. At the bottom of the screen is a small window. The window has help info on the meanings of the keystrokes within this screen. There are 6 items of data shown for every person. (1) The GEDCOM NUMBER of the person. (2) The NAME of the person (Last, First). (3) The BIRTH/DEATH dates. (4) The age at death (if good birth/death dates) (5) The GEDCOM NUMBER of the Father. (6) The GEDCOM NUMBER of the Mother. If there is no data in any one of the 5 fields, then that data wasn't present in the GEDCOM input. For example, there might not be a Father/Mother number. It would be pointless to attempt a pedigree on that person. b. Moving Around the List The < > and < > arrows move the highlight bar through the list of individuals. moves to the top of the list of persons. moves to the last person in the list. moves one screen-full up and moves one screen-full down in the list of persons. Move the highlight bar with the cursor keys until you've highlighted the person you want as the pedigree's starting person. 25 All other persons on the pedigree will be ancestors of that person. To display the pedigree of that person on-screen, press . Or, if you want to exit the Starting Person Selection screen without displaying the pedigree, press . You'd use here if you're using PEDIGREE as a "GEDCOM file viewer". Pressing will return you to the Parameter screen to allow you to change parameters for another run. As noted before, PEDIGREE always displays an age at death even if you've elected to not print the age. PEDIGREE, in this one instance, makes an attempt to use an irregular date. As long as PEDIGREE has a valid year as the last data item in a birth and death date, it probably will be able to calculate an age. For example, "1873-ROUGHLY 1886" produces the age 13 "ROUGHLY 1872-ABOUT 1909" produces the age 36 This attempt at calculation of an age at death also applies to the printed pedigree chart. If you don't want these approximations on the chart, don't select the option to print ages. c. Name Searching The registered version permits name searching within the Starting Person Selection window. To locate a specific person, type in up to 15 characters of the last name. PEDIGREE begins searching immediately with the first character you type. For example, if you press the "M" key, PEDIGREE will move forward in the list stopping at the first person whose last name begins with "M". If there aren't any, PEDIGREE doesn't move the highlight bar. Press the "U" key next and PEDIGREE moves forward to the first name beginning with "MU". As long as PEDIGREE is able to match your input to a name, it will continue to search forward. The first character that causes PEDIGREE's name search to fail will reset it's internal memory of what you were typing. For example, try searching for the name "SZABO". Let's assume you have someone in the file whose last name begins with "S". As soon as you press the "S" key, PEDIGREE moves forward stopping with the highlight bar on that person. Let's also assume there aren't any "SZABO"s in the file. When you press "Z", PEDIGREE's search fails; it doesn't move the highlight bar, and it resets the search string. Pressing the "A" key would now cause PEDIGREE to position the highlight bar over the first person whose last name begins with "A". d. Printing The List Rather than printing a pedigree chart, PEDIGREE will print a 26 report that looks like the starting person selection picklist. You can "mark" any/all individuals to be printed with a few keystrokes. To mark one individual for printing place the highlight cursor over that person and press the bar. You'll see a check mark appear at the left of the line for that person. Pressing the bar a second time removes the mark. You can mark an entire block of individuals in the following manner: place the highlight cursor on the first person in the block and press the keys and . That means, hold down the key and then press . Let up the key and press (for BEGIN BLOCK). Now move the highlight cursor to the last person in the block and enter the key sequence and (END BLOCK). You'll see check marks appear to the left of every entry in the block. Note: if you select more than one individual in the list, PEDIGREE will automatically assume that you want to print the standard list report and not display a pedigree chart. To display a pedigree chart either select only 1 individual (or none) and press over the starting person as described above. When PEDIGREE finishes printing the standard report, the Starting Person Selection list is redisplayed with all individuals deselected. See the section "Key Commands Summary" for a complete list of keystrokes to manage the list. 5. The Pedigree Display The on-screen pedigree shows four generations beginning with the person you selected as the starting person. The name of each person is displayed with the birth/death dates. If there are more ancestors beyond the 4th generation there will be a "+" displayed at the right side of that ancestor. Use the cursor keys to "walk" around the pedigree. Scrolling the pedigree changes the starting person. In doing so, all ancestors on the pedigree become those of the new starting person. The keyboard keys to use while the pedigree is on-screen are: a. < > Up arrow move to the Father b. < > Down arrow move to the Mother c. < > Left Arrow move to the child You can also press for help. opens a "Help" window which explains all the keystrokes usable while the pedigree is on the display screen. In the pedigree display the idea is to select the correct starting 27 person for potential printing by scrolling the pedigree. Once you've done that, you're ready to print. Remember, you needn't actually print the pedigree. You can browse around the pedigree as you like and then return to the Starting Person Selection screen to pick another family line for pedigree display. If you want to abandon the pedigree so you can pick another starting person, press the key. You'll be returned to the Starting Person Selection window so you can pick some other starting person. The highlight bar will be positioned on the most recent starting person from the pedigree chart when you left it. If you want to print the pedigree, press

or

("print"). If you want to exit the program completely, press . 6. Printing The Pedigree If you elect to print the pedigree by pressing

or

from the on-screen pedigree display, PEDIGREE starts printing and changes the display screen to let you know it's in the printing process. Towards the bottom of the screen is a horizontal bar that moves from left to right as printing of the pedigree proceeds. The bar moves within a box that is marked with %-of-completion values. The box is marked at 0%, 50% and 100%. The size of the bar within the box lets you know how far PEDIGREE is from completing printing of the pedigree chart. When PEDIGREE completes printing the pedigree chart, it returns to the Starting Person Selection screen awaiting another person selection. Now, you can select another person to do it all over or you can press to end the program. G. Errors Things can go wrong. For this reason PEDIGREE has a bunch of error detecting instrumentation. The error messages PEDIGREE can display on the screen and their meanings are: MESSAGE: Maximum number of persons exceeded. MEANING: You've exceeded the maximum number of persons the program allows. This could be a common event with the unregistered version of the program. With the registered version it should happen only if PEDIGREE runs out of main memory (RAM) on your system. MESSAGE: Maximum number of families exceeded. MEANING: Same as above but for families. MESSAGE: The Printer is on but not ready. MEANING: PEDIGREE can't talk to the printer even though it's turned on. Press the "ON LINE" button on the printer. 28 MESSAGE: The Printer is out of paper. MEANING: You know what this means. Put some paper in the printer. NOTE: some Epson compatible printers do not allow printing as close to the paper edge as a true Epson. You might run into this problem if you're using single sheets in a "compatible" printer. Try defeating the "paper out" switch. MESSAGE: The Printer is turned off. MEANING: I think you know what this means, too. MESSAGE: Pick Window Initialization Error. MEANING: Internal error or insufficient memory - tell Ken. MESSAGE: Error initializing command processor. MEANING: Another "tell Ken" error. MESSAGE: 'filename' is not a valid GEDCOM file. MEANING: PEDIGREE doesn't see GEDCOM standard data in the front of your "GEDCOM" file. Make sure you entered the file name correctly and that the file you're using conforms to specs as I've described them herein. MESSAGE: The chart image file cannot be found. MEANING: "PEDIGREx.CHT" is not in the same subdirectory as the PEDIGREE program. Where did you move it? Find it and put it back. The registered version has 8 files named PEDIGRE1.CHT through PEDIGRE8.CHT. MESSAGE: The path "GEDCOM-path" cannot be opened. MEANING: Although the filename in the "GEDCOM-path" exists, DOS will not let PEDIGREE open the file for reading. This message should never appear. MESSAGE: Font file "font-file-name" cannot be opened. MEANING: PEDIGREE can't find the alternate font you asked it to use. The fonts must be in the same subdirectory as the PEDIGREE program. Check the contents of PEDIGREE's subdirectory. MESSAGE: Error initializing the data entry screen. MEANING: Another internal or system error or insufficient memory. Tell Ken. MESSAGE: Help initialization error. MEANING: PEDIGREE was unable to initialize the data supporting the context-sensitive help. Another system error or insufficient memory. Tell Ken. MESSAGE: Insufficient Memory MEANING: PEDIGREE has exhausted all memory available to it. Try running with no TSR's or menus to free more RAM. Use a memory manager such as QEMM or EMM386 to move programs from memory below 640K to high memory above 640K. 29 The only errors you can reasonably expect to see regard the operation of the printer or the amount of free RAM PEDIGREE has available. If the error message is not printer related, check whether you're running a menu system or TSR's that use main memory. If you have an AT-class machine (80286/80386 etc.), there are memory managers available to relocate TSRs (and DOS) freeing up more main memory. Since the program was written in Pascal, it's conceivable that other circumstances will arise causing the Pascal environment code to complain. These are impossible circumstances to predict; far too numerous to document here, and highly unlikely to occur. If any other kind of "Error" message appears, please contact me about it so I can exorcise the problem. H. Key Commands Summary 1. Parameter Specification Screen - moves the cursor amongst the fields - accept all the screen data and proceed with processing - accept the data in the current field Arrow Keys - control cursor movement within a field - delete the character immediately to the left of the cursor - delete the character under the cursor - move cursor to the start of the field - move cursor to the end of the field <+> - change a multiple choice selection to the next <-> - change a multiple choice selection to the previous All other keyboard keys act normally including. 2. Select Starting Person Screen < > Up Arrow - move the highlight (selector) bar up one person < > Down Arrow - move the highlight bar down one person - scroll the Starting Person Selection list of persons down one screen full - scroll the Starting Person Selection list of persons up one screen full 30 - scroll the Starting Person Selection list of persons to the top of the list (first person) - scroll the Starting Person Selection list of persons to the bottom of the list (last person) - Exit the Starting Person Selection list and return to the Parameter Selection screen - display the pedigree using the person highlighted (under the cursor) as the starting person. If multiple persons have been selected then print the standard report but don't display a pedigree - display a scrolling window with help information about using the Starting Person Selection picklist. - Select/de-select (mark/unmark) an individual - Mark the start of a block of individuals - Mark the end of a block of individuals - If any individuals are selected (marked), clear all selections. If no individuals are selected, mark all individuals. This key sequence is a toggle. You can use this to print the entire GEDCOM list by selecting all and then . - Deselect all. Clear any selections. 3. Pedigree Chart Screen < > Up Arrow - move to the father of the starting person < > Down Arrow - move to the mother of the starting person < > Left Arrow - move to the child of the starting person - Exit the program - Leave the pedigree and return to the "Starting Person Selection" screen. - Help - Display the meaning of all the keys. 4. Other can be used to stop the program at any time. Recognition of by the computer is made whenever PEDIGREE is writing to the display screen or printer. You may have to enter a few times in rapid succession to get PEDIGREE's attention. 31 VII. REGISTERING PEDIGREE PEDIGREE is not free. It's Shareware. I've spent a considerable amount of time and computer supplies developing this program, and I expect to be recompensed for my efforts. Shareware is a brave concept in software marketing that allows you to "try before you buy". Shareware authors retain all rights under their copyright, but allow you free distribution of their programs. Distributors of shareware - including on-line BBS and catalog outlets - usually do not charge for the shareware software itself. The distributors are charging for their own services such as reproduction and postage. Registration payment directly to the author entitles the user to additional services, information, and newer products. It's a great deal for users, authors, and distributors alike. Please support this honor marketing technique so that more great programs of increasingly professional quality can reasonably be provided via this system. Copyright laws apply to both shareware and commercial software, and the copyright holder retains all rights, with a few exceptions clearly stated by the author. Shareware authors are accomplished programmers much like commercial programmers, and the programs are usually of comparable quality. The main difference is the software distribution method. The shareware author specifically grants the right to copy and distribute the software to all except that written permission must be obtained from the author before a commercial disk vendor may copy or distribute his/her products. Shareware is a distribution method, not a type of software. You should find software that suits your needs and budget, whether it's commercial or shareware. The shareware system makes fitting your needs easier, because you can try before you buy. And because the overhead is low, prices are low also. Shareware has the ultimate money-back guarantee - if you don't use the product, you don't pay for it. You're entitled to use PEDIGREE for 15 days with no charge. If, after the 15 day trial period, you decide to keep the program, you're honor-bound to pay me for it. The registered version of PEDIGREE is $20.00. I consider that a very fair price for this program. If, however, you decide after the trial period not to keep the program, discontinue it's use and erase it from your system. Send the registration fee to: Ken Murphy 1704 West Lindner Ave Mesa, AZ 85202 <---the town with the best darn Family History Center outside of Salt Lake City! Use the registration form attached to this document. If it's lost, include a note with the name and address where you want the registered version mailed, and the "Registered To" name you want. Also, tell me what type of 32 IBM compatible processor you're using (XT, 286, 386, etc.) Indicate whether you prefer 5.25 inch or 3.5 inch floppy disks. You'll get back the latest version with whatever changes and/or corrections have been made since the last release. The registered version you get will be optimized for an "AT" and up if that's what you say you're using. Be sure to note whatever "Registered to" name you want on the banner screen if it's different from the mailing name. One final comment on shareware. It's a rare shareware program that recoups the money spent on it's development. Support shareware authors by sending the modest and reasonable fee requested. You can freely distribute PEDIGREE to other individuals or to other computers such as BBS's. There is one provision, however, which you must observe. The file to be distributed is the ZIP file which you originally received. Distribute nothing other than that. You may not reverse-engineer this software in any way. All and any rights to this software not specifically mentioned are mine. Rights to the chart designs are mine and may not be replicated without my permission. The sole right retained by the user for the charts is the right to optically reproduce a chart for his/her personal use. VIII. THE REGISTERED VERSION The registered version has very high restrictions on numbers of persons and families. They're set so that the actual limit will be the amount of main memory available to PEDIGREE. The more RAM available, the more persons that can be loaded from your GEDCOM data. PEDIGREE will always display an error message if it runs out of system resources, but it will continue to process whatever has been loaded up to that point. The registered version displays your name on the banner screen - a permanent reminder of your ownership and personal integrity. Registered PEDIGREE permits you to display/print pedigrees using only upper case characters for names and dates. The registered version also provides the ability to search for a name within the Starting Person Selection screen. The unregistered version only permits cursor-key scrolling to select the starting person. When you've got 2000+ persons in the name list, the ability to search for a name can be a big time-saver easing that desire to mash the key. The registered version permits selection between the 8 styles of printed pedigree charts. The shareware version uses only the 4-generation shaded box style of chart and the 5-generation chart. The registered version permits you to print on the pedigree chart the age (in years) at death of an individual. The registered version also has an option that permits printing marriage dates of parents for each sibling. The registered version can use the printer's international character sets to print the names and dates on the pedigree chart rather than just the 33 standard Roman Elite font used by the unregistered version. These characters look much nicer and are more in keeping with the "feeling" of a pedigree chart. The registered version also permits the use of 10 special printer fonts. These fonts are supplied with both the unregistered and registered versions. They're supplied with the unregistered version so the user can test printer compatibility, but they can't be used with the PEDIGREE program. The registered version will permit EGA and VGA display users to maximize the use of the display screen by displaying 43 or 50 lines. The unregistered version is restricted to CGA-only, i.e. 25 line displays. To summarize, here's the extras in the registered version: A. Your name on the banner screen. B. Vastly increased person/family processing capacity. C. Search-by-name in the Starting Person list. D. Custom printer fonts for printing pedigree charts. E. A "Prepared For" name printed on the pedigree chart. F. Selectable all-upper-case pedigree display/printing. G. Selectable screen sizing for EGA and VGA displays. H. 8 selectable printed chart styles. I. Option to print age at death on chart. J. Option to print marriage dates on chart. IX. PEDIGREE TECHNICAL SPECS PEDIGREE was written in Borland's Turbo Pascal version 6.0. The most recent version has been recompiled using Borland Pascal 7.0 for REAL mode execution. I also made extensive use of the Object Professional package from Turbo Power version 1.14. The recompiled version uses Object Professional version 1.20. PEDIGREE was developed on a 32 KB cache, 20 MHz 386SX running MS-DOS 5.0 over an AMI BIOS. My system uses a NEC VGA MultiSync display driven by an ATI VGA Wonder+ display card. Initial print testing was done on my Epson LQ-850 printer hooked to the LPT1 parallel port. Printing is done in Unidirectional mode. Unidirectional makes printing slower, but the quality of the result is much better. Printing a pedigree chart takes about 2 and 1/2 minutes on my LQ-850. The actual pedigree chart layout was prepared with PFS:1st Publisher version 3.0 using 180 DPI smoothed and scaled printing. Spinnaker Software has the rights to PFS:1st Publisher. The optional fonts were prepared by me with software I wrote. This document was prepared with WordPerfect 5.1. PEDIGREE was originally tested on GEDCOM files created by Carl York's genealogical database program "The Family Edge Plus". Of all the GEDCOM 34 files I've seen, Carl's are the cleanest. PEDIGREE was also tested on several of the GEDCOM files available in the LIB's of the ROOTS Forum on CompuServe, and those generated by the Beta testers. PEDIGREE employs a memory extending technique that uses the Upper Memory Blocks (UMB) to extend Borland Pascal's Heap. This doesn't mean much to non-Pascal folks, but it allows PEDIGREE to "get it's hands" on memory not normally available. This means PEDIGREE can process really big GEDCOM files with thousands of individuals. The memory technique is compatible with other memory managers such as QEMM. It's safe to load anything else you want into UMB's. PEDIGREE will only use that Upper Memory that's unused. When it terminates execution, any UMB space used will be returned to the system. X. USER SUPPORT You don't need any. Seriously, if you find any flaw in the program, please don't trash it and then keep quiet. I'll promptly fix any error so that we all can benefit from a sound program. Got an idea for improving PEDIGREE? Great, let's hear it! You can reach me on CompuServe 74025,731. Leave me a message in the Software section of the ROOTS forum or send me an EMAIL. Tell me what else you'd like PEDIGREE to do. If there's a problem, describe the problem, any PEDIGREE error messages and the PEDIGREE parameters you were using. I also need to know what flavor of computer you have; what DOS you use; the types of disk drives you were using; your monitor type; your printer make and model, and the breed of your dog. XI. DISCLAIMER Yes, the ubiquitous disclaimer. This program has been carefully tested by me and a small community of very thorough BETA testers. There are no known bugs in the original version 1.1. You, however, bear sole responsibility for what PEDIGREE does on your computer. Relax ... PEDIGREE is strictly a "READ-ONLY" piece of software with the exception of saving your parameters. However, the program does some fairly fancy RAM management (computer resources - not the animal). If, in the unlikely event your system locks when running PEDIGREE, reboot your system. Then let me know so I can determine if it's PEDIGREE's fault and, if so, do something about it. If you're really a very cautious type, then play it safe - back up the files you intend to use with PEDIGREE. XII. FUTURE VERSIONS Plans for the next version include the following: A. Print marriage dates on the pedigree chart. (Done in 2.0!) B. Use baptismal/christening dates if birth dates are absent. C. Select from several alternate pedigree chart designs. (Done in 2.0!) D. Use RAM above 640K to accommodate large GEDCOMs. (Done in 2.0!) E. Support for other printers. 35 F. Option to print the person/family population in list form. (In 2.0!) G. Compress the chart style files to conserve disk space. (In 2.3!) H. Selectable internal printer character sets. (Done in 2.1!) I. 5 generation chart (Done in 2.2!) J. Multiple 5 generation chart designs. XIII. REVISION HISTORY v 1. Initial release only to BETA testers. v 1.1 First "official" release with fixes and suggestions from BETA testing. v 1.2 Fix a few bugs having to do with the picklist display of persons' mother/father GEDCOM numbers. v 1.3 Increase the size of the counter of GEDCOM records to accommodate very large GEDCOM files. v 1.4 Recompile eliminating unused window and mouse code - makes it smaller and faster. v 2.0 Recompiled with Borland Pascal 7.0 for REAL mode execution. Smaller and faster program. Included Object Professional v1.20 for REAL mode execution. Added ability to select chart style using 7 different chart designs. Fixed problem - last chart line was not printing on some types of printers. Also, reinitialized printer when finished. Miscellaneous code cleanup and bug-fixing. Added calculation for age at death for both Starting Person Selection display and pedigree chart printing. Option to print marriage dates on chart. Help screen for the Starting Person Selection picklist display. Use UMB's to extend Pascal's Heap to permit processing more individuals in large GEDCOM files. Pick list for standard report chart styles. Feature to mark selected/all individuals on the Starting Person Selection screen and the "standard" report from that list. v 2.1 Epson built-in international character set selection Changed chart style selection to full-view picklist v 2.2 5 generation chart - the 8th design choice. PREPRINT chart mode option. Improved parameter screen field editing 36 Emphasized printing option. Minor bug fixes. Increased individual/family capacities v 2.3 RLE compressed chart design files to save disk space. Printer quality option to control both emphasized printing and unidirectional printing. XIV. EPSON BUILT-IN CHARACTER SETS Selection of an international character set provides you special characters used in foreign languages. There are 13 sets from which to choose. Use of any of the 13 sets is mutually exclusive with a special font. The sets define which ASCII codes will print such symbols as Circumflex, Diaeresis, O Slash, Acute, etc. The standard Epson Extended Graphics character table (the default used by PEDIGREE) already has international symbols defined for ASCII codes $80 and up. If your GEDCOM data file use those ASCII codes for non-USA symbols, you can print a PEDIGREE chart with them using the default USA character set. If, however, your GEDCOM originated from a non-USA source, you may have these special symbols represented by other ASCII codes. Ordinarily, you won't have need of these foreign language symbols. Most of the foreign language symbols such as Umlauts, Grave and Diaeresis used in GEDCOM data are represented by the higher value ASCII codes, and they'll print just fine on your Epson if you use the default font with the USA character set selected. If, however, you know these foreign language codes are present in your GEDCOM data, PEDIGREE is prepared to print them. The table on the next page describes the ASCII codes affected, the country and the character symbols generated. The table prints perfectly on an Epson compatible printer if you print this document using WordPerfect 5.1. If you copy the PEDIGREE.TXT version of the DOC to the printer, this table will not print completely correct - a few of the symbols may be blank. 37 A S C I I C O D E H E X 23 24 40 5B 5C 5D 5E 60 7B 7C 7D 7E USA # $ @ [ \ ] ^ ` { | } ~ FRANCE # $   ‡  ^ ` ‚ — Š GERMANY # $  Ž ™ š ^ ` „ ” á ENGLAND œ $ @ [ \ ] ^ ` { | } ~ DENMARK1 # $ @ ’ ^ ` ‘ í † ~ DENMARK2 # $ $ š ‚ ‘ í † SWEDEN # Ž ™ š ‚ „ ” † ITALY # $ @ \ ‚ ^ — … • Š Ž SPAIN1 ž $ @ ­ ¥ ¨ ^ ` ¤ } ~ SPAIN2 # $   ­ ¥ ¨ ‚ ` ¡ ¤ ¢ £ JAPAN # $ @ [ ] ^ ` { | } ~ NORWAY # ’ š ‚ ‘ í † LATINO # $   ­ ¥ ¨ ‚ ¡ ¤ ¢ £ The default Epson Extended Graphics character table includes many foreign language symbols. If you examine a chart of either an Epson Extended Graphics character table or an MS-DOS code page table for English, you'll see the foreign symbol codes starting at ASCII 128 decimal (80 hex). If your GEDCOM data contains foreign language symbols and their ASCII codes are standard Epson, you don't want to use a special character set. 38 XV. REGISTRATION FORM Mail with the $15.00 to: Ken Murphy 1704 West Lindner Ave. Mesa, AZ 85202 Please print the following: Name: __________________________________________________________ Street Address: ________________________________________________ City: ___________________________________ State: __ Zip: _____ "Registered to" name: __________________________________________ CPU Type used: 8088 XT 286 AT 386/486 Disk Size Desired: 5.25" 3.5" Comments: ______________________________________________________ ________________________________________________________________ ________________________________________________________________ ________________________________________________________________ Suggestions to improve PEDIGREE: _______________________________ ________________________________________________________________ ________________________________________________________________ 39