home *** CD-ROM | disk | FTP | other *** search
/ Brotikasten / BROTCD01.iso / cpm / rootsm.txt < prev    next >
Text File  |  1979-12-31  |  107KB  |  2,577 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                                 ROOTS/M
  21.  
  22.                         SOFTWARE TO HELP ORGANIZE
  23.                            YOUR FAMILY TREE
  24.  
  25.                      PROGRAM BY HERBERT DRAKE JR.
  26.                                                         
  27.                    ORIGINAL MANUAL BY BRUCE MURRAY
  28.  
  29.  
  30.  
  31.    * THIS IS NOT FREE SOFTWARE. THIS IS A SHAREWARE PROGRAM. YOU   *
  32.    * ARE ENCOURGED TO USE THIS PROGRAM AND DISTRIBUTE THIS PROGRAM *
  33.    * TO BBS SYSTEMS AND YOUR FRIENDS. NO CHARGE CAN BE MADE FOR    * 
  34.    * THIS PROGRAM ABOVE THE ACTUAL COSTS TO REPRODUCE THE PROGRAM. *
  35.    * HERB DRAKE JR. RETAINS ALL COPYRIGHTS AND EXPRESSLY FORBIDS   * 
  36.    * THE SALE OF ROOTS/M BY ANY PARTY, OR THE INCLUSION OF ROOTS/M *
  37.    * IN ANY PACKAGE OF PROGRAMS OFFERED FOR SALE. IF YOU FIND THAT *
  38.    * THIS PROGRAM IS USEFUL AND YOU CONTINUE TO USE IT AFTER A 30  *
  39.    * DAY EVAULUATION PERIOD, YOU MUST REGISTER THE PROGRAM. WHEN   *
  40.    * YOU DISTRIBUTE THE PROGRAM, YOU MUST INCLUDE ALL THE FILES IN *
  41.    * THIS ARCHIVE. YOU MAY NOT ALTER OR MODIFY THE ROOTS/M FILES.  *
  42.    *                                                               *
  43.    * PLEASE SEND YOUR REGISTRATION FEE OF 20 DOLLARS (US) TO :     * 
  44.    *                                                               *
  45.    *             HERBERT DRAKE Jr.                                 *
  46.    *             40 PIKES PEAK DRIVE                               *
  47.    *             SAN RAFAEL, CA. 94903                             *
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.    *****************************************************************       
  62.                             *** NOTE ***
  63.  
  64.    This program is being released by Herbert Drake as a Shareware
  65.    program. This program was once available as a commercial program
  66.    and has not been available for years. If you find this program 
  67.    fits your needs, PLEASE REGISTER IT. It's not often these days    
  68.    that we CP/M users can even find software for our machines. I       
  69.    would hope that we would support any software authors that make
  70.    such fine programs available.
  71.  
  72.    One of the most important features of this program, in my opinion,
  73.    is the data files you create under ROOTS/M can be moved into the
  74.    Commsoft IBM series of ROOTS programs. The Commsoft programs,  
  75.    ROOTS II and ROOTS III, are considered by many genealogists to 
  76.    be two of the best programs available. This means you can use  
  77.    your present computer with ROOTS/M, and later if your computer      
  78.    dies, or you decide to move to an IBM compatible, you can move
  79.    your records without typing everything in all over again. After
  80.    putting in a few hundred genealogy records you will probably      
  81.    feel good knowing that you can transfer them the next time.
  82.  
  83.    I would like to thank Herb Drake for releasing this version of
  84.    ROOTS/M. This is an excellent genealogy program that will allow
  85.    you to use your CP/M Computer to keep your genealogy records in
  86.    an easy to access and orderly system. 
  87.  
  88.    Another special thanks to Howard Nurse at Commsoft, who helped
  89.    me track down Herb Drake, and thereby made this release possible.
  90.                                       
  91.    I have attemped to recreate the ROOT/M manual in its entirety
  92.    with the exception of the illustrations and general genealogy   
  93.    information included in the original manual.                   
  94.                                                                    
  95.                                                                    
  96.                     Charles Cotham                                 
  97.                                                                    
  98.                                                                   
  99.  
  100.  
  101.                                                                   
  102.                                                  
  103.                                         
  104.  
  105.                                                  
  106.                                     
  107.                                            
  108.  
  109.                                    
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.                                   1
  117.  
  118.  
  119.  
  120.  
  121.                           TABLE OF CONTENTS
  122.  
  123.                                                                
  124.  
  125. CHAPTER 1: A MARRIAGE OF GENEALOGY AND THE PERSONAL COMPUTER...... 4
  126.   Genealogy and the home computer system meet in ROOTS/M
  127.  
  128. CHAPTER 2: A TALE OF TWO GENEALOGIES.............................. 5
  129.  
  130.   A Quick Run Through ROOTS/M..................................... 6
  131.     The distribution disk comes with a sample basefile which 
  132.     allows you to experiment with the program.
  133.  
  134. CHAPTER 3: THE PEDIGREE CHART AND FAMILY GROUP SHEET............. 11
  135.   The genealogist's standard record-keeping tools.
  136.  
  137. CHAPTER 4: WHAT YOU NEED TO KNOW BEFORE LOADING ROOTS/M.......... 15
  138.   Working with the basefile. An estimate if the number of
  139.   names your system will be able to store. Deleting non-
  140.   essential files.
  141.  
  142. CHAPTER 5: GETTING STARTED....................................... 18
  143.   The start-up procedure and an explanation of the MENU, 
  144.   program control keys and f-table.
  145.  
  146.   MENU........................................................... 20
  147.  
  148.   INSTRUCTIONS................................................... 22
  149.  
  150. CHAPTER 6: THE PROGRAM CONTENTS.................................. 22
  151.   EDIT........................................................... 22
  152.    How to enter names into the basefile. A detailed description 
  153.    and step-by-step explanation of the procedure for adding 
  154.    names to, or modifying names already in, the basefile.
  155.  
  156.   LIST........................................................... 33
  157.    The window on the basefile. Lists all or a portion of the
  158.    basefile
  159.  
  160.   FAMILY......................................................... 34
  161.    The corollary to the family group sheet. Displays the com- 
  162.    position of a family and moves you from generation to gener-
  163.    tion, showing how a single family has grown larger or smaller.
  164.  
  165.   TRACE.......................................................... 35
  166.    The corollary to the pedigree chart. Produces a pedigree
  167.    chart for any individual in the basefile.
  168.  
  169.   PRINT.......................................................... 36
  170.    The way to make hard copies. Prints both a pedigree chart and
  171.    family group sheet of any individual in the basefile.
  172.  
  173.   RELATIONSHIP................................................... 37
  174.    How two people on the family tree are related. Determines 
  175.    the relationship between and degree of consaguinity of any
  176.    two members of the family tree.
  177.  
  178.  
  179.                                   2
  180.  
  181.  
  182.  
  183.  
  184.   ANNIVERSARY.................................................... 39
  185.    Keeping track of important dates. Lists all births, deaths   
  186.    and marriages that have occured on a specified day.
  187.  
  188.   EXIT........................................................... 39
  189.    The way out. Leaving ROOTS/M at the end of a session.
  190.  
  191.  
  192.   Providing your own date routine................................ 40
  193.  
  194.  
  195.  
  196.  
  197.  
  198.                                    
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211.  
  212.  
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.  
  222.  
  223.  
  224.  
  225.  
  226.  
  227.  
  228.  
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.                                    3 
  243.  
  244.  
  245.  
  246.  
  247.  
  248.                             CHAPTER 1
  249.                             A Marriage 
  250.                 Genealogy and the Personal Computer
  251.  
  252. Woven into history is the story of people-names, dates and faces. Those
  253. people hunted and gathered, painted pictures on stone, and built houses
  254. of stone, kept records, built ships. Above all, they had children. Those
  255. children had children, again and again. The cycle of parents and children
  256. has so far persisted, making possible everyone who draws a breath today.
  257.  
  258. Grateful to those who persisted, it is natural to ask, "Who came before
  259. me?"
  260.  
  261. The answer entails a search. The hunt uncovers particular facts and gen-
  262. eral impressions. It summons the powers of a sleuth, launching expeditions
  263. across borders and into unfamiliar territory. Out of the search emerges
  264. a family tree, a personal history, family history, a perspective on hun-
  265. dreds of years of experience. Call the quest "genealogy."
  266.  
  267. Discovering a heritage is like solving a jigsaw puzzle. What were the
  268. names and birthdates of forebears? How many children did they have? What
  269. did they do? How did they feel about their lot in life? A thorough search
  270. can take years of hunting through archives and talking with relatives and
  271. other genealogists. Disinterested ancestors did nothing to make the job
  272. easier. Some will hide. In spite of themselves, though, they undoubtedly
  273. left behind records, clues to the kind of lives they led. Those people
  274. were out there. They existed. You are not chasing ghosts.
  275.  
  276. The exercise of recording on paper all that is worth remembering creates
  277. particular problems for the genealogist. Documenting discoveries becomes
  278. increasingly difficult as the search becomes more successful. As you un- 
  279. cover hundreds of ancestors and record their names and vital statistics
  280. on loose slips of paper, you will gradually build a bulky, loose-leaf
  281. monument to the past. Enter the personal computer.
  282.  
  283. ROOTS/M puts the family tree on a magnetic disk. It will hold the ident-
  284. ities of ancestors, and perform genealogical referencing tasks that would
  285. take hours of searching in loose boxes. Handling enough names to construct
  286. a family tree that can include as many as 99 generations, ROOTS/M turns
  287. the video screen into a window with a view of every branch. A keystroke
  288. charts the growth and decline of families, showing how a single family
  289. grows into many. ROOTS/M calculates the relationship between members on
  290. the tree and keeps track of all anniversaries of births,  marriages and
  291. deaths as well as the place of their occurrence. ROOTS/M will print both
  292. filled-in and blank prdigree charts and family group sheets. These can be
  293. sent to other genealogists or members of your family who can assist you
  294. in your search.
  295.  
  296. ROOTS/M is designed to maintain a database called a "basefile" which 
  297. contains all the genealogical information that you supply. The program
  298. takes the basefile and performs genealogical referencing tasks using 
  299. seven separate routines -or programs- and an on-screen list called the
  300. f-table. The seven routines are selected from a MENU which serves as a
  301. table of contents and door into each of the routines. These include:
  302.  
  303.  
  304.                                       
  305.                                    4 
  306.  
  307.  
  308.         EDIT: Allows you to enter an individual's name, sex, parents,
  309.               date and place of birth, marriage and death, and as many 
  310.               as four spouses.
  311.  
  312.         LIST: Allows you to view all or a portion of the basefile and
  313.               select individuals from the file to use in other routines.
  314.  
  315.       FAMILY: Displays the composition of a single family in a format
  316.               similar to a family group sheet.
  317.  
  318.        TRACE: Constructs a pedigree chart for any individual in the 
  319.               basefile.
  320.  
  321. RELATIONSHIP: Calculates the relationship and common ancestors of any
  322.               two individuals in the basefile.
  323.  
  324.  ANNIVERSARY: Displays all the births, marriages and deaths that occured
  325.               on a specified day.
  326.  
  327.        PRINT: Prints 72 or 132 column width pedigree charts and family
  328.               group sheets.
  329.  
  330. In the lower portion of the screen is a holding area for names drawn from
  331. the basefile. This "fetch-table", or f-table, does not change as you move
  332. between routines, and is the key to the efficient operation of ROOT/M.
  333. While you are running ROOTS/M, either entering new individuals or making
  334. inquiries about others already on the basefile, you will be shuffling 
  335. them in and out of the f-table, using the same names often in more than
  336. one routine. Adept use of the f-table simplifies even further the task of
  337. maintaining and expanding your genealogical records.
  338.  
  339. If your search is diligent, you will collect enough material to fill 
  340. books - letters, news clippings, anecdotes, stories of the day the 
  341. chickens escaped from  the coop, ROOTS/M was written to accomodate as
  342. many ancestors as possible. It does so by compressing  the amount of      
  343. information needed to identify each individual, and it places the com-
  344. pressed basefile in the computers random access memory (RAM) while
  345. ROOTS/M is operating. Placing the entire basefile in RAM increases the
  346. speed of the program's operation; it also means that the program must 
  347. pack data efficiently in the basefile.
  348.  
  349. Although you may create more than one basefile and store them all on
  350. separate disks, ROOTS/M will operate with only one at a time. To con-
  351. serve space, then, and leave room for as many individuals as possible in
  352. your systems RAM, the program is not designed to store anecdotal inform-
  353. tion. As you encounter anecdotes during your search, you should still 
  354. gather them in a seperate place. The program is the kernal of the family
  355. history, the guide to discovery and research.
  356.  
  357.  
  358.  
  359.  
  360.                            CHAPTER 2
  361.                   A TALE OF TWO GENEALOGIES
  362.  
  363. Long ago in the British Isles, two neighboring kingdoms had been at war
  364. for more than 50 years. It had started when an inhabitant of Regencia on
  365. the eastern side of the river allegedly stole a herd of cattle from an
  366. inhabitant of Oxland on the western side of the river. Tempers during the
  367.                                   
  368.                                  5
  369.  
  370.  
  371.  
  372. disagreement over ownership flaired. Armed conflict followed.
  373.  
  374. Since the war had cost his kingdom many lives, the king of Regencia sug-
  375. gested a plan to end the fighting. He proposed to the king of Oxland
  376. that they assemble their armies on a plain by the river. Each country
  377. would select its most able warrior, and the two would battle each other
  378. in full view of both armies, the winner of that contest earning victory 
  379. for his kingdom.
  380.  
  381. Oxland's king agreed, and three days later at sunrise, both armies in 
  382. full regalia assembled by the river to witness the battle that would
  383. decide their kingdom's fate.
  384.  
  385. From the ranks of Oxland's army appeared a giant of a warrior. Full-
  386. bearded, George Gibbon stood six and a half feet tall. He wore thick
  387. animal skins and carried a broadsword. Log strides took him confidently
  388. to the center of the field.
  389.  
  390. From the ranks of Regencia's army Albert Bright appeared. A foot shorter
  391. than Gibbon, he too wore skins, though of much softer sheepskin. He
  392. carried no weapons, it seemed, although as he scurried out to the middle
  393. of the battlefield his right hand was buried beneath the fold of his
  394. garments. Venturing out onto the battlefield, he glanced back several
  395. times at his fellow soldiers as if he were seeing them for the last time.
  396.  
  397. Some distance from the middle of the battlefield, the armies watching 
  398. saw the two stop within a foot of each other. For an instant, Bright and
  399. Gibbon stood motionless. With both hands, then, George Gibbon raised his
  400. broadsword above his head preparing to split his opponent in two.
  401.  
  402. Just as Gibbon started to bring his sword down, a curious thing happened.
  403. Albert Bright pulled a piece of parchment from beneath his sheepskins and
  404. showed it to Gibbon. Gibbon hesitated, looking down at the parchment. He
  405. dropped his sword to his side. Slowly, he put the sword down and shook as
  406. if with laughter. He bent and embraced Bright, picking the smaller man up
  407. into the air, signaling that the conflict had ended. Rejoicing ensued.
  408.  
  409. What happened? Bright had brought a copy of his family tree which showed
  410. that he and Gibbon had the same great-great grandparents. Gibbon , fortu-
  411. nately, understood immediately that he and Bright were cousins, and pick-
  412. ing the smaller man up, he was heard to ask, "Cousin Al, why didn't you
  413. say it was you?"
  414.  
  415.  
  416.  
  417.                    A QUICK RUN THROUGH ROOTS/M
  418.  
  419. A sample basefile -containing the families of Albert Bright and George
  420. Gibbon- has been included on the distribution disk. Users familiar with 
  421. the operation of their system can load ROOTS/M immediately and experiment
  422. with the program using the sample basefile. A more complete set of oper- 
  423. ating instructions is included later in the manual, and less experienced
  424. users may want to review those first.
  425.  
  426.  
  427. MAKE A COPY OF THE DISTRIBUTION DISK
  428.  
  429. Before anything else you should copy all ROOTS/M files onto a blank disk
  430.                                      
  431.                                   6 
  432.  
  433.  
  434.  
  435. that has been formatted. Use the duplicate after storing the distribution
  436. disk in a safe place. Users of one-drive systems may also want to copy 
  437. the CP/M system files onto the disk before copying the ROOT/M files. The
  438. program is composed of several files, use " *.* " to copy all ROOTS/M   
  439. files to your working disk.
  440.  
  441.  
  442. SPECIFY THE CONSOLE DRIVER
  443.  
  444. Console drivers, which serve as the software interface between ROOTS/M 
  445. and many popular CRT terminals, are supplied on the distribution disk.
  446. The console driver which matches your terminal must be named "COD.NRM"
  447. to be recognized by ROOTS/M. ("NRM" refers to the fact that the console
  448. driver is a "non-relocatable module" which means that it is always loaded
  449. starting at a fixed location in your computer's memory.) For a listing of
  450. names and comments about a variety of console drivers, refer to the 
  451. insert in the cover of this manual. The insert contains a table showing
  452. the names of console drivers that most likely apply to your terminal.
  453.  
  454. Use the CP/M RENAME COMMAND to change the appropriate console driver to
  455. COD.NRM. With the disk in dirve A the format for this command is:
  456.  
  457.        A>REN COD.NRM=(Your console driver).NRM
  458.  
  459.  
  460. BRINGING UP ROOTS/M 
  461.  
  462. If you are not placing your ROOTS/M disk into drive A, specify the drive 
  463. that you are using by typing the drive code, a colon(:) and then RETURN.
  464. ROOTS/M is supplied with the sample basefile named "BRIGHT.BIN". To 
  465. load the program type:
  466.  
  467.                        " ROOTS BRIGHT "
  468.  
  469. When ROOTS/M is loaded into the computer, it will first ask you to supply
  470. the date. The program uses the date in several ways, among them, to cal-
  471. culate ages. (If you wish, you can choose to suppress functions that use
  472. the date by pressing RETURN immediately rather than entering the date.)
  473. Once you have chosen to enter a date or forgo that option, the MENU or
  474. the table of contents will appear on the screen. You may choose any one
  475. of the routines by using the cursor control keys to place the cursor on
  476. the line of the desired routine and pressing RETURN.
  477.  
  478. INSTRUCTIONS
  479.  
  480. If you wish to review the contents of the program, use the cursor control 
  481. keys to place the cursor on the INSTRUCTIONS line and press RETURN.
  482.  
  483. Once you have reviewed the instructions, you may return to the MENU by
  484. pressing the MENU key (\).
  485.  
  486.  
  487. LIST
  488.  
  489. Place the cursor next to LIST and press RETURN. The LIST routine, which
  490. allows you to pull names from the basefile, will appear. To obtain a
  491. partial listing of the file you type the name, or portion of the name, 
  492. of any individual who appears in the file on the designated line. In
  493.                                    
  494.                                   7
  495.  
  496.  
  497.  
  498.  
  499. this case, type," BRIGHT ",and press RETURN. You will see a listing of
  500. all the individuals in the file with the last name, Bright.(You must
  501. type a complete name-string -"Bright" and not, for instance, "Bri".) If
  502. you make a mistake, use the backspace key to erase the error. The LIST
  503. routine, while searching the basefile will disregard upper- and lower-
  504. case letters, enabling you to type either "BRIGHT" or "Bright" if you
  505. wish.
  506.  
  507. At the bottom of the screen is the "f-table", or a holding tank for names
  508. pulled from the basefile that you will use in other routines. To place  
  509. an individuals name into the f-table, move the cursor to the line on 
  510. which the name appears, and press one of the numeric keys, 0-9. The
  511. f-table contains space for ten individuals who can appear in two groups.
  512. When " S=swap " appears on the screen, you may press "S"  to view either
  513. one of the five-place tables.
  514.  
  515. Place the cursor next to Albert Bright's name and press "1" key. His
  516. name will appear in the f-table.
  517.  
  518. Press the MENU key(\) to return and select another name. This time, type
  519. "Gibbon" and press RETURN.
  520.  
  521. Place the cursor next to George Gibbon's name and press the "2" key,
  522. placing him on the f2 line. Press the MENU key twice to return to the
  523. MENU.
  524.  
  525.  
  526. TRACE
  527.  
  528. With the names of Bright and Gibbon in the f-table, place the cursor next
  529. to TRACE and press RETURN.
  530.  
  531. ROOTS/M will construct the pedigree chart of an individual you choose     
  532. from the f-table. To see the chart of Albert Bright, press the "1" key
  533. which corresponds to his name in the f-table.
  534.  
  535. The display will place Albert Bright at the top of the chart and list the
  536. data that identifies him in a box below it. A single display will show up
  537. to six generations. Each branch on the chart represents an ancestor. 
  538. Asterisks, or "flags," are attached to selected individuals while entering
  539. them into the basefile. The significance of the flag will be up to you. In
  540. this case they identify Albert Bright's ancestors who have died in the war
  541. between Oxland and Regencia. They appear in other routines as well.
  542.  
  543. You may move the cursor to any individual on the chart using the cursor 
  544. control keys, and the name of that ancestor will appear in the box be-
  545. neath the chart. If you wish to see that person's pedigree, press the "Y"
  546. key that corresponds to YES.
  547.  
  548. Press the MENU key(\) to leave Bright's pedigree. Press the "2" key to
  549. look at Gibbon's.
  550.  
  551. They have a common pair of ancestors, their great-great grandparents. You
  552. can find them by searching each pedigree with the cursor, or you may go 
  553. to RELATIONSHIP via the MENU to determine their relationship and common
  554. ancestors. From the display of Gibbon's pedigree, press the MENU key 
  555. twice.
  556.  
  557.                                   8 
  558.  
  559.  
  560.  
  561.  
  562. RELATIONSHIP
  563.  
  564. Place the cursor next to RELATIONSHIP and press RETURN.
  565.  
  566. You may choose individuals whose relationship you want to know by pressing
  567. two numeric keys. Press the "1" and  "2" keys to determine the relation-
  568. ship and common ancestors of Bright and Gibbon.
  569.  
  570. Note the names of the ancestors, Alchemy Gibbon and Katherine Swamp. You
  571. should place them in the f-table before moving to the next routine.
  572.  
  573. Leave RELATIONSHIP by pressing the MENU key, and then go to LIST or TRACE.
  574. Using those routines, place Alchemy Gibbon and Katherine Swamp in the f-
  575. table. Once the two names are in the f-table, return to the MENU by pres- 
  576. sing the MENU key twice.
  577.  
  578.  
  579. FAMILY
  580.  
  581. Place the cursor next to FAMILY and press RETURN.
  582.  
  583. You may choose any individual in the f-table and view the composition of
  584. that individual's family. Press the numeric key corresponding to Alchemy
  585. Gibbon, and his family will appear. The designations to the left of the
  586. names, explained in the first page of FAMILY, identify children who also 
  587. have children included in the basefile.
  588.  
  589. If you wish to see which of the children became part of the Bright line,
  590. place the cursor next to Gwendolyn Gibbon's name and press the "F" or
  591. FORWARD key. The display will move forward one generation and place her
  592. at the top of the list. If you press the "R" or REVERSE key with the 
  593. cursor next to her husband, Alchibald Bright, the display will move 
  594. backward one generation to show the composition of the family in which
  595. he was a child. you can move from one generation to the next freely us-
  596. ing the "F" and "R" keys.
  597.  
  598. Press the MENU key twice to return to the main MENU.
  599.  
  600.  
  601.  
  602. ANNIVERSARY
  603.  
  604. Place the cursor next to ANNIVERSARY and press RETURN.
  605.  
  606. You may identify the anniversaries of births, deaths and marriages by
  607. designating a date. Choose Jan 1, and press RETURN. Press RETURN again,
  608. and the display will advance one day. The numbers on the left-hand side
  609. of the screen tally the number of years that have elapsed since the  
  610. specified event.
  611.  
  612. Press the MENU key to return to the MENU.
  613.  
  614.  
  615. PRINT
  616.  
  617. Place the cursor next to PRINT and press RETURN.
  618.  
  619. The PRINT routine allows you to identify a number of the characteristics
  620.                                   9 
  621.  
  622.  
  623.  
  624.  
  625. of your printer to insure that ROOTS/M will produce pedigree charts and
  626. family group sheets in an acceptable form. The vertical lines on the 
  627. pedigree chart may be represented by more than one character, and you
  628. may choose one of three characters to suit your printer. To identify the
  629. parameters of your printer place the cursor on the "Set Printer Options"
  630. line and press RETURN.
  631.  
  632. After you have designated the capabilities of your printer, you may press
  633. one of the numeric keys to generate a print-out of the pedigree chart and
  634. family group sheet of any individual in the f-table. If a pedigree fills
  635. more than one page, the printer will print as many sheets as are necess-
  636. ary to complete the chart. You may stop the printer at the end of the     
  637. page it is printing by pressing the MENU key.
  638.  
  639. Press the MENU key and return to the main MENU.
  640.  
  641.  
  642.  
  643. EDIT
  644.  
  645. Place the cursor next to EDIT and press RETURN.
  646.  
  647. Names are entered into the base file using this routine. When it appears,
  648. you will be asked if you wish to create a new record or alter an old one.
  649. The operation of EDIT is covered extensively in the second half of the 
  650. manual. You will probably not want to add any names to the basefile at
  651. this time.
  652.  
  653. Inspect the EDIT record field to observe the information that can be 
  654. stored about any individual. Bring up Albert Bright from the f-table by
  655. pressing the "1" key to see how information about him is displayed. 
  656. Notice the place to attach a flag- the asterisk that apperars next to a
  657. name when it is displayed in other routines.
  658.  
  659. To leave EDIT, press the MENU key. You will be asked if you are sure you
  660. want to leave. Press the "Y" key to return to the MENU.
  661.  
  662.  
  663.  
  664. EXIT
  665.  
  666. To leave the program, place the cursor on the EXIT line and press RETURN.
  667. You will have to verify that you wish to do so by pressing "Y".
  668.  
  669.  
  670. EXPERIMENT WITH THE BASEFILE
  671.  
  672. Feel free to use the sample basefile and explore the composition of the
  673. Bright and Gibbon families. Once you are well-versed in the operation of
  674. ROOTS/M, you can delete this file to free as much disk space as possible
  675. for your own family tree.
  676.  
  677.  
  678.  
  679.  
  680.  
  681.  
  682.  
  683.                                  10
  684.  
  685.  
  686.  
  687.                           CHAPTER III
  688.                      THE PEDIGREE CHART AND  
  689.                        FAMILY GROUP SHEET
  690.                        WHAT TO TAKE ALONG
  691.  
  692. Besides discretion, imagination, perseverance and curiosity, a pair of
  693. genealogical tools should accompany you during your search. These tools-
  694. the pedigree chart and the family group sheet- serve as outlines, scratch
  695. pads, permanent records and guides all at the same time. Together they
  696. present the composition of a single family and the spread of that family
  697. over several generations. Filling out the pedigree chart and the family 
  698. group sheets shows how far you need to go.
  699.  
  700. The examples on pages 13 and 14 show what the ROOTS/M pedigree chart and
  701. family group sheets look like. Referring to the names in the sample base-
  702. file that accompanies the ROOTS/M distribution disk, envision Albert 
  703. Bright, the diminutive inhabitant of Regencia, carrying these documents
  704. onto the battlefield to meet George Gibbon.
  705.  
  706. The pedigree chart is the more familiar of the two forms. (The word,
  707. "pedigree", in spite of its high-society connotations, is derived from
  708. two Latin words, "ped", meaning "foot" and "grus", which means "crane".
  709. Lines showing descent in early genealogies looked like the foot of a 
  710. crane.) Depending on the size of the paper and the printing, many gener- 
  711. ations of ancestors can be shown on the same pedigree chart. The chart
  712. begins with a single person, in this case Albert Bright, and traces his
  713. family line back on both his parent's side. Arnold Bright was his father
  714. and Elizabeth Griffen, his mother. (Women are listed by their maiden
  715. names in genealogical charts.) Albert's grandparents- Sir Arthur Bright,
  716. Helen Cap, Harold Griffen and Sara Goode- appear in the next earlier 
  717. generation. Their parents, Albert's great-grandparents, appear on the 
  718. chart one step back. There is room on the chart for birth, marriage and
  719. death statistics and the place of residence at each event.
  720.  
  721. Notice that for each individual in the fifth generation, there is a num-
  722. ber directing you to another pedigree chart. Each individual in the ped-
  723. igree is numbered- no. 1 for Albert, no. 2 for his father, Arnold, no. 3
  724. for his mother, Elizabeth. When the pedigree contains more than five gen-
  725. erations, more than one chart is needed to include all the names. The
  726. numbers are a referencing system that keeps track of a pedigree filling 
  727. more than one page.
  728.  
  729. The format of the printed pedigree chart will vary depending upon the
  730. printer you are using with ROOTS/M. In the upper right-hand cornor of a
  731. 72-character width printer, Alberts pedigree is labeled "Chart 1". The
  732. chart number will appear at the top of the page if you are using a 132
  733. character width printer. At the bottome of the page with the 72 character
  734. printer is the line, "No. 1 on this page is the same as person no.___
  735. on chart no.___ ". That line appears in the upper left with a 132 char_
  736. acter printer. Since this example is the first of perhaps many pages of 
  737. a large pedigree, the line at the top is left blank. It is unnecessary
  738. to say, "No. 1 on this page is the same person no. 1 on chart no. 1".
  739.  
  740. Should you wish to continue the pedigree chart, you could place Alistair
  741. Bright, no. 16 on this chart, in the no. 1 position of another chart. 
  742. The code at the end of the line indicates that the next chart, with 
  743. Alistair Bright in the no. 1 position, would be chart no. 2. The line at
  744. the bottom of chart no. 2 would read, "No. 1 on this page is the same
  745. person as person no. 16 on chart no. 1". Using the numbers as a reference
  746.                                  11
  747.  
  748.  
  749.  
  750.  
  751. you can work back and forth from chart to chart.
  752.  
  753. The important rule to remember when using the two forms is be consistent.
  754. Be sure you can work from one to the other without encountering inexplic-
  755. able discrepancies. Make sure spellings match and that dates are entered 
  756. in a consistent fashion.
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.  
  801.  
  802.  
  803.  
  804.  
  805.  
  806.  
  807.  
  808.  
  809.                                  12 
  810.   
  811. Drake's   ROOTS/M     V1.04.01   PEDIGREE CHART                  Chart 1
  812.                                                
  813.                                               Archibald Bright
  814.                                               ___________________________
  815.            Sir Arthur Bright                 |   8   CONTINUED ON CHART 2
  816.            __________________________________|
  817.           |  4 BORN      1 FEB  830          | Gwendolyn Gibbon
  818.           |  * WHERE     Regencia            |___________________________
  819.           |    DIED      15 Nov 861              9   CONTINUED ON CHART 3
  820.           |    WHERE     Oxland
  821.           |    MARRIED   6 Sep  847
  822.           |
  823.       Arnold Bright
  824.       ______________________________
  825.      |  2 BORN     16 May  848
  826.      |  * WHERE    Regencia
  827.      |    DIED     15 Nov  880
  828.      |    WHERE    Oxland
  829.      |    MARRIED  10 Jun  868                George Cap
  830.      |                                        ___________________________
  831.      |    |Helen Cap                         |  10   CONTINUED ON CHART 4
  832.      |    |__________________________________|
  833.      |      5 BORN      8 May   832          |Marion Smith 
  834.      |        WHERE     Regencia             |___________________________
  835.      |        DIED      17 Jul  857             11   CONTINUED ON CHART 5
  836.      |        WHERE     Regencia   
  837.      |
  838.      |
  839. Albert Bright
  840. ______________________________
  841.   1  BORN     3 Jan  870
  842.      WHERE    Regencia
  843.      DIED
  844.      WHERE
  845.      MARRIED
  846. _____________________________
  847.     NAME of HUSBAND OR WIFE                   George Griffin
  848.                                               ___________________________
  849.      |     Harold Griffen                    |  12    CONTINUED ON CHART 6
  850.      |     __________________________________|
  851.      |    |  6 BORN     30 May  833          |Helen Randall
  852.      |    |  * WHERE    Regencia             |___________________________
  853.      |    |    DIED     23 Sep  853             13    CONTINUED ON CHART 7
  854.      |    |    WHERE    Regencia     
  855.      |    |    MARRIED  5 Jun   849      
  856.      |    |
  857.      |Elizabeth Griffin 
  858.      |______________________________
  859.         3 BORN     20 Feb   850
  860.           WHERE    Regencia
  861.           DIED     18 Apr   885
  862.           WHERE    Regencia
  863.                                               Jack Goode
  864.           |                                   ___________________________
  865.           |Sara Goode                        |  14    CONTINUED ON CHART 8
  866.           |__________________________________|
  867.              7 BORN      1  Jun   829        |Mary Belly
  868.                WHERE     Regencia            |____________________________
  869.                DIED      2  Jul   860           15    CONTINUED ON CHART 9
  870.                WHERE     Regencia
  871.  
  872. No.  1 on this chart is the same person as no.     on chart no.
  873.                                   13
  874.  
  875.  
  876.  
  877. Drake's   ROOTS/M    V1.04.01  FAMILY GROUP SHEET
  878.  
  879. HUSBAND:   Albert Bright ____________________________________________
  880.    BORN:    3 Jan  870      PLACE:  Regencia
  881.    MARR:                    PLACE:
  882.    DIED:                    PLACE:
  883.    FATHER: Arnold Bright *
  884.    MOTHER: Elizabeth Griffen
  885.    HUSBAND'S OTHER WIVES:
  886.  
  887. WIFE:      __________________________________________________________
  888.    BORN:                    PLACE:
  889.    DIED:                    PLACE:
  890.    FATHER:
  891.    MOTHER:
  892.    WIFE'S OTHER HUSBANDS:
  893.  
  894. CHILDREN:
  895.  
  896.    1. _______________________________________________________________
  897.       BORN:                    PLACE:
  898.       FIRST MARRIED:                      DIED:
  899.    2. _______________________________________________________________
  900.       BORN:                    PLACE:
  901.       FIRST MARRIED:                      DIED:
  902.    3. _______________________________________________________________
  903.       BORN:                    PLACE:
  904.       FIRST MARRIED:                      DIED:
  905.    4. _______________________________________________________________
  906.       BORN:                    PLACE:
  907.       FIRST MARRIED:                      DIED:
  908.    5. _______________________________________________________________
  909.       BORN:                    PLACE:
  910.       FIRST MARRIED:                      DIED:
  911.    6. _______________________________________________________________
  912.       BORN:                    PLACE:
  913.       FIRST MARRIED:                      DIED:
  914.    7. _______________________________________________________________
  915.       BORN:                    PLACE:
  916.       FIRST MARRIED:                      DIED:
  917.    8. _______________________________________________________________
  918.       BORN:                    PLACE:
  919.       FIRST MARRIED:                      DIED:
  920.    9. _______________________________________________________________
  921.       BORN:                    PLACE:
  922.       FIRST MARRIED:                      DIED:
  923.   10. _______________________________________________________________
  924.       BORN:                    PLACE:
  925.       FIRST MARRIED:                      DIED:
  926.  
  927.  
  928.  
  929.  
  930.  
  931.  
  932.  
  933.  
  934.  
  935.                                   14
  936.  
  937.   
  938.   
  939.                            CHAPTER IV  
  940.  
  941.                       WHAT YOU NEED TO KNOW
  942.                      BEFORE LOADING ROOTS/M
  943.  
  944.                ONWARD AND UPWARD WITH THE COMPUTER
  945.  
  946. The search for ancestry will take you all over the map, yet, in however
  947. many directions you travel, you'll finally come back home, ready to add
  948. the results of each trip to a growing permanent record.
  949.  
  950. Receiving the names of ancestors and information that identifies them,
  951. ROOTS/M will display your family tree in a number of ways. It will re-
  952. produce a pedigree chart on the video screen and printer for each 
  953. individual on the tree; display the composition of every family; deter-
  954. mine the relationship between two members of the tree; and keep track
  955. of the anniversaries of births, deaths and marriages. All of its displays
  956. take advantage of the graphics capabilities of your terminal.
  957.  
  958. The result of a successful search is a huge bank of data. ROOTS/M was
  959. written to preserve as much space as possible for names, dates, and   
  960. places. Many of the individuals on your family tree will have the same
  961. last names. If you have two or more subjects with the same last name, 
  962. the computer will store the name-string that those two ancestors have in
  963. common only once. For example, if your name is "Smith" and you have 86
  964. Smiths on your family tree, ROOTS/M only stores the name "Smith" once.
  965. For every other Smith in the program re-uses the one name-string, elim-
  966. inating the unnecesssary storage of 85 other "Smith" name-strings. In
  967. short, wherever it is possible to save space for more names, ROOTS/M
  968. does so.
  969.  
  970. ROOTS/M will also print blank pedigree charts and family group sheets 
  971. which you can use during your research or to send to other genealogist-
  972. members of your family. The program keeps track of the numbering system
  973. used to reference a pedigree chart that covers more than one page. You 
  974. need not enter names with an identifying number- one of the convenient
  975. features of the program.
  976.  
  977.  
  978.                     PROGRAM STORAGE CAPACITY
  979.  
  980.                   HOW TO NAME AND USE BASEFILES
  981.  
  982. ROOTS/M packs the information you enter to increase the number of an- 
  983. cestors you can include on your family tree. By being consistent in the
  984. way you spell and punctuate names and places, you can maintain the larg-
  985. est possible genealogical file. The amount of RAM in your computer and
  986. the configuration of your disk drives will determine the ultimate ceiling
  987. on the number of names you can store. The table on the next page summar-
  988. izes the approximate storage capacity for various systems.
  989.  
  990.  
  991. THE BASEFILE
  992.  
  993. All the data you enter as members of your family tree are stored in a 
  994. single file called the "basefile." When you load the program, this base-
  995. file, BASEFILE.BIN, is transferred from the disk into RAM where it stays
  996. while the program is running. If there is no basefile on any disk in your
  997.                                  15
  998.  
  999.  
  1000.  
  1001.  
  1002. system, you can create one with the EDIT routine. Unless you specify 
  1003. otherwise, ROOTS/M will automatically name the file you create "BASEFILE
  1004. .BIN". (You may also create files with any name you wish. The extension
  1005. of the file will be assigned ".BIN", and so it is not necessary for you
  1006. to assign your own extension. ROOTS/M only recognizes basefiles with the
  1007. extension ".BIN". The procedure for opening more than one file to contain
  1008. the genealogical data you enter is covered later on in this section.)
  1009. When you are finished with your first editing session, the data you have
  1010. entered will be stored on disk, either as BASEFILE.BIN or as (your file-
  1011. name).BIN .
  1012.  
  1013. In the next and all subsequent editing sessiona, you load BASEFILE.BIN 
  1014. from the disk into random access memory in the computer and enter more
  1015. data. When you give the command to update the disk with the information
  1016. you have just entered, the program renames the unedited file, BASEFILE.
  1017. BAK or (your filename).BAK and leaves it on the disk otherwise unchanged.
  1018. A new BASEFILE.BIN containing all the data that was on the file prior to
  1019. the latest editing session plus the new data, is then placed on the disk.
  1020. Each time you enter more data and update the disk, the old BASEFILE.BIN
  1021. is renamed BASEFILE.BAK and stored as a back-up file in the unlikely 
  1022. event that you lose the contents of the file during an editing session.
  1023. This also allows you to delete a new BASEFILE.BIN if you want to remove
  1024. the changes made in the last editing session. You may recover the prev-
  1025. ious data by renaming  BASEFILE.BAK to BASEFILE.BIN using CP/M's 
  1026. "rename" command "REN".
  1027.  
  1028. Every time you enter a new individual into the file, ROOTS/M creates a
  1029. new record. Your first several records will consume more memory space
  1030. than will later records because you are using some name- and place- 
  1031. strings for the first time. As you continue expanding the file, re-
  1032. using some of the same name- and place- strings, each new record will
  1033. consume smaller and smaller  amounts of memory. Each new record and its
  1034. accompanying identifying data uses an average of 30 bytes of memory.
  1035. The number of names you can store will be limited by either the disk
  1036. capacity or available RAM.
  1037.  
  1038.  
  1039. ROOTS/M with a basefile requires at least 32K of RAM for operation, since
  1040. the program alone and CP/M occupy a total of 16K. The table below lists
  1041. the approximate number of records that can be stored by various systems;
  1042. the figures may vary depending upon the BIOS (Basic Input/Output System)
  1043. and console driver size in your ROOTS/M system.
  1044.  
  1045. -----------------------------------------------------------------------
  1046.                      ROOTS/M RECORD CAPACITY 
  1047. -----------------------------------------------------------------------
  1048.                                       DISK SPACE
  1049.                                       NEEDED FOR           APPROX. NO.
  1050. SYSTEM RAM      BASEFILE SIZE          BASEFILE            OF RECORDS
  1051. 32K                 16K                  32K                  500
  1052. 40K                 24K                  48K                  800
  1053. 48K                 32K                  64K                 1000
  1054. 56K                 40K                  80K                 1300
  1055. 64K                 48K                  96K                 1600
  1056. -----------------------------------------------------------------------
  1057.  
  1058. You will also need room for both the BASEFILE.BIN and BASEFILE.BAK on the
  1059. disk, although they do not have to be on the same disk as ROOTS/M or CP/M
  1060.                                  16 
  1061.  
  1062.  
  1063.  
  1064.  
  1065. The twelve files comprising ROOTS/M, not including the sample basefile,
  1066. require about 32K of disk space. To support a system with 64K of RAM to
  1067. maximum capacity, you need a disk capacity of 128K, not including CP/M
  1068. itself. Single-density, single-sided, 5-1/4 inch, 40-track disks used,
  1069. for instance, by Heath systems, are able to store 90,000 bytes of infor-
  1070. mation, or 90K. The storage capacities of double-sided, double-density
  1071. and eight-inch disks are correspondingly higher.
  1072.  
  1073. LOCATING BASEFILES ON SEPARATE DISKS
  1074.  
  1075. If you do not wish to include the basefile on the ROOTS/M disk, you may
  1076. store a file with any name of your choosing on a disk in any drive of
  1077. your choosing. You may also transfer basefiles from disk to disk using
  1078. CP/M's Peripheral Interchange Program (PIP). Depending upon the location
  1079. of the disk which you wish to use to store your basefile and the name of
  1080. the basefile, the commands used to load ROOTS/M can vary.
  1081.  
  1082. In the CP/M command mode a single-letter abbreviation for the drive 
  1083. location will appear beside the prompt once a disk has been booted.
  1084. Normally, you can load ROOTS/M by typing the word, "ROOTS" and then
  1085. RETURN in response to the prompt. As the program is loaded, the 
  1086. computer looks for a basefile named BASEFILE.BIN which contains your
  1087. genealogical record. If it finds no file with the specified name on the
  1088. specified drive, it will notify you:
  1089.  
  1090.          "No Basefile. Use EDIT to create one."
  1091.  
  1092. When running ROOTS/M for the first time, and as you create a basefile
  1093. using EDIT, the contents of that session will be filed in BASEFILE.BIN,
  1094. and stored on the ROOTS/M disk in the drive designated by the letter 
  1095. beside the prompt.
  1096.  
  1097. You may wish to open another basefile, not necessarily named BASEFILE.BIN
  1098. and place it on a disk located in a separate drive. After typing "ROOTS"
  1099. to load the program and before pressing RETURN, identify the desired 
  1100. drive with its single-letter designation followed by a colon and then 
  1101. the desired filename.
  1102.  
  1103. For instance, with ROOTS/M in drive A, say you wish to create a file
  1104. with the name, "SMITH.BIN", to contain an entire family line on the
  1105. disk in drive C. In response to the prompt asking you to load ROOTS/M,
  1106. type:
  1107.             " ROOTS C:SMITH "
  1108.  
  1109.                  --OR--
  1110.  
  1111.             " ROOTS C:SMITH.BIN "
  1112.  
  1113. This will load the program and cause the contents of the editing sessions
  1114. to be placed in the file SMITH.BIN which will be located in drive C.
  1115.  
  1116. Once SMITH.BIN is stored on a disk you may load it (or any other file)
  1117. with the program by typing "ROOTS (Drive):(Filename)". That will give you
  1118. access to the records contained in the particular file.
  1119.  
  1120. If you only type the word "ROOTS" to load the program, the program will
  1121. search the default drive for the file with the name BASEFILE.BIN. If it
  1122. does not find that file, it will create a BASEFILE.BIN on the default
  1123.                                   17
  1124.  
  1125.  
  1126.  
  1127.  
  1128. disk. Unless you specify a particular file, ROOTS/M will assume that 
  1129. you wish to work with BASEFILE.BIN.
  1130.  
  1131. Being able to store files on more than one disk increases the program's
  1132. flexibility by allowing you to create seperate files for seperate family 
  1133. lines or split a database across several disks if the space is limited.
  1134. Each time ROOTS/M is loaded, the basefile you have chosen to use is load-
  1135. ed into the computer's RAM. The program is able to display information 
  1136. from the basefile quickly, because that basefile is stored in RAM. It 
  1137. does not have to take the time to search disks. This means, however,
  1138. that ROOTS/M cannot cross-reference between basefiles that are located
  1139. on seperate disks or between basefiles with different names stored on
  1140. the same disk. At one time, the program can use information stored only
  1141. in one basefile.
  1142.  
  1143.  
  1144. DELETING NON-ESSENTIAL FILES
  1145.  
  1146. At this point, ROOTS/M is ready to run. As your basefile grows there are
  1147. a few more changes you can make to increase the amount of storage space
  1148. on the disk. This applies primarily to those who use disks with a capa-
  1149. city of less than 128K, or those who plan to fill more than one basefile
  1150. on a single disk.
  1151.  
  1152. Since the program is designed to hold as many names as possible in the
  1153. file, anything you can do to assist in that direction will help. You 
  1154. can increase the amount of storage space by eliminating any unnecessary 
  1155. system programs. Use the "DIR" command to find out what is included on
  1156. the disk. If you are not sure which you will need, leave them alone for
  1157. now. As you work with ROOTS/M, you'll discover which routines will be
  1158. necessary, and then you can erase the excess files.
  1159.  
  1160. The disk directory can be examined when in the CP/M command mode. When
  1161. in that mode all CP/M utilities can be used to examine, copy, and delete
  1162. files. Some candidates for deletion are: unused console drivers;INSTRT.COM
  1163. ;unused CP/M utilities such as ASM.COM; the error display utility;
  1164. ERRORMSG.COM; and the sample database, BRIGHT.BIN.
  1165.  
  1166.  
  1167.  
  1168.                             CHAPTER  V
  1169.  
  1170.                           GETTING STARTED
  1171.  
  1172.  
  1173. Before using ROOTS/M make sure your equipment is in working order and 
  1174. that you have all that you need to run the program. Make sure all units
  1175. are connected properly and that the terminal and printer are "on line".
  1176.  
  1177.  
  1178. A WORD ON THE CARE OF THE DISK
  1179.  
  1180. You can't be too careful with floppy disks. Each is made of fragile
  1181. plastic material, much like that used for tape recorders, coated with
  1182. magnetic oxide and encased in a cover slip. They are quite sensitive
  1183. to temperature, humidity, touch, and especially magnetic sources, such
  1184. as television sets. Keep the disks away from magnetic fields, and store
  1185. them is a safe place. If you ever want to write on the disk cover, use
  1186.                                   18
  1187.  
  1188.  
  1189.  
  1190.  
  1191. a soft-tipped pen to avoid damaging the disk inside. Never turn a disk
  1192. drive on or off while there is a disk inside. Turn the power on first;
  1193. insert the disk. Remove the disk; then turn the power off. To guard
  1194. against accidential loss of valuable data stored on a disk, make copies
  1195. of all important material.
  1196.  
  1197.  
  1198. MAKE A COPY OF THE DISTRIBUTION DISK
  1199.  
  1200. Use the appropriate CP/M procedure to make a copy of the distribution
  1201. disk. Use the working copy of ROOTS/M and store the distribution disk
  1202. in a safe place.
  1203.  
  1204. For example, in a two-drive system use the CP/M command:
  1205.  
  1206.           PIP A:=B:*.*[V]
  1207.  
  1208. to copy the contents of the distribution disk in drive B to drive A.
  1209.  
  1210.  
  1211. TRANSFER THE CONSOLE DRIVER
  1212.  
  1213. ROOTS/M  is supplied with console drivers for many popular CRT terminals.
  1214. The program recognizes only console drivers named "COD.NRM", so you must
  1215. be sure that your terminal is named or renamed COD.NRM before proceeding.
  1216.  
  1217. Use the insert in the front pocket of the manual to find the name of the
  1218. console driver that applies to your terminal. The NOTES column of the 
  1219. table lists switch settings which must be made in the terminal you have
  1220. selected for use with ROOTS/M. The switch selections are generally hard-
  1221. ware or firmware options within the terminal that enable certain terminal
  1222. features such as full duplex operation.
  1223.  
  1224. Use the CP/M REName command if necessary to make sure your terminal's
  1225. console driver is named COD.NRM. Assuming the ROOTS/M disk is in drive
  1226. A, the format for this command is:
  1227.  
  1228.        A>REN COD.NRM=(your console driver).NRM
  1229.  
  1230.  
  1231. HOW TO LOAD ROOTS/M
  1232.  
  1233. ROOTS/M is loaded from the CP/M command mode by typing "ROOTS" and the
  1234. name of the basefile which contains the genealogical records you wish to
  1235. use during that session with the program. The ROOTS/M distribution disk
  1236. is supplied with a sample basefile named "BRIGHT.BIN" , and to load 
  1237. ROOTS/M with that file you would type, "ROOTS BRIGHT.BIN" or simply,
  1238. "ROOTS BRIGHT" .
  1239.  
  1240. You may create a basefile with any name you like when you load ROOTS/M.
  1241. To create a basefile from the CP/M command mode, type "ROOTS (filename)"
  1242. and press RETURN.
  1243.  
  1244. The program will respond by asking you to supply the date. A number of 
  1245. routines in ROOTS/M use the date to calculate ages. If you wish to omit
  1246. the date, you may press RETURN instead of entering a date. Once you have
  1247. specified a date or pressed RETURN, the ROOTS/M MENU will appear.
  1248.  
  1249.                                   19  
  1250.  
  1251.  
  1252.  
  1253.  
  1254. If ROOTS/M is located on a drive other than drive A, be sure to specify
  1255. that drive as the "default" drive before calling ROOTS/M. If using drive
  1256. B to load a basefile from drive C, for example, use this format:
  1257.  
  1258.      A>B:
  1259.      
  1260.      B>ROOTS C:BASEFILE
  1261.  
  1262.  
  1263. ERROR MESSAGES
  1264.  
  1265. If the file ERRORMSG.OVL is on the disk, the errors listed below will be
  1266. displayed automatically if an error is detected by the operating system.
  1267. Otherwise, use this table to interpret ROOTS/M errors.
  1268.  
  1269. -------------------------------------------------------------------------
  1270.    CODE    DESCRIPTION                          ACTION
  1271.     1      Not Enough Memory             More system RAM required
  1272.     2      File Read Error               Replace corrupt file from backup
  1273.     3      Basefile Corrupt              Same as 2
  1274.     4      Stack Error                   Restart program
  1275.     5      Directory Full                Transfer files to another disk
  1276.     6      Overlay Too Long              Custom DATMOD.OVL too long
  1277.     7      No Free Space on the Media    Same as 5
  1278.     8      Can't Close File              Reload program
  1279. -------------------------------------------------------------------------
  1280.  
  1281.  
  1282.  
  1283.                                    MENU
  1284.  
  1285. After you have supplied or chosen to omit the date, first to appear on 
  1286. the screen is the MENU which serves as a table of contents and as a door
  1287. into each of the seperate sections of the program. ROOTS/M consists of
  1288. nine routines: INSTRUCTIONS, LIST, FAMILY, TRACE, PRINT, RELATIONSHIP,
  1289. ANNIVERSARY, EDIT and then an EXIT routine. Each one of these will be
  1290. explained individually.
  1291.  
  1292.  
  1293. THE CURSOR
  1294.  
  1295. The cursor, which will first appear on the left-hand side of the      
  1296. INSTRUCTIONS line, is moved up and down the MENU with the terminal's
  1297. cursor control keys. The HOME key moves the cursor alternately to the
  1298. top and bottom of the MENU. 
  1299.  
  1300. You select any one of the nime routines by placing the cursor next to
  1301. the name of the one desired and pressing RETURN.
  1302.  
  1303. THE PROGRAM CONTROL KEYS
  1304.  
  1305. Just below the MENU is a line of designations that corresponds to various
  1306. keys on the keyboard that control the operation of ROOTS/M. These keys
  1307. and their functions are placed in the designation line when the are
  1308. active.
  1309.  
  1310. With the MENU on the screen, the designation "S=swap" appears in the 
  1311. designation line to show that the "S" key is active. Other legends that
  1312.                                   20 
  1313.  
  1314.  
  1315.  
  1316.  
  1317. appear during the course of the program are shown in the table below.
  1318. The RETURN and certain other keys are called for occasionally.
  1319.  
  1320. -------------------------------------------------------------------------
  1321.                        PROGRAM CONTROL KEYS
  1322. -------------------------------------------------------------------------
  1323. KEY  |   DESIGNATION  |              DESCRIPTION
  1324. -------------------------------------------------------------------------
  1325.  S   |   SWAP         |Exchanges f-table row f1-f5 with f6-f10 to enable
  1326.      |                |you to view all ten entries.
  1327. -------------------------------------------------------------------------
  1328.  \   |   MENU         |Pressing this key returns you to the main MENU to
  1329.      |                |enable you to make another selection.
  1330. -------------------------------------------------------------------------
  1331.  Y,N |   YES, NO      |Used in response to specific queries at various
  1332.      |                |points in the program.
  1333. -------------------------------------------------------------------------
  1334.  F,R |   FORWARD,     |Used in INSTRUCTIONS, LIST and ANNIVERSARY to page
  1335.      |   REVERSE      |backward and forward between multiple pages in the
  1336.      |                |routine. Used in FAMILY to move forward and back-
  1337.      |                |ward from one generation to another.
  1338. -------------------------------------------------------------------------
  1339. -------------------------------------------------------------------------
  1340.  
  1341. THE FETCH-TABLE
  1342.  
  1343. Perhaps THE most important feature of the program is the f-table, a data-
  1344. field linked to the ten numeric keys on the keyboard. The f-table, which
  1345. is a holding tank for individuals pulled from the basefile, does not
  1346. appear on the screen when the program is first called up. It can be 
  1347. thought of as a small file which appears on the screen that allows you
  1348. to sequester members of the family tree whom you wish to use while     
  1349. running ROOTS/M. The f-table is valuable because its contents do not
  1350. change as you move from one routine to another.
  1351.  
  1352. The table will accommodate the names of ten menbers of the family tree.
  1353. Although only five names appear at a time on the screen, pressing the
  1354. "S" key flips the table back and forth between the first and second 
  1355. five names when it is active. You can enter a name into the f-table
  1356. by placing the cursor next to a name and pressing a numeric key when
  1357. in the LIST, FAMILY, TRACE, or ANNIVERSARY routines.
  1358.  
  1359. With the LIST routine, for instance, you can get a listing of all or a
  1360. portion of the basefile. When you have such a listing, you may place
  1361. the cursor next to a name that appears and press one of the numeric
  1362. keys. The name selected will then appear in the table on the line that
  1363. corresponds to the key pressed. The designation line includes a space
  1364. for the ten numerals when each is activated by the program. Once you 
  1365. have entered an individual's name into the f-table during the running 
  1366. of one routine, you can leave that routine and return to the MENU with
  1367. the contents of the f-table intact.
  1368.  
  1369. Once the table is filled, you can continue to add names using numeric
  1370. keys, replacing an individual with a new name. The new name will be
  1371. painted over the old.
  1372.  
  1373.                         
  1374.  
  1375.                                   21
  1376.  
  1377.  
  1378.  
  1379.  
  1380.                            INSTRUCTIONS
  1381.  
  1382. Place the cursor on the INSTRUCTIONS line and press RETURN for a brief
  1383. overview of ROOTS/M.
  1384.  
  1385. The first page of instructions will appear. Notice that the designations
  1386. for the program control keys: "F=forward" ; "\=menu". The MENU key will
  1387. always return you to the MENU, either with one or two presses depending
  1388. upon where you are in a routine. This designation remains on the screen
  1389. at all times when you are anywhere but the MENU.
  1390.  
  1391. THE FORWARD and REVERSE KEYS
  1392.  
  1393. These keys allow you to view the contents of a file that is too long to
  1394. be contained on the screen. You can "page" back and forth through a long
  1395. listing using the two keys. If you are on the first page of a display,
  1396. you cannot move backwards, and therefore the "R=reverse" is not present
  1397. and the "R" key will not function. When you page forward once, the 
  1398. REVERSE key will become functional to allow you to move backwards to the 
  1399. previous page.
  1400.  
  1401. Move through the instructions using the FORWARD and REVERSE keys to get
  1402. an overview of the program and familiarize yourself with the program
  1403. control keys.
  1404.                               
  1405.                               NOTE
  1406.  
  1407. You may eliminate the instruction file from the disk once you have
  1408. become familiar with ROOTS/M. If you need the disk space, use the
  1409. command: 
  1410.  
  1411.           ERA INSTRT.OVL
  1412.  
  1413. when in the CP/M command mode.
  1414.  
  1415.  
  1416.  
  1417.  
  1418.  
  1419.                              CHAPTER VI
  1420.      
  1421.                         THE PROGRAM CONTENTS
  1422.  
  1423.                                 EDIT
  1424.  
  1425. EDIT allows you to build a basefile by creating a seperate "record" for
  1426. each individual that is part of your genealogical history. (You may also
  1427. modify the contents of each record that has been created and stored in 
  1428. the basefile.) The basefile, therefore, is a collection of records, each
  1429. of which contains information about a particular individual. Two indivi-
  1430. duals do not have to be related necessarily to be part of the basefile.
  1431. Many of ROOTS/M's functions, however are based on the relationship 
  1432. between individuals that is established during the EDIT session.
  1433.  
  1434. Each record contains a variety of spaces -or fields- for personal data
  1435. that are filled during EDIT. The fields are filled in two ways: some
  1436. fields -the Name and Date fields, for instance- are filled by typing
  1437. in the appropriate information from the keyboard; other fields -the
  1438.                                   22
  1439.  
  1440.  
  1441.  
  1442.  
  1443. Parents and Spouse fields, for instance- are filled by pressing numeric
  1444. keys that correspond to individuals who are in the f-table.
  1445.  
  1446. ROOTS/M uses the fields that are filled from the f-table to establish
  1447. the relationship between individuals -or records- as you enter them into
  1448. the basefile. The connection between parrents and children -the one that
  1449. establishes the succession of generations -is made when you fill the 
  1450. Parents field. The connection between spouses is made when you dill the
  1451. Spouse field or supply the date of marriage.
  1452.  
  1453. Since ROOTS/M relies on the f-table during EDIT to make connections be-
  1454. tween individuals in the basefile, some care should be taken when filling
  1455. the Parents and Spouse fields and the date of marriage. Incorrect infor-
  1456. mation in the Parents field, for instance, will prevent other ROOTS/M
  1457. routines from recognizing the relationship between a parent and off-
  1458. spring. That mistake will constitute a "break" in the family line and
  1459. subsequent generations will not be shown as related to generations prior
  1460. to the break. You may always correct a mistake in a record by deleting 
  1461. the incorrect information and re-entering correct information. Any
  1462. inadvertant break will disappear.
  1463.  
  1464. In all cases any incorrect information that is contained in a record 
  1465. may be deleted and replaced with correct information. The procedure for
  1466. creating new records and modifying existing records is covered in this
  1467. section of the manual.
  1468.  
  1469.  
  1470. SELECTING EDIT
  1471.  
  1472. When the MENU appears and there is no basefile on the disk, a message at
  1473. the bottom of the screen will say, "No Basefile- Use EDIT to create one."
  1474. (The distribution disk contains a sample basefile which may be erased 
  1475. from your working disk space before you start to build your own base-
  1476. file.)
  1477.  
  1478. Place the cursor on the EDIT line and press the RETURN key. Appearing
  1479. then will be the empty record field which you place the names of your
  1480. ancestors. The blank f-table appears at the bottom of the screen.
  1481.  
  1482.  
  1483. THE RECORD FIELD
  1484.  
  1485. You enter each new member of the family tree into this field, creating
  1486. a new record for each individual. There is room in the field for a 
  1487. name, a sex, birth, marriage and death dates and places, parents and
  1488. as many as four spouses. Names of the spouses and parents are entered 
  1489. from the f-table. All other data are entered from the keyboard.
  1490.  
  1491. There is also a place to attach a "flag" to any individual. You may 
  1492. wish, for instance, to keep track of relatives who are also working
  1493. on the family tree. Attaching a flag to an individual simply places
  1494. an asterisk next to his or her name when it appears elsewhere in the
  1495. program. The flag can mean anything you want. That's up to you.
  1496.  
  1497.  
  1498. CURSOR MOVEMENT
  1499.  
  1500. The TAB key moves the cursor in single jumps from one entry field to
  1501.                                   23
  1502.  
  1503.  
  1504.  
  1505.  
  1506. the next. (If your terminal does not have a TAB key, use Control-I by
  1507. pressing the Control and I keys simultaneously. Refer to the instruction
  1508. manual for the terminal if necessary.) The HOME key will always bring 
  1509. the cursor back to the beginning of the Name line. The cursor control 
  1510. keys will also move the cursor one space at a time or from one line to
  1511. the next.
  1512.  
  1513.  
  1514. CORRECTING ERRORS IN A RECORD
  1515.  
  1516. The contents of any record can be changed at any time during the run-
  1517. ning of ROOTS/M. Errors made when entering text can be corrected with
  1518. the BACKSPACE key if your terminal has such a key. On some terminals,
  1519. however, the backspace key is same as the left-arrow key. A potential
  1520. conflict, therefore, arises during EDIT when you wish to backspace with 
  1521. out deleting any characters. If your terminal has neither a unique 
  1522. backspace nor left-arrow key, you may use Control-B to backspace with
  1523. out deleting characters. Refer to the insert in the front of the manual
  1524. pocket for questions about ROOTS/M operation with a variety of terminals.
  1525.  
  1526. To erase the contents of the Name or Place fields, you may use the DELETE
  1527. key (labeled "RUBOUT" on some terminals). To delete the names of parents
  1528. or spouses, you may press the letter "N" in response to the prompt from
  1529. the program.
  1530.  
  1531.  
  1532. REGISTERING DOUBT ABOUT A DATE and "DOUBLE DATING"
  1533.  
  1534. Notice that after the spaces for birth, death and marriage dates, you
  1535. have the option, if you are not sure of the exact date, to make that
  1536. fact a part of the record. If you are unsure of any date, answer "NO"
  1537. to the question "Are you sure?" by placing an "N" in the space. This
  1538. causes a "(?)" to appear after the date in the TRACE routine and on 
  1539. the printed sheets. If you subsequently verify a date, you may eliminate
  1540. the doubt by changing the answer to the "Sure?" question from a "N" to
  1541. a "Y".
  1542.  
  1543. If you are sure of the date, the default response to the question is 
  1544. "Yes", and you can tab over the question.
  1545.  
  1546. When you encounter "double dates" it is best to make a decision to use
  1547. either the earlier or later date. It is advisable to use the later, or
  1548. Gregorian calendar, because several of the routines in ROOTS/M make this
  1549. assumption when computing the number of years since an event.
  1550.  
  1551.  
  1552. VERSION NUMBER and MEMORY COUNT
  1553.  
  1554. In the upper-left hand corner of the screen, a version number of the 
  1555. EDIT routine appears. As with the version number for the entire ROOTS/M
  1556. program, any inquiries about the function of the EDIT section should 
  1557. include this number.
  1558.  
  1559. At the upper-right in the field is the number of the record currently
  1560. on the screen. Since record numbers are assigned in the order you enter
  1561. individuals into the file, this number gives you a rough estimate of
  1562. how long that record has been in the file relative to other records.
  1563. You may also use the number to index documentation files if you wish.
  1564.                                   24
  1565.  
  1566.  
  1567.  
  1568.  
  1569. Midway down the screen a line keeps track of total number of records
  1570. you have used, the amount of space that those records occupy and the
  1571. amount of space left in the basefile.
  1572.  
  1573.  
  1574. THE FETCH TABLE
  1575.  
  1576. At the bottom of the screen the f-table appears for the first time. The
  1577. table will be blank at the outset of each editing session if you have 
  1578. not filled it with names using one of the other routines.
  1579.  
  1580.  
  1581.  
  1582.                       CREATING NEW RECORDS
  1583.  
  1584. BEGIN WITH AN OUTLINE
  1585.  
  1586. Always begin each editing session with an outline that includes the
  1587. names of and pertinent information about each ancestor that you wish
  1588. to add to the file. The best outline to work from is either a pedigree
  1589. chart or the family group sheet.
  1590.  
  1591. If this is the first editing session with ROOTS/M, it will help to have
  1592. a pedigree chart that includes at least three generations. In order to
  1593. see the complete operation of EDIT, you will wat to enter parents and
  1594. children of more than one generation. The demonstration here in the 
  1595. manual will cover the entry of your maternal and paternal grandparents,
  1596. your parents and then you.
  1597.  
  1598.  
  1599. *************************************************************************
  1600.                                                   Paternal Grandfather
  1601.                                                  --------------------
  1602.                                                  | 
  1603.                                                  |
  1604.                                     Father       |
  1605.                            ----------------------|
  1606.                            |                     |
  1607.                            |                     | Paternal Grandmother
  1608.                            |                     -----------------------
  1609.          Self              |                                   
  1610. ---------------------------|                      Patermal Grandfather
  1611.                            |                     ----------------------
  1612.                            |                     |
  1613.                            |                     |
  1614.                            |        Mother       |
  1615.                            |---------------------|
  1616.                                                  |
  1617.                                                  |  
  1618.                                                  | Paternal Grandmother
  1619.                                                  -----------------------
  1620.  
  1621.                     THREE GENERATION PEDIGREE CHART
  1622. *************************************************************************
  1623.  
  1624. START WITH THE OLDEST MEMBERS OF THE TREE
  1625.  
  1626. The editing sessions are easiest if you start by entering the oldest 
  1627.                                   25
  1628.  
  1629.  
  1630.  
  1631.  
  1632. individuals on the pedigree chart. The reason for this will become clear
  1633. as you become familiar with the routine. The parents field has to be 
  1634. filled from the f-table using numeric keys. The parents have to be in 
  1635. the f-table before they can be pulled from it into the records of their
  1636. offspring. Therefore, the parents have to go in first. Move from the
  1637. earliest generations toward the latest. That way you proceed consistently
  1638. from parents to children, who are then parents themselves to the children
  1639. of the next generation.
  1640.  
  1641. For fastest entry of records keep the following sequence in mind when
  1642. entering a family.
  1643.  
  1644.   1. Place the oldest pair of parents in the family you are entering 
  1645.      during a session into the f-table first.
  1646.  
  1647.   2. Create a record for all known offspring of those parents starting
  1648.      with the first born, whether or not you intend to refer to those
  1649.      individuals again during the session.
  1650.  
  1651.   3. Place in the f-table only the offspring that you wish to refer
  1652.      to later in the session.
  1653.  
  1654. At the beginning of each EDIT process when there are names in the 
  1655. f-table already, the computer will ask:
  1656.  
  1657.        "You may create a NEW record(press "Y") or alter
  1658.         one from the f-table."
  1659.  
  1660. When there are no names in the f-table (there will be none if this is
  1661. the first occasion to use EDIT), the cursor will appear in the Name
  1662. field and you may begin entering the first name.
  1663.  
  1664.  
  1665. ENTERING THE NAME
  1666.  
  1667. Start, then, with your paternal grandparents. Enter the name of your
  1668. grandfather. Spell his last name the way you will spell it consistently
  1669. throughout the editing session. Since the program recognizes upper- and
  1670. lower-case letters, as well as punctuation, you have a wide range of
  1671. choices. If you are to take advantage, though, of the programs ability
  1672. to store a name-string once and reuse it, you have to spell it the same
  1673. way each time you enter it, not "GRANDFATHER" one time and "Grandfather"
  1674. the next. Spelling the name differently will not affect the function of
  1675. any part of the program, but it will consume more memory than necessary.
  1676.  
  1677. Each record has room for a name up to 60-characters long, and it will
  1678. accept a sequence of as many as five separate name-strings for each
  1679. individual. A string of letters bounded by a space on either side  
  1680. constitutes a name; titles like "Sir" or "Jr." or "Esq." are counted
  1681. as single names. (Note: Do not place a comma between a surname and a
  1682. "Jr." or "Sir" that might follow it. The program will allow you to do 
  1683. this, but it will treat the comma as a part of the name-string. If you
  1684. place a comma after a name with a space following it, the name-string
  1685. may be stored twice- once with the comma and once without it.)
  1686.  
  1687. No one name can be longer than 16 letters. If you try to enter more than
  1688. 16 letters for one name or more than five names in the field, the com-
  1689. puter will notify you that you have exceeded the limit.
  1690.                                   26
  1691.  
  1692.  
  1693.  
  1694.  
  1695. Many genealogists prefer to use all capital letters for a surname.       
  1696. Although the practice is up to you, this may waste storage space if 
  1697. the name-string is used with both upper- and lower-case as in, for
  1698. instance, a middle name.
  1699.  
  1700.  
  1701. DATE OF BIRTH
  1702.  
  1703. Use the TAB key to move to the next line and the space marked "Born".
  1704. Use a "0" in the first place of the year field for birth dates before
  1705. 1000 A.D. Use the space bar to bypass an unused number in a single-
  1706. digit date. 
  1707.  
  1708. If you know the entire birth date, fill in the blanks in the order
  1709. designated- month-day-year. (The program will complete the abbreviations
  1710. of some months for you after you type one or more letters. The month
  1711. February, for instance, is the only month that begins with "F", and
  1712. once you type "F", the computer will supply the "eb".)
  1713.  
  1714. If you only know the year or the month and year but not the day of birth,
  1715. you may enter those combinations.
  1716.  
  1717. If you do not know your grandfather's date of birth, you may skip this
  1718. space and his name will be included in the file and appear in other
  1719. routines of the program with a date of birth designated "unknown" or
  1720. "??".
  1721.  
  1722. The cursor will automatically move to the space marked "Sure?". Register
  1723. some doubt if there is any by placing an "N" there.
  1724.  
  1725.  
  1726. PLACE OF BIRTH
  1727.  
  1728. There are two fields to the right of the "Where" request. You may enter
  1729. as many letters as will fit in the allocated space- cities, counties,
  1730. states, countries. Note that the right-hand field is the longer of the
  1731. two. Place names are displayed in their entirety in the TRACE routine
  1732. and on the printed family group sheets. But, space permits the display
  1733. of only one field on the pedigree chart; if both fields are filled, the
  1734. right-hand field only will be printed on the chart.
  1735.  
  1736. To conserve memory space, try to use only the right-hand field where 
  1737. possible. Abbreviate place-names as you wish. If you wish to record
  1738. counties, you will probably want to use the left-hand field for the 
  1739. city or town and the right-hand field for the county, state, or country.
  1740. This will cause the entire place- city, county, state and country- to
  1741. be printed out on the family group sheet, and only county and state or
  1742. country to be printed on the pedigree chart.
  1743.  
  1744. ROOTS/M stores place-names the same way that it does the names of
  1745. individuals. If the name of a place is used more than once, the program
  1746. stores the string only once and reuses it in all other references to 
  1747. that place. It is possible to add place-names, in some cases, and not
  1748. consume more memory space.
  1749.  
  1750.  
  1751.  
  1752.  
  1753.                                    27
  1754.  
  1755.  
  1756.  
  1757.  
  1758. SEX
  1759.  
  1760. Since the default in the field marked "Sex" is male, you need only enter
  1761. an "F" for females.
  1762.  
  1763.  
  1764. BIRTHDATES EARLIER THAN 1860
  1765.  
  1766. When the birthdate is earlier than 1860, the program will assume the 
  1767. subject is dead and place an "N" after the question "Still Living?".
  1768. If the subject was born after 1860, or no birthdate is entered, the 
  1769. default is "Y".
  1770.  
  1771.  
  1772. FLAG
  1773.  
  1774. If you wish to specially designate your grandfather for any reason, you 
  1775. may attach a flag, or asterisk, to his name by placing a "Y" in the 
  1776. space.
  1777.  
  1778.  
  1779. DATE OF DEATH
  1780.  
  1781. If your grandfather is no longer alive, enter the date of his death in 
  1782. the same manner as you did his birthdate. Verify or register doubt about
  1783. the date by typing "N". If he is alive, leave the space for a date blank.
  1784. Press the TAB key to move to the "Sure?" space. If you are sure he is
  1785. alive, press the TAB key to default, which is "Y".
  1786.  
  1787.  
  1788. PLACE OF DEATH
  1789.  
  1790. If your grandfather is still living- without a place of death -you may
  1791. enter his place of residence in the "Where" field.
  1792.  
  1793.  
  1794. FINISHING THE RECORD
  1795.  
  1796. At this point, when there are no names in the f-table, the cursor will
  1797. not move down to the lines marked "Father" and "Mother". Parents must
  1798. be entered into these fields from the f-table. When there are no names
  1799. in the f-table, you can proceed no futher with the record.
  1800.  
  1801. Your grandfather's record, therefore, is filled out as completely as
  1802. possible thusfar. To complete the record, return the cursor to the 
  1803. beginning of the Name line using the HOME key. Check to make sure 
  1804. you have entered all the information that you can, then press RETURN.
  1805.  
  1806. The computer will state:
  1807.  
  1808.        "You may now place this new record in the f-table (or 
  1809.         press "N")."
  1810.  
  1811. Since you are working from the earliest to latest generation in the 
  1812. pedigree, you will want to place your paternal grandfather into the
  1813. f-table so he can be used in the Spouse field of his wife and the 
  1814. Father field of his son, your father. The numeric f-table designations
  1815. on the screen will be active for the first time. Choose one of the
  1816.                                   28
  1817.  
  1818.  
  1819.  
  1820.  
  1821. corresponding keys and press it.
  1822.  
  1823. You will normally press the "N" key when you do not plan to refer again
  1824. to an individual during the editing session. If you did not want to 
  1825. place the record in the f-table, you could have pressed the "N" key.   
  1826. The computer would have saved the record in RAM without placing it in
  1827. the f-table.
  1828.  
  1829. Whether you placed your grandfather's name in the f-table or chose not
  1830. to, the computer will ask:
  1831.  
  1832.       "Do you want to update the disk?"
  1833.  
  1834. Answering by pressing the "Y" key will write the contents of the editing
  1835. session onto the disk, and return you to the MENU. Normally, you want to
  1836. update the disk at the end of an editing session. Here, there are more 
  1837. names to enter, so you should press the "N" key.
  1838.  
  1839.  
  1840. ENTERING THE SECOND RECORD
  1841.  
  1842. Once you have decided not to update the disk, the computer will ask:
  1843.  
  1844.      "You may wish to create a NEW record (press "Y") or alter
  1845.       one from the table."
  1846.  
  1847. To continue entering records, press "Y" key. (You could also pull a name
  1848. up from the f-table to alter information in the record by pressing the
  1849. appropriate numeric key.)
  1850.  
  1851. Enter the name of your paternal grandmother in the same way you did your
  1852. grandfather.
  1853.  
  1854.  
  1855. THE PARENTS FIELDS
  1856.  
  1857. After completing the place of death or resident field, the cursor will
  1858. move down to the parents field now because the f-table is not empty. 
  1859. The computer will state:
  1860.  
  1861.    "You may now (re)select parents from the f-table
  1862.     (Press "N" to delete)."
  1863.  
  1864. The names of parents and spouses must be entered from the f-table. There
  1865. are two spaces in the Parents field, one for a subject's mother and one
  1866. for that person's father. ROOTS/M automatically recognizes the sex of
  1867. individuals in the f-table; when you press a numeric key to place one
  1868. of the two parents into the Parents field, ROOTS/M will automatically
  1869. put the male parent in the space for Father and female parent in the
  1870. place for Mother. You do not have to use the cursor to move from one
  1871. space to the next. In fact, the cursor will not move between the spaces
  1872. in the Parents field. You enter the contents of the fields using the 
  1873. numeric keys that correspond to lines in the f-table. If you are mod-
  1874. ifying a record and want to change the identities of one or both of 
  1875. the parents, just press the appropriate numeric key to enter the correct
  1876. parents. If you enter a parent record accidentally, and the identities
  1877. of the parents are unknown, use the "N" key to remove both parents
  1878. from the current record.
  1879.                                   29
  1880.   
  1881.  
  1882.  
  1883.  
  1884. Since your grandmother's parents are not in the f-table, use the cursor
  1885. to move to the marriage field.
  1886.  
  1887.  
  1888. THE SPOUSE FIELD
  1889.  
  1890. When entering marriage records, it is important that you do not enter a 
  1891. date of marriage without a spouse if you intend to create a new record
  1892. for that spouse later. When both partners of a marriage are known, enter
  1893. the marriage date only after defining the second partner. In other words,
  1894. enter a date of marriage only when you can place the spouse in the 
  1895. Spouse field by pressing a numeric key, moving him or her up from the
  1896. f-table.
  1897.  
  1898. You must be somewhat careful when you enter marriage records, because 
  1899. you can indicate the existence of a marriage in more than one way:
  1900. ROOTS/M considers the entry of a marriage date as confirmation that
  1901. a marriage has occured; it also considers the entry of a spouse's name
  1902. as confirmation that a marriage has occured.
  1903.  
  1904. For example, if you were to create a record for your father and in the
  1905. marriage field, supply only a date of marriage -not the name of your
  1906. mother- ROOTS/M will confirm that a marriage has occured on that date.
  1907. After placing your father's record in the f-table, suppose you continue
  1908. to create a record for your mother. When you reach her marriage field,
  1909. you may enter your father from the f-table and also supply the date.
  1910. This establishes that your mother was married to your father, and it   
  1911. links the two by marriage for use in other ROOTS/M routines. The refer-
  1912. ence to your father in your mother's marriage field, though, causes
  1913. ROOTS/M to consider that as your fathers second marriage; his first
  1914. marriage was established when you entered only a date. The program
  1915. does not compare the two dates of marriage to see if they are the same,
  1916. and therefore, cannot know that only one marriage occurred.
  1917.  
  1918. You can avoid ambiguities by being sure that you never enter a marrage 
  1919. date by itself. You can enter a spouse without a date of marriage and 
  1920. register doubt about the date by placing an "N" in response to the 
  1921. "Sure?" question. Marriage files are optional and should only be used
  1922. when you wish to record either the name of the spouse or that the 
  1923. marriage actually took place. They are not needed to verify that a 
  1924. spouse existed to construct a family tree.
  1925.  
  1926. If, by accident, you do create an extra marriage for an individual by 
  1927. entering a marriage date without a spouse, you can delete the contents
  1928. in the spouse fields for that individual and start all over again on
  1929. that part of the record. Enter the date this time only when you can
  1930. enter the name of the spouse from the f-table. Make sure that all off-
  1931. spring of the marriage show both parents in the parents field. Update
  1932. the disk, and the basefile will be corrected to reflect the changes.
  1933.  
  1934.  
  1935. DATE AND PLACE OF MARRIAGE
  1936.  
  1937. Since your grandfather appears in the f-table, proceed to enter your
  1938. paternal grandparents' date of marriage. Register doubt if you have
  1939. any. Record the place of their marriage.
  1940.  
  1941.  
  1942.                                   30
  1943.  
  1944.  
  1945.  
  1946.  
  1947. Then, with the cursor in the Spouse field, the computer will state:
  1948.  
  1949.    "You may now (re)select spouse from the f-table
  1950.     (press "N" to delete)."
  1951.  
  1952. Press the numeric key that corresponds to the line in the f-table that
  1953. contains your grandfather's name.
  1954.  
  1955. The cursor will move to the next line to allow you to enter the name
  1956. of other spouses. You may enter as many as four marriages. After you
  1957. have completed the marriage record, press the HOME key, returning you
  1958. to the Name field. Press RETURN.
  1959.  
  1960. Place your paternal grandmother in the f-table with her husband, since
  1961. they will both be needed as parents for your father.
  1962.  
  1963.  
  1964. FINISHING THE GENERATION
  1965.  
  1966. When the computer asks if you wish to create a new record, press "Y"
  1967. and continue. Proceed to enter your maternal grandparents in the same
  1968. fashion as you did your paternal, and place them in the f-table.
  1969.  
  1970. In the f-table should appear the names of your four grandparents.
  1971.  
  1972.  
  1973. THE NEXT GENERATION 
  1974.  
  1975. Move to the next generation, that of your parents. Complete the top
  1976. half of your father's record, which should bring the cursor into the
  1977. Parents field. Enter your paternal grandparents from the f-table using
  1978. the numeric keys. Place your father in the f-table when his parents 
  1979. have been entered.
  1980.  
  1981. Create a new record for your mother. Enter her parents, your maternal
  1982. grandparents, from the f-table. Enter a marriage date and place and
  1983. then your father's name from the f-table. When her record is complete,
  1984. place her in the f-table, replacing one of the names that appears, or
  1985. press "S" and enter her name on a blank line of the table.
  1986.  
  1987.  
  1988. ENTERING THE THIRD GENERATION
  1989.  
  1990. Finally, the editing session reaches you. Both of your parents are in
  1991. the f-table, and it should be clear by now how to fill in your record.
  1992. The only data lacking on the pedigree chart is the name of your spouse
  1993. if you have one.
  1994.  
  1995.  
  1996. ENTERING ALL CHILDREN IN A FAMILY
  1997.  
  1998. Once your record is complete, you might want to create records for all
  1999. your bothers and sisters if you have them. In fact, it is a good idea
  2000. to enter siblings of an individual who is part of your family tree,
  2001. even though those siblings are not your direct ancestors. Enter them
  2002. at the same time along with your ancestors; their parents will already
  2003. be in the f-table. You will not want to put all siblings into the f-  
  2004. table unless you plan to follow-up with their children later on in the
  2005.                                   31
  2006.  
  2007.  
  2008.  
  2009.  
  2010. editing session.
  2011.  
  2012.  
  2013. ENTERING SIBLINGS IN ORDER, OLDEST TO YOUNGEST
  2014.  
  2015. When adding children from a family group sheet, for instance, the best 
  2016. way to enter them is in order of birth, from the oldest to youngest. 
  2017. When the birthdates of all the offspring are known, the computer will
  2018. keep track of them in order of oldest to youngest. When none of the 
  2019. birthdates are known, the computer will list them in other ROOTS/M
  2020. routines in the order that they are entered during the editing session.
  2021. So, if you know the order of birth of children in a family, but not
  2022. the birthdates, enter them oldest to youngest.
  2023.  
  2024.  
  2025. ENDING THE EDITING SESSION
  2026.  
  2027. When all the member of the three-generation pedigree chart have been 
  2028. entered, you are ready to place them onto the disk. After entering
  2029. the last individual into either the f-table or RAM, the computer asks:
  2030.  
  2031.    " Do you want to update the disk? "
  2032.  
  2033. Answering "N" to this question, as you have discovered, allows you to
  2034. remain in the EDIT routine. A "Y" answer will write the contents of 
  2035. the editing session onto the disk and return you to the MENU.
  2036.  
  2037. If you wish to leave EDIT without updating the disk, you may always
  2038. press the MENU key. If, perhaps, you make a series of mistakes and
  2039. want to eliminate the entire session, you may do so at any time with
  2040. the MENU key. Once that key is pressed, the computer will ask for 
  2041. verification with:
  2042.  
  2043.            " Are you sure? "
  2044.  
  2045. An "N" answer will return you to EDIT. A "Y" will instruct the computer
  2046. to delete the contents of the session. Appearing then will be the 
  2047. message:
  2048.  
  2049.     " Edit cancelled. BASEFILE.BIN reloaded. "
  2050.  
  2051. This message confirms that the original BASEFILE.BIN contents have been
  2052. restored in the computer's RAM. Nothing has affected the file stored on
  2053. the disk. If you abandon an editing session this way, the computer will
  2054. erase all ten f-table lines if you created any new records while in the
  2055. EDIT routine.
  2056.  
  2057. Anytime the computer prompts with " Are you sure? " and you are not 
  2058. sure, press "N", and you will have another chance to decide. Pressing
  2059. the MENU key and then the "N" key in response to the "Sure?" question
  2060. can be used to cancel the edit of the current record in the field. This
  2061. returns you to the question:
  2062.  
  2063.   "You may wish to create a NEW record (press "Y") or alter
  2064.    one from the f-table."
  2065.  
  2066. You can use this technique to view the contents of a single record 
  2067. without making any changes. After reviewing the contents of various
  2068.                                  32
  2069.  
  2070.  
  2071.  
  2072.  
  2073. records you may press the MENU key and then the "Y" key to return
  2074. to the MENU with the f-table left intact.
  2075.  
  2076.  
  2077.  
  2078.                         MAKING CHANGES
  2079.  
  2080.  
  2081. MODIFYING RECORDS
  2082.  
  2083. You may modify the contents of any record by deleting incorrect infor-
  2084. mation and re-entering correct information. An individual whose record
  2085. you wish to modify should appear in the f-table. When the computer asks
  2086. if you wish to create a new record or alter an old one, press the numeric
  2087. key that corresponds to the individual whose record you wish to modify.
  2088. Make the changes and update the disk when asked if you wish to store
  2089. the new information on the disk.
  2090.  
  2091.  
  2092. DELETING RECORDS
  2093.  
  2094. Once you enter a record into the file, that record occupies a certain
  2095. amount of space for the life of the file. In other words, once a record
  2096. has been created, it cannot be completely destroyed without eliminating
  2097. the entire file. Even if you eliminate the contents of a record using 
  2098. the DELETE key, there will always be a trace of that record occupying
  2099. space in the file. You can reclaim unwanted records by calling them
  2100. from the f-table and changing all the data to that of a new individual.
  2101. Once you have changed all the data in the record field, ROOTS/M will
  2102. treat that record as if it were brand new.
  2103.  
  2104.  
  2105.  
  2106.  
  2107.                                LIST
  2108.  
  2109.  
  2110. LIST lets you look at all the names contained in the basefile. It is a
  2111. good routine to select first (assuming you have a basefile) as a way 
  2112. of bringing into the f-table the names of individuals who you will want
  2113. to use in other routines. Once a listing appears on the screen, you may
  2114. place any name in the basefile into the f-table using the cursor and
  2115. numeric keys.
  2116.  
  2117.  
  2118. CHOOSING A NAME
  2119.  
  2120. LIST calls up the entire file or any portion of it when you supply an
  2121. identifying name-string. The computer will search every record for that
  2122. name-string and then list those found. The smallest name-string entered
  2123. is eligible as a reference -middle initials, titles like "Sir". As long
  2124. as each identifying name-string has been entered separately during the 
  2125. editing process, it can be used to single-out an individual in the 
  2126. basefile.
  2127.  
  2128.  
  2129.  
  2130.  
  2131.                                   33
  2132.  
  2133.  
  2134.  
  2135.  
  2136. GETTING A COMPLETE LISTING OF THE BASEFILE
  2137.  
  2138. If you wish to see a complete listing of the file, leave the name-string
  2139. blank and press RETURN. If you call up a large listing and all the names
  2140. will not fit on the screen, press " F " to view subsequent pages of 
  2141. listings. 
  2142.  
  2143. While viewing a listing, press the MENU key once which will return you
  2144. to the first page of the LIST routine where you can type another name
  2145. on the line. Pressing this key twice will return you to the main MENU.
  2146.  
  2147.  
  2148.  
  2149.                               FAMILY
  2150.  
  2151.  
  2152. The FAMILY routine allows you to look at any individual in the file, his
  2153. or her spouses and the offspring of each marriage. Using the FORWARD and
  2154. REVERSE keys it is possible to move forward and backward from generation 
  2155. to generation, staying with a single family line. At any point during 
  2156. the running of the routine, you may enter an individual that appears on
  2157. the screen into the f-table using the numeric keys.
  2158.  
  2159.  
  2160. SELECTING A FAMILY
  2161.  
  2162. Before you select FAMILY from the MENU, there must be at least one name
  2163. in the f-table, since the routine draws its subjects from that area. 
  2164. Once you have selected the FAMILY routine from the MENU, press the 
  2165. numeric key corresponding to the individual whose family you wish to 
  2166. see. That individual will appear at the top of the screen; his or her
  2167. spouse will appear on the line below. Their children will appear on
  2168. the lines following.
  2169.  
  2170. FAMILY displays dates of birth and ages of living members of the family,
  2171. the dates of death and the date of the marriage between the individual
  2172. at the top of the list and his or her spouse. At the left-hand side of 
  2173. the page are symbols which describe the familial characteristics of the
  2174. names that appear. One symbol identifies the subject of the display,
  2175. another the spouse of the subject, and then next to the offspring are
  2176. designations which identify the children who went on to have children
  2177. of their own, those who have no issue in the basefile and those with-
  2178. out issue but with marriage records in the file. A directory on the
  2179. FAMILY menu identifies each of the symbols.
  2180.  
  2181.  
  2182. MOVING FROM GENERATION TO GENERATION
  2183.  
  2184. Using the FORWARD and REVERSE keys, you can view the composition of 
  2185. families in either previous or later generations. To do so, place 
  2186. the cursor next to the name of the individual whose family you would
  2187. like to see on the screen, and press either the "F" or "R" key.
  2188.  
  2189. Placing the cursor on the name of a spouse on the list and pressing
  2190. the "F" key will display the composition of his or her family with 
  2191. him or her at the top. If he or she has had other marriages, all
  2192. spouses and all children will appear on the screen.
  2193.  
  2194.                                   34
  2195.  
  2196.  
  2197.  
  2198.  
  2199. Placing the cursor on either the head of the family or the spouse and
  2200. pressing the "R" key will display the composition of the family in 
  2201. which they were children.
  2202.  
  2203. Placing the cursor on the line of a child and pressing the "F" key will
  2204. result in a display of that individual as the head of his or her family,
  2205. showing any spouses and offspring. Press the "R" key(without moving the
  2206. cursor), and you will return to the previous display.
  2207.  
  2208.  
  2209. ORDER IN WHICH CHILDREN WILL APPEAR
  2210.  
  2211. In cases where the birthdates of the children are unavailable, offspring
  2212. appear on the list in the order that they were entered in the editing 
  2213. process. When all the children are entered with birthdates, they are
  2214. listed in order of oldest to youngest irrespective of the way they were
  2215. entered into the file. In cases where some of the children were listed
  2216. with a birthdate and some without, the program first lists the children
  2217. without dates in the order thy were entered and then lists the remaining
  2218. children with dates in the order of oldest to youngest.
  2219.  
  2220.  
  2221. MAXIMUM SIZE OF FAMILY
  2222.  
  2223. There is room on the screen to list a family with 23 members. In families
  2224. larger than 18, the f-table will disappear from the screen to make room
  2225. for a longer list. If the f-table has disappeared from the screen to make
  2226. room for a long list, you may still place any individual into it by 
  2227. pressing a numeric key. Doing so wil cause the f-table to return with 
  2228. the individual selected displayed within it. Should you then wish to
  2229. see the entire family list again, move the cursor to the top of the list
  2230. and press the "F" key.
  2231.  
  2232. Press the MENU key once to select another subject as family head and 
  2233. twice to return to MENU. (Note that the "family head" may be eithr male
  2234. or female- you cam view a very large family with several spouses by
  2235. listing spouses individually).
  2236.  
  2237.  
  2238.                                  TRACE
  2239.  
  2240.  
  2241. This routine displays the pedigree chart of a selected individual. Once
  2242. the chart appears on the screen, you may use the cursor to move about 
  2243. on it and place any name that appears into the f-table.
  2244.  
  2245.  
  2246. SELLECTING AN INDIVIDUAL
  2247.  
  2248. You will need at least one name in the f-table to enter the TRACE 
  2249. routine. Once the first page appears on the screen, you may select
  2250. the individual who you wish to appear at the top of the chart from
  2251. the f-table using a numeric key. For best results, select a relatively
  2252. recent individual, as TRACE can extend itself to earlier but not later
  2253. generations. That individual will appear at the top. Beneath the chart
  2254. in a box appear that person's vital statistics. There is no marriage
  2255. date included for the person on the top of the chart, since the spouse
  2256. is not part of the pedigree.
  2257.                                  35
  2258.  
  2259.  
  2260.  
  2261.  
  2262. MOVING ABOUT ON THE CHART
  2263.  
  2264. You may move the cursor to any point on the pedigree using three cursor
  2265. control keys corresponding to left, right, and up. When the cursor lands
  2266. on one of the ancestors, the name of that ancestor along with accompany-
  2267. ing data will appear beneath the chart and the computer will ask:
  2268.  
  2269.    "Do you wish to display on him/her? (if so, press "Y")"
  2270.  
  2271. An affirmative answer will recreate the chart with that individual at
  2272. the top. Any one display can only accout for six generations. Choosing
  2273. to display the pedigree of an individual in the earlest generation is
  2274. the same as viewing a more distant portion of the original subject's
  2275. pedigree. Notice that the numbers which appear at the edge of the screen
  2276. indicating generations away from the original subject of the display 
  2277. have changed when you place a new name at the top. The numbers still
  2278. refer to the number of generations away from the original subject. 
  2279. You may always return to the original subject of the pedigree by press-
  2280. ing the HOME key twice. Pressing the HOME key once will send the cursor
  2281. to the top of the chart.
  2282.  
  2283. When an individual already in the f-table shows up in the pedigree, the
  2284. number of the corresponding f-table line will appear in the space 
  2285. representing that ancestor. The f-table number will supersede the 
  2286. asterisk flag which will otherwise appear in the appropriate place.
  2287.  
  2288. At any time you may place a name from the chart into the f-table. To
  2289. reselect a subject for the display, press the MENU key once and then
  2290. again if you wish to return to the main MENU.
  2291.  
  2292.  
  2293.                             
  2294.                              PRINT
  2295.  
  2296.  
  2297. Print generates standard pedigree charts and family group sheets to aid
  2298. you in your research. You may want to send these along with requests for
  2299. information from relatives or archivists. The are also a good way to 
  2300. bring part of the computer's basefile along with you on research trips.
  2301.  
  2302.  
  2303. ACCOMMODATING YOUR PRINTER
  2304.  
  2305. The first time you use PRINT, you should make sure that the routine is
  2306. set to operate with your printer. You should only have to set the printer
  2307. attributes once as long as you do not change printers. Place the cursor
  2308. on the line at the bottom of the screen that allows you to set printer
  2309. options and press the "Y" key.
  2310.  
  2311. The program allows you to specify printer type, vertical line characters,
  2312. page length and pedigree chart page width. Use the up/down cursor control
  2313. keys to move the cursor next to the printer parameters you wish to spec-
  2314. ify and press the "Y" key to enter them in the program.
  2315.  
  2316. Press the MENU key to return to the first page of PRINT and place the
  2317. printer attributes onto the disk. Press "N" to return to the ROOTS/M
  2318. MENU without placing the printer functions onto the disk.
  2319.  
  2320.                                   36
  2321.  
  2322.  
  2323.  
  2324.  
  2325. SELECTING A FORMAT
  2326.  
  2327. To produce both the pedigree chart and the family group sheet you need
  2328. to have the individual whose pedigree of family you wish to see in the
  2329. f-table. You may also produce blank sheets by answering "Y" in response
  2330. to the PRINT request.
  2331.  
  2332. To print a pedigree chart, move the cursor to the pedigree designation 
  2333. on the PRINT menu and press either the appropriate numeric key or "Y"
  2334. key. If you have opted for a 132-column printout, each sheet holds five
  2335. generations(31 individuals). If your printer is limited to 72 or 80 
  2336. columns, or if you do not wish to use wide paper, the 72-column format
  2337. holds four generations (15 individuals) on each sheet. In either case,
  2338. the computer will continue the pedigree printout on as many sheets as 
  2339. are required to include all ancestors in the basefile, up to 255 sheets.
  2340. If you wish to print only a portion or a pedigree, pressing the MENU
  2341. key while the printer is running will stop the printout at the end of 
  2342. the page that is printing.
  2343.  
  2344. Where an individual has many spouses, only the spouse who is an actual
  2345. ancestor is included. On the printout of the pedigree, the main subject
  2346. or the individual on line one , has a space designated for a spouse.
  2347. Even if there is a record in the basefile for a spouse, that spouse's
  2348. name will not appear there. In cases where a subject has had more than
  2349. one spouse, the program will not distinguish between spouses and place
  2350. one there and not others. Since the spouse of the main subject is not 
  2351. part of the pedigree, leaving the space blank does not affect the 
  2352. composition of the pedigree. You may specify a spouse if you wish,
  2353. by writing in a name.
  2354.  
  2355. The family group sheet is selected the same way as the pedigree charts,
  2356. except that a 72-column format is used in all cases. You may specify
  2357. either a man or a woman as the head of the family, but the husband will
  2358. always appear at the top of the form. When the individual you select 
  2359. has had more than one spouse, ROOTS/M will print a seperate family group
  2360. sheet for each spouse. All spouses, however, will be listed on each form.
  2361.  
  2362. One other note. The print formats use almost all available lines on each
  2363. form. If you are using a printer with fan fold paper, be sure to adjust
  2364. the paper so that the first line is as close to the top of each sheet as
  2365. possible. If you are using roll paper, ROOTS/M will measure each form
  2366. length correctly, so you can cut the resulting pages to standard, 11-inch
  2367. length. You will also be able to use a three hole punch on the pages 
  2368. without worrying about losing any text.
  2369.  
  2370.  
  2371.                         RELATIONSHIP
  2372.  
  2373.  
  2374. This routine determines the relationship between any two individuals who
  2375. are located in the f-table. You will need to have at least two name in 
  2376. the f-table to use RELATIONSHIP.
  2377.  
  2378.  
  2379. CHOOSING TWO INDIVIDUALS 
  2380.  
  2381. Select two names from the f-table by pressing the appropriate numeric 
  2382. keys, and the computer will list their relationship as long as it is
  2383.                                   37
  2384.  
  2385.  
  2386.  
  2387.  
  2388. within eight generations. The routine keeps track of blood relationships
  2389. and not those by marriage.
  2390.  
  2391. The routine will also list the common ancestors of the two individuals
  2392. selected. Consult the figure here that illustrates how degree, a legal
  2393. term used to describe consanguinity, is derived for various relation-
  2394. ships. Essentially, "degree" is a measure of the number of steps you
  2395. must make on this chart to move from one individual to another.
  2396.  
  2397. If you wish to determine the relationship of two more individuals, press
  2398. the appropriate numeric keys.
  2399.  
  2400. Press the MENU key to leave RELATIONSHIP.
  2401.  
  2402.                               III
  2403.                              Great
  2404.                              Grand 
  2405.                              Parent
  2406.                            /       \
  2407.                    II  Grand        Grand 
  2408.                        Parent        Uncle or  IV
  2409.                      /     \  III       Aunt
  2410.              I  Parent      Uncle          \
  2411.                  / \  II       or           2nd
  2412.          *   SELF   Brother    Aunt          Cousin  V
  2413.              /        or          \  IV        \ 
  2414.      I   Child         Sister      1 st          2nd  
  2415.           /              \         Cousin        Cousin  VI
  2416.  II  Grand          III  Nephew        \   V       Once                              
  2417.      Child                 or          1st          Removed
  2418.                            Niece        Cousin         \  
  2419.                               \           Once          2nd
  2420.                              Grand         Removed       Cousin  VII
  2421.                          IV   Nephew          \            Twice
  2422.                                 or            1st  VI       Removed
  2423.                                  Niece         Cousin
  2424.                                                  Twice    
  2425.                                                  Removed
  2426.  
  2427.  
  2428.  
  2429.                               ANNIVERSARY
  2430.  
  2431.  
  2432. ANNIVERSARY displays all births, marriages and deaths that have occured
  2433. on a specified date. It allows you to check to see if important anniver-
  2434. saries are coming up or if you have just forgotten one.
  2435.  
  2436.  
  2437. CHOOSING A DATE
  2438.  
  2439. When you select the routine from the Menu, you will be asked to enter a
  2440. date. The computer will then search the files for all records containing 
  2441. the date you have selected and place them on the screen. If you wish to 
  2442. find out if "today" is the anniversary of any vital event, just press
  2443. RETURN without specifying a date. If you only specify only a month, the 
  2444. computer will search for dates entered with a month but not a day.
  2445.  
  2446.                                   38
  2447.  
  2448.  
  2449.  
  2450.  
  2451. On days when there are enough anniversaries to fill the screen, you may 
  2452. use the FORWARD and REVERRSE keys to page back and forth in the display.
  2453. You may also walk forward into the future, checking for anniversaries on
  2454. upcoming days, by pressing RETURN. Each RETURN will advance the date one
  2455. day. At any time you may place an individual from the display into the 
  2456. f-table.
  2457.  
  2458. To select a new date, press the MENU key once. Pressing it twice leaves
  2459. the routine.
  2460.  
  2461.  
  2462.  
  2463.                             EXIT
  2464.  
  2465.  
  2466. On the MENU when wishing to leave ROOTS/M to return to CP/M, place the
  2467. cursor on the EXIT line and press RETURN. The computer will ask you to
  2468. verify:
  2469.  
  2470.            "Are you sure?" (Y,N)?"
  2471.  
  2472. If you do wish to exit, press the "Y"; if not, "N", which returns you to
  2473. the MENU.
  2474.  
  2475. After you leave ROOTS/M through EXIT, the computer will be in the CP/M
  2476. command mode. The CP/M prompt will appear on the screen preceded by the
  2477. online drive designation. At thie point all the CP/M commands can be
  2478. used. Files can be examined, copied, renamed and erased. Make certain
  2479. that you have a backup copy of ROOTS/M files before attempting to alter
  2480. anything contained on the distribution disk.
  2481.  
  2482.  
  2483.                         A FINAL NOTE
  2484.  
  2485. The file you create while using ROOTS/M will become very large keeping
  2486. up with a successful genealogical search. Since the entry of ancestors
  2487. into the file takes a certain amount of time, a huge file represents a
  2488. significant investment. To avoid losing the family tree contained in 
  2489. the file, periodically make a copy of the file, and save it on a sep-
  2490. arate disk which can be stored in a secure place.
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.                                      
  2506.  
  2507.  
  2508.  
  2509.                                   39
  2510.  
  2511.  
  2512.  
  2513.  
  2514.                   PROVIDING YOUR OWN DATE ROUTINE
  2515.  
  2516. The ROOTS/M file named DATMOD.OVL contains an overlay module which pro-
  2517. vides the date to the program as entered by the user. Experienced assem-
  2518. bly language programmers may wish to incorporate their own date routines
  2519. in ROOTS/M  when an alternate source of the date is available, such as
  2520. from a hardware clock. The following information is provided as a guide
  2521. for those who may wish to incorporate a custom DATMOD.OVL in ROOTS/M.
  2522.  
  2523. The ROOTS/M date module is loaded by the ROOTS loader just before trans-
  2524. ferring control to RMS. The following rules must be observed if a custom
  2525. date module is to be used:
  2526.  
  2527.  1. The date module must be named " DATMOD.OVL ".
  2528.    
  2529.  2. The module entry point is 103H.
  2530.  
  2531.  3. The last instruction in the date module should be RETurn (C9H).
  2532.  
  2533.  4. The module must not occupy more than 4K bytes of RAM.
  2534.  
  2535.  5. The date module must use no more that 100 bytes of stack space.
  2536.  
  2537.  6. When the module is called, the cursor will be at the start of the
  2538.     third line which is the normal location for the date module name and
  2539.     version number. You may supply your own module name on this line if
  2540.     you wish.
  2541.  
  2542.  7. On entry the HL register pair will contain the address of the first
  2543.     of three bytes of data which hold the compacted date. Your custom
  2544.     module must write the current date into the three consecutive bytes
  2545.     in the following format:
  2546.             ((HL))         ((HL+1))       ((HL+2))
  2547.            YYYYYYYY        MMMMMMMD       DDDDOOOO
  2548.  
  2549.     The first byte contains the current year divided by 10, rounded     
  2550.     down. For example, 1986 would be entered as the binary equivalent
  2551.     of 198.
  2552.  
  2553.     The 7 most significant bits of byte 2 contain the binary equivalent 
  2554.     of the number of months that have elapsed since the base year desig-
  2555.     nated in byte 1. For example, January of 1980 would require that all
  2556.     of the "M" bits be zero, while July of 1986 would require that the 
  2557.     binary equivalent of 78 be entered in the 7 most significant bits of
  2558.     byte 2.
  2559.  
  2560.     The day of the month is designated by the least significant bit of
  2561.     byte 2 and the 4 most significant bits of byte 2.
  2562.  
  2563.     July 9, 1982 would be entered as follows:
  2564.             ((HL))         ((HL+1))        ((HL+2))
  2565.              C6H             3CH              90H
  2566.  
  2567.     All three bytes should be zero for a null date.
  2568.  
  2569.  8. If the DATMOD.OVL file is not included on the ROOTS/M disk, the 
  2570.     program will not ask for a date and a null date will be assumed.
  2571.  
  2572.                                   40
  2573.  
  2574. M disk, the 
  2575.     program will not ask for a date and a null date will be assumed.
  2576.  
  2577.