home *** CD-ROM | disk | FTP | other *** search
/ DP Tool Club 17 / CD_ASCQ_17_101194.iso / vrac / ezt222.zip / EZT222.INS / EZT.DOC next >
Text File  |  1994-09-09  |  25KB  |  460 lines

  1.                              EZ-TREE Version 2.2
  2.  
  3.                         *** Program Documentation ***
  4.  
  5. NOTE: EZ-Tree 2.2 will read files created with earlier versions of EZ-Tree,
  6. however files created with EZ-Tree 2.2 are not 100% compatible with version
  7. 1.00 through 1.26 of EZ-TREE.
  8.  
  9. EZ-Tree  is a genealogy  program to track  and report on  family trees. The
  10. program records  information in variable length records and fields with the
  11. following maximum field sizes:
  12.  
  13.                First Name . . . . . . . . . . .  16 characters
  14.                Middle Name  . . . . . . . . . .  16 characters
  15.                Last Name  . . . . . . . . . . .  16 characters
  16.                Maiden Name  . . . . . . . . . .  16 characters
  17.                Sex (M or F) . . . . . . . . . .   1  character
  18.                Birth Date & Information . . . .  58 characters
  19.                Death Date & Information . . . .  58 characters
  20.                Personal Comments  . . . . . . . 144 characters
  21.                Marriage Date & Information  . .  58 characters
  22.                Divorce Date & Information . . .  58 characters
  23.                Marriage & Divorce Notes . . . . 144 characters
  24.  
  25. You  can keep track of up to 16  marriages per person and up to 32 children
  26. per  marriage.  There is no logical  limit to the number of generations you
  27. can  have for  each family  tree.   There are  provisions currently  in the
  28. program  to handle 90  different family trees with  an allocated 60K buffer
  29. for  each tree. The number of names and marriages you can record per family
  30. tree  is dependent upon how much  information you enter per person. Testing
  31. has resulted in an average of 587 names with the low of 300 and the high of
  32. 874  Names. The  amount of names  recorded in  one tree does  NOT limit the
  33. program  however. This  version of  EZ-TREE incorporates  a LINKING feature
  34. where  you can LINK all the trees  together. This makes possible the amount
  35. of  names to be  52,830 and that's just  in one directory!  You can have as
  36. many directories as you want.  More on LINKING later on.
  37.  
  38.                            INSTALLATION AND SETUP
  39.  
  40. There  is only one  file (EZT.EXE) you need  to run EZ-Tree.   To start the
  41. program simply key in EZT and press the ENTER key.  The program will create
  42. other files that it uses to store information in.  They are:
  43.  
  44.            CONFIG.EZT  used  to store  program configuration info.
  45.            FAMILY.EZT  used to store an index to the family trees.
  46.            TREE1.EZT - TREE90.EZT stores all the family tree data.
  47.  
  48.                                   MAIN MENU
  49.  
  50. If you have a Microsoft Compatible Mouse, you can usually just CLICK on any
  51. of  the below functions  rather than using  the function key.  More help is
  52. available about the MOUSE when inside EZ-Tree.
  53.  
  54. To  choose an entry  from the main menu  use the up and  down arrow keys to
  55. highlight  the one you want to use, then press the ENTER key; or just press
  56. the  first letter of the entry.  The  first entry you may want to choose is
  57. the  Modify configuration  entry.   This lets  you choose  a different disk
  58. drive  and directory to store  the Family and Tree files  if you need to do
  59. that.   This would actually  allow you to use more  than 90 family trees by
  60. putting  90 families in each  directory you create for  that purpose.  Also
  61. with  this entry you  can change your  screen colors and  change the screen
  62. save time out feature that will blank out the screen after a certain amount
  63. of time.
  64.  
  65. The  next  entry you  will choose  is either  Create a  new family  tree or
  66. Retrieve  an existing one.  To create  a new one, choose the Create option,
  67. then key in a description of the family tree your creating.
  68.  
  69. You  can use up to 60 characters.  You are taken automatically to enter the
  70. FIRST name.  After that you would choose Work on the current family tree to
  71. start  entering the detailed  information.  If you  already had some family
  72. trees  created and  chose the  Retrieve  a family tree entry,  you would be
  73. presented  with a list of available family trees.  To choose one use the up
  74. or  down arrow keys to highlight (or CLICK)  the one you want and press the
  75. ENTER key.  Then you would choose Work on current family tree.
  76.  
  77. The  remaining main menu entries allow you  to save the family tree on disk
  78. any time while your working on it or to delete the current family tree from
  79. the index and from your disk. The remaining choices allows the Editing of a
  80. Family Tree Name, Utilities/Disk Functions, Modifying program configuration, 
  81. and Exiting the program.
  82.  
  83.                            MODIFY CONFIGURATION
  84.  
  85. It is here that you can make color choices,  ScreenSaver  type/speed, sound
  86. off/on, date style, printer options, ect.   Most are  self explanatory and
  87. all have defaults.
  88.  
  89.                              PRINTER OPTIONS
  90.  
  91. The  default  printer codes  are for  EPSON, STAR, and  IBM  Proprinter and
  92. compatible printers. Everything should work with little or no modification.
  93. If your printer is not  compatible with  one of the  above then simply look
  94. up the appropriate codes for the functions listed in the printer set up menu
  95. and  enter  those  numbers.  Enter all  printer  codes in  decimal  format. 
  96. They usually are all preceded with the decimal number 27.  Enter  the codes
  97. that appear in your printer  manual for all fields.  If  you are  unable to
  98. find the right number, use the field for  something else or  leave it blank. 
  99.  
  100. Example: For the above listed printers the code to select the IBM character
  101. set is  27,116,49  or  27,116,1. Enter either set of numbers  separated  by 
  102. commas. Keep in mind that any one number cannot be over 255.  Also, you may
  103. combine numbers... using the above  example we  will also  make the printer
  104. use (double-strike printing), [handy for worn out ribbons].  In  the  space
  105. provided for IBM Mode in the printer set up menu place the following.....
  106. 27,116,49,27,71   that's it... experiment.... and if all  else  fails, most
  107. printers can be configured at the printer panel.
  108.  
  109.               **** Don't Forget To SAVE Your Configuration ****
  110.  
  111.  
  112.                           WORKING ON A FAMILY TREE
  113.  
  114.  
  115. You  start by keying in information about  the first person you want to add
  116. to  the family tree.  A good place to  start is by  entering your own name.
  117. Pressing ENTER takes you to the next field until all fields are used.  Then
  118. the  person's name is displayed  in a box in the  upper left hand corner of
  119. the  screen and a  function key menu is  displayed below it.   Press the F1
  120. (help)  key to see  the details of what  each key on  the keyboard will do.
  121. Press  any key to return.  You can  now add parents to the person you keyed
  122. in or add a spouse.  The top two boxes are always used to display a husband
  123. and wife  if there is  a marriage.  Children  are added and displayed below
  124. the  couple.  The ESCAPE key can be used  at any time to cancel or back out
  125. of any  procedure. If in doubt about what to do next, see A TYPICAL SESSION 
  126. later on in this document.
  127.  
  128.                           ***** PLEASE NOTE *****
  129.  
  130. EZ-TREE retains all entries and/or changes in memory. You MUST save the TREE
  131. your working on before powering down or exiting EZ-TREE.  In most  cases you
  132. will be  asked if you want to  save  changes. Be  sure to  SAVE your work by 
  133. choosing [Save Current Family Tree] from the Main Menu.
  134.  
  135.             ***** Always Make Back-Up Copies Of Your Work *****
  136.  
  137.  
  138.  
  139.                           ******** NOTICE ********
  140.  
  141.     We have had some feed back on children ending up married to their
  142. Fathers... ect.  This  happens  because  people forget that when entering
  143. children, spouse's, and  parents the  program  WILL add your entry to the
  144. person who is in the upper left hand corner of the  screen or in the case
  145. of a unmarried person, in the  middle of the screen,  REGARDLESS of where
  146. the HIGHLIGHT BAR is.  Also anytime you are adding a spouse, children and
  147. Parents, keep an eye on the LOWER left hand  corner of the  screen for it
  148. always tell's you to WHO and WHAT your doing. 
  149.  
  150.  
  151.                          ENTERING DATES and CTRL "F"
  152.  
  153. When  entering date ie. Date and Place of Birth and Date and Place of Death
  154. this  format should  be used:  1/2/1990 - St. Louis, Mo.  or  1-2-1990: St.
  155. Louis, Mo. After typing either of these examples in and pressing ENTER, EZ-
  156. Tree will change it to 01-02-1990. The program will attempt to evaluate the
  157. dates  to  be used  in the  Tree Statistics.  Even if  you typed  1882, the
  158. program  would change  it to  00-00-1882.  If you typed  1-1-90 the program
  159. would  change it  to 01-01-1990  and so on.  ALWAYS  place the  DATE at the
  160. beginning  and any other information after the date.  For those of you that
  161. have  trees created with any previous versions of EZ-Tree just load in that
  162. tree and press CTRL "F".  The function will check all the dates in the tree
  163. and change them if necessary.  You may change Date Styles via the Configur-
  164. ation menu to meet your requirements of EUROPEAN or USA DATE FORMATS
  165.  
  166.                                    REPORTS
  167.  
  168. Presently  there  are  six reports  that can  be produced  by using  the F9
  169. key or clicking on Reports.  Detailed information can be obtained about the
  170. person  currently highlighted by the cursor, a report on  all people in the
  171. current family tree,  a list of all  descendents for the person highlighted
  172. by the cursor, a Pedigree Chart for the person currently highlighted by the
  173. cursor, and a Inquiry form for information on the highlighted person.
  174.  
  175.                                TREE STATISTICS
  176.  
  177. Tree statistics reports facts found in and about the tree you are working in.
  178. This report ONLY prints to the screen.
  179.  
  180.  
  181.                    HIGHLIGHTED PERSON / REPORT ALL RECORDS
  182.  
  183. The  detailed  report and the  report on all people have  reference numbers
  184. listed  in  front  of  each  person.   These  numbers  allow  you to locate
  185. information  on a  person  by that reference number  because the report  is
  186. produced in  reference  number sequence.  You  can use  CTRL "O" to jump to
  187. that person while in the main  viewing screen. Both of these reports may be
  188. printed to the screen or printer.
  189.  
  190.                              DESCENDANT CHART
  191.  
  192. The descendents report puts an asterisk in front of people who are related
  193. by marriage,  but are not actually in the blood line.   Lines  connect all
  194. descendants in a TREE fashion.  The listing can be directed to your printer
  195. or screen and can be cancelled any  time by pressing ESCAPE.
  196. Depending on how you set up the  printer  configuration  determines  if the
  197. connecting  lines will be printed  (as it's  printed on the screen) or just
  198. indented.  If you have a printer that prints IBM graphic characters and you
  199. have entered the code in the PRINTER OPTIONS, the  connecting lines will be
  200. printed. If your printer does not support IBM graphics then the  Descendant
  201. chart will be indented and no graphics will be printed.
  202.  
  203.                                PEDIGREE CHART
  204.  
  205. This chart reports in a reversed fashion the (pedigree) of the highlighted
  206. person. It will report back four generations from the  highlighted person,
  207. if output is directed to the printer and three if output is to the screen.
  208. You must have a  condensed mode for 80  column  printers or a  130  column
  209. printer for this report to print out correctly.
  210.  
  211.                                PRINT INQUIRY
  212.  
  213. This report is useful for obtaining information on the highlighted person.
  214. It will report  everything you have  entered  about that  person and leave
  215. (blanks) on the information you don't have.  It will  print all  marriages
  216. you have  entered plus two more, blank places for  marriages  someone else
  217. knows about. Each marriage space also has  spaces  for ten  children names
  218. and birth/death information.  Simply  print  this out and mail it off to a
  219. relative or  friend and have them  (fill in the blanks).   This  chart may
  220. only be printed to the printer.   We  suggest a short cover letter be sent
  221. along. This can be printed with your favorite word processor.
  222.  
  223.                          OUTPUT TO SCREEN / PRINTER
  224.  
  225. To change the output device click on or cursor to  OUTPUT TO ... It will
  226. toggle to either SCREEN or PRINTER. 
  227.  
  228.                            LINKING TREES TOGETHER
  229.  
  230. The  CTRL F4  and  CTRL F6  keys are  used to  link family  trees together.
  231. Pressing  CTRL F4 would tell EZ-TREE that the person in the upper left hand
  232. corner of the screen's Father is listed in another tree.  Before using this
  233. function preparations must be done first.  A tree must be created  with the
  234. person's  name that's highlighted in the upper left hand corner of the tree
  235. you are working on.  Also, that person's  parents must be put in that tree.
  236. Always  keep in mind that when linking trees the names that are linked must
  237. be an EXACT MATCH (First, Middle and Last Names) in each of the trees.  The
  238. decision when  to branch to another tree  is dependent on how you  want the
  239. genealogies structured and/or how many  names you expect to have in a tree.
  240. If  you do  not have  a lot of information on your family then put everyone
  241. in one tree.  Remember however, each tree can only hold so much information
  242. but you can branch off at any time to another tree.
  243.  
  244. The  CTRL F6 key tells EZ-Tree that  the person's Genealogy is continued in
  245. another tree. Keep in mind the preparations that are mentioned in the above
  246. paragraph.
  247.  
  248. DELETING LINKS can be achieved by choosing the LINKING  option  again.  You
  249. will be asked to verify with a (Y)es or (N)o.
  250.  
  251. Another  function available is CTRL PgDn.   This function will MOVE a child
  252. from one parent to another parent in  the SAME tree!  Use caution with this
  253. option!  It is  possible to move  a PARENT to  a CHILD of  that Parent thus
  254. invoking a continuous loop.  If you accidently put someone in a family that
  255. really  belonged  to  another  family  just  highlight  that  person  (when
  256. displayed  as a child) and press CTRL PgDn.  Eligible Parents will begin to
  257. be  displayed.  When the correct  parents are  display answer  Yes and that
  258. person  (along with ALL of that person's  descendants) will be moved to the
  259. NEW parents.
  260.  
  261.                             REMOVING SAMPLE FILES
  262.  
  263. To remove sample  family tree files:  first, retrieve the file, then choose
  264. "Delete Family Tree" from the main menu.
  265.  
  266.                               A TYPICAL SESSION
  267.  
  268. This  is presented as a guide for those that the LINKING procedure is still
  269. a bit vague.  Follow these steps to see how to use linking. For the sake of
  270. shortening the demonstration  we will only  fill in the  names of the people
  271. and not the D.O.B., D.O.D, etc.. and we will use hypothetical names:
  272.  
  273. My name is John Smith and I am married to Dora Smith (Nee Doe). We have two
  274. children, Carla and James. Boot EZ-Tree by typing EZT. Begin the session by
  275. choosing (C)reate new Family Tree.  Type in the name  of the tree,  in this
  276. case  we will  type SMITH  FAMILY TREE.  Press ENTER.  A blank  record will
  277. appear requesting information for the first person.
  278.  
  279. Fill in First:  JOHN  and Last:  SMITH  then press PgDn.  You will be taken
  280. back  to the Main Menu.  Choose (W)ork On Current  Family Tree. You are now
  281. looking  at the main  tree display and the  name JOHN SMITH  will be in the
  282. center of the screen. Now press F6 (add spouse).  Another Blank Record will
  283. appear  and in the lower left hand corner of the screen you'll see HUSBAND:
  284. JOHN SMITH.  Now fill in the spouse record First: DORA  and Last: SMITH and
  285. Maiden: DOE, pressing ENTER on each  field and pressing PgDn when finished.
  286. Now another Blank Record will appear. This is the Marriage Information. You
  287. can  just go ahead and  press PgDn for the sake  of shorting this demo. Now
  288. The Tree Display reappears with JOHN SMITH  and DORA SMITH appearing on the
  289. top line.  Now press F8 and add  the children CARLA first and JAMES second.
  290. After  answering  all  the  prompts  and pressing  ENTER  and  PgDn  at the
  291. appropriate times, you should now be looking at a tree displaying:
  292.  
  293.                           JOHN SMITH    DORA SMITH
  294.                                  CARLA SMITH
  295.                                  JAMES SMITH
  296.  
  297. Now  press F4.  We will  now enter JOHN SMITH'S parents  which are  WILLIAM
  298. SMITH and HELEN SMITH.  Enter these names  watching the prompts on who they
  299. are ie, Husband, Wife, Father, Mother, Etc. After answering all the prompts
  300. and  pressing ENTER and  PgDn at the  appropriate times, you  should now be
  301. looking at a new tree displaying:
  302.  
  303.                         WILLIAM SMITH    HELEN SMITH
  304.                                  JOHN SMITH
  305.  
  306. I have a brother TIM.  While my Mom and Dad's family is displayed let's add
  307. him.  Press F8 (add child) and add TIM. Always pay careful attention to who
  308. it  is you are  adding to and  their sex (M)  or (F). After  adding TIM the
  309. display will show:
  310.  
  311.                         WILLIAM SMITH    HELEN SMITH
  312.                                  JOHN SMITH
  313.                                  TIM  SMITH
  314.  
  315. To see  JOHN'S Family, highlight  him and press F3.  After playing with the
  316. keys press Escape and save the TREE. (Just answer the question Yes). We are
  317. back to the Main Menu. Now Choose (C)reate New Family Tree once again. Type
  318. in DOE FAMILY TREE and press ENTER.  You are prompted to Add The First Per-
  319. son again.  This will be DORA SMITH (my wife).  Type in the information and
  320. press PgDn.  We're back to the Main Menu.  Choose (W)ork on  Current Family
  321. Tree Again.  The Tree Displays  DORA SMITH  in the  middle  of the  screen.
  322. Press F4 (add parents),  DORA'S Parents are  JOSEPH and DONNA DOE.  Type in
  323. these names, pressing ENTER and PgDn at the appropriate places. After doing
  324. this the display will show:
  325.  
  326.                            JOSEPH DOE    DONNA DOE
  327.                                  DORA SMITH
  328.  
  329. Now  move DORA SMITH To the Top (highlight her and press F3 or mouse users:
  330. move  cursor to her and  press right button).  DORA SHOULD BE IN THE CENTER
  331. TOP  LINE  OF THE  SCREEN.  Now comes  the linking.  Since  we  know DORA'S
  332. Marriage,  Kids and Husband are recorded  in the SMITH family tree, there's
  333. no need of typing all this information in again in this tree so we tell EZ-
  334. Tree this by pressing  CTRL F6.  A  overlay will appear  with the available
  335. tree names.  Pick the SMITH FAMILY TREE.  After doing this a window appears
  336. telling you that DORA's genealogy is continued in the SMITH FAMILY TREE and
  337. asks  if you  want to  go there.  Answer Yes  and answer  the (save changes
  338. prompt) yes also.  We now should be in the SMITH FAMILY TREE and the screen
  339. should show:
  340.  
  341.                           DORA SMITH    JOHN SMITH
  342.                                  CARLA SMITH
  343.                                  JAMES SMITH
  344.  
  345. Since  DORA is in  the UPPER left hand  corner, we can  go ahead finish the
  346. link by telling EZ-Tree that DORA'S Parents are in another tree. Press CTRL
  347. F4.  Once again the overlay appears with all the tree names. Cursor down to
  348. the DOE FAMILY TREE and press enter (mouse users place cursor on DOE FAMILY
  349. TREE  and press button).  The overlay disappears.  Now press PgUp. A window
  350. appears  indicating that DORA'S parents are in the DOE FAMILY TREE and asks
  351. if you want to go there. Answer yes. Then answer the Save Changes yes also.
  352. You  now are back in the DOE Family  tree. The LINKING is complete for DORA
  353. SMITH (DOE).  At any time you highlight her or print reports  or descendant
  354. reports  EZ-Tree will get her record no matter what tree your in.  Since we
  355. are  in the DOE FAMILY  TREE try pressing F9  and choose descendants to the
  356. screen. As you see the program retrieved DORA'S Marriage, Kids, and Husband
  357. out of the SMITH FAMILY TREE and returned to the DOE FAMILY TREE.
  358.  
  359.                          *** PROBLEM RESOLUTION ***
  360.  
  361.     If EZ-Tree locks up for you, try this command first:   SET NO87=NONE
  362.     Start-up switches: /K = Keyboard only (no mouse) /M = Mono (no color)
  363.     /V = Video (used to fixed video problems on some screens)
  364.  
  365.           ***  EZ-TREE 2.1C Changes and/or Modifications  ***
  366.  
  367. (1) - Fixed number of generation printing error in NON-IBM mode.
  368. (2) - Fixed editing Tree Name then aborting problem.
  369. (3) - Documented deleting link function.
  370. (4) - Added Utility and Disk Function Menu.
  371. (5) - Added Ability to search all trees with search function.
  372. (6) - Added Report menu stays on screen until user exits.
  373. (7) - Added ability to enter foreign characters.
  374. (8) - Added When retrieving a TREE, Pressing first letter of Tree Name moves
  375.       HIGHLIGHT bar to next available match.
  376.  
  377.          ***  EZ-TREE 2.1D Changes and/or Modifications  ***
  378.  
  379. (1) - Corrected erroneous (spouse) record number when printing reports.
  380.  
  381.           ***  EZ-TREE 2.2 Changes and/or Modifications  ***
  382.  
  383. (1) - Added Sound On/Off (Located In Configuration Menu).
  384. (2) - Added device selected in REPORTS remains selected after exiting.
  385. (3) - Corrected when going to Father now finds right Mother also when Father
  386.       has more than one marriage.
  387. (4) - Added another screen saver, moving blocks with 3 speed settings.
  388. (5) - Added override (allows input of a record number) - CTRL "O".
  389. (6) - Added to SEARCH: Search will now search Maiden Names, show Father's
  390.       name, and will show date of birth of persons that it matches.
  391. (7) - Added in Reports Menu: Record reports now prints Mother & Father.
  392. (8) - Added to REPORTS: Pedigree Charting and Inquiry Printing.
  393. (9) - Added PRINTER OPTIONS In Configuration Menu.
  394.  
  395.  
  396.                 FOR MORE INFORMATION, SUGGESTIONS, & PROBLEMS
  397.  
  398.                          CompuServe Mail 73057,3113
  399.                                 or Write to:
  400.                               MicroFox Company
  401.                                 P.O. Box 447
  402.                            Richfield OH 44286-0447
  403.                                    U.S.A.
  404.  
  405. ***      Use this form to order the EZ-Tree Published User's Guide      ***
  406. ***      and to receive the latest upgraded version of the program.     ***
  407.  
  408. MicroFox Company                           22A         Date _______________
  409. PO Box 447
  410. Richfield OH 44286-0447                    Telephone Orders: (216) 659-9489
  411. USA                                        Technical Support (314) 540-2927
  412.  
  413.  
  414. EZ-TREE Registration:   $39.00 U.S. each   Quantity _____ Amount __________
  415.  
  416. Includes the published manual and latest version on 3.5 _____ or 5.25 _____
  417.  
  418. Please include Shipping Charges:  $3 USA,  $4 Canada,  $7 Others __________
  419.  
  420. Ohio residents add 6.25% Sales Tax ________                TOTAL __________
  421.  
  422. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  423.  
  424. VISA or MasterCard (EuroCard/Access) Number _______________________________
  425.  
  426. Expiration Date ________  Signature:_______________________________________
  427.  
  428. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  429.  
  430. Name ___________________________________________ Phone ____________________
  431.  
  432. Address ___________________________________________________________________
  433.  
  434.  __________________________________________________________________________
  435.  
  436.  __________________________________________________________________________
  437.  
  438.  __________________________________________________________________________
  439.  
  440. NOTE  1. All prices shown are in U.S. Dollars.
  441.       2. Remember to include shipping charges on all orders.
  442.       3. Ohio residents, add the state sales tax to the total amount.
  443.       4. If paying by credit card, specify the expiration date and sign it.
  444.       5. if paying by check, make it payable to MicroFox Company.
  445.          USA or Canada:  Make checks in U.S. Dollars or equivalent Canadian
  446.          Dollars.  Other countries: make cheques in your own currency equal
  447.          to the U.S. amount.  Do -NOT- send cheques in U.S. Dollars if they
  448.          not drawn on a U.S. or Canadian bank.
  449. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
  450.  
  451.                           Comments or Suggestions
  452.  
  453.  __________________________________________________________________________
  454.  
  455.  __________________________________________________________________________
  456.  
  457.  __________________________________________________________________________
  458.  
  459.  __________________________________________________________________________
  460.