home *** CD-ROM | disk | FTP | other *** search
/ Shareware Overload / ShartewareOverload.cdr / busi / graftree.zip / README < prev    next >
Text File  |  1989-12-20  |  6KB  |  133 lines
  1.                        GRAFTREE.A01
  2.  
  3.  Copyright Bill Beinert, 1989.    Compuserve 76407,132.
  4.  
  5.  
  6.                      FILES INCLUDED
  7.  
  8.    README         - This file.
  9.    GTIBMA01.EXE   - The version for IBM compatible printers.
  10.    GTLQA01.EXE    - The version for Epson LQ series printers.
  11.    SAMPLE.DOC     - a sample input file
  12.  
  13.  
  14.  GRAFTREE produces a graphic family tree in a descendant format sideways
  15. on Epson LQ and IBM compatible printers.  Each descendant is enclosed in a
  16. box, with his or her birth and death dates, and first 2 spouses or dates
  17. for a sole spouse.
  18.  
  19.  GRAFTREE takes as its input the Descendant Chart produced by The Family
  20. Edge, which must be written to disk prior to running GT.  It is
  21. essential that the report be prepared in the format GT is prepared to
  22. accept, otherwise unpredictable results can occur.  The toggles for
  23. producing the correct report format are listed below.  With Carl York's
  24. permission, a sample report is enclosed.  The file name is SAMPLE.DOC.
  25.  
  26.  GRAFTREE is supported in 2 versions:
  27.  GTIBMA01.EXE supports IBM and compatible dot matrix printers. It should
  28. work on any printer that accepts IBM graphics commands, either 9 or 24
  29. pin.  If you have a 24 pin printer, try GTLQA01.EXE, which should work on
  30. any Epson LQ series 24 pin dot matrix printer or any printer that can
  31. emulate one.  The LQ version is very much faster than the IBM version.
  32. Both produce Near Letter Quality output.
  33.   A note on pin spacing: 9 pin printers support a line feed of 1/216 inch.
  34. Epson LQ printers 1/180 inch.  This means that the IBM version will
  35. print OK on the Epson LQ but the logical page will be longer,
  36. resulting in boxes being printed over the perforations.
  37.  
  38.  
  39.                         INSTRUCTIONS
  40.  
  41.   1) Use The Family Edge to create a descendant chart of a chosen
  42.      individual.  Use the following toggles:
  43.  
  44.      ^C - COMPUTER ID numbers WILL be carried to the printed forms.
  45.           This is important even though they don't show up in the output.
  46.      ^D - Avoid date formats that use - (dash). Any of the others should
  47.           be OK.
  48.      ^G - Choose 7 or less. If you choose more, GT will ignore anyone
  49.           past the 7th generation. You will get faster results if you
  50.           choose 7 or less.
  51.      ^O - Order of names is LAST NAME FIRST.  GT will print them first
  52.           names first.
  53.      ^P - Printer output is going to the document file "ddmmmyy.DOC".
  54.           This is absolutely essential.  The PRN format contains printer
  55.           control codes that will confuse GT.
  56.  
  57.      The other toggles aren't relevant to GT.
  58.  
  59.   2) Exit The Family Edge.  You should only have 1 report in the
  60.      ddmmmyy.DOC file. TFE will place as many as you like in there.
  61.      GT can only handle one at a time. You can't execute GT by shelling
  62.      to DOS within TFE.
  63.  
  64.   3) Execute GT by typing GTIBMA01 or GTLQA01, which must be in the current
  65.      directory or in your PATH.
  66.  
  67.   4) GT will remind you to make your printer ready and prompt your for
  68.      the filespec of the "ddmmmyy.DOC" file created in step 1.  You
  69.      only need to type as much of the filespec as you need to access
  70.      the file from your current directory. If it's in the current
  71.      directory, just the filename.ext will do.  GT will read the input
  72.      file and count down in 1/6 of a page units.
  73.  
  74.   5) You can stop printing by pressing any key.  GT will ask you for
  75.      confirmation before aborting.
  76.  
  77.                         LIMITATIONS
  78.  
  79.   1) Special characters in the input file.  Due to the difficulties of
  80.      parsing each line and separating out the various fields, certain
  81.      characters are interpreted by GT as separators between the fields.
  82.      These characters are  ),#|-(   The presence of any of these characters
  83.      in names or dates will result in strange output.  This will cause
  84.      problems with hyphenated names, nicknames enclosed in parentheses,
  85.      date formats with dashes and other such.
  86.      I am considering several solutions for this.  One is to offer
  87.      alternative character mapping. A user with an ASCII text editor
  88.      could change the hyphens in his hyphenated names to backslashes, which
  89.      GT would print as dashes. Another alternative is to allow for a
  90.      'neutral file' input, which would use only a special character as a
  91.      field delimiter.  A user or geneology data base system could then
  92.      maintain the file and fully control what is printed on each line of
  93.      the box.
  94.  
  95.   2) Number of people.  This version allows for 300 people (Descendants
  96.      + Spouses) in 7 generations The output can be up to 50 pages long.
  97.  
  98.   3) Name lengths.  Up to 15 characters is allowed for surnames.  Up to
  99.      40 for given names. Given names will be truncated if necessary.
  100.      A total of 27 characters will be printed.
  101.  
  102.                          IN CASE OF PROBLEMS
  103.  
  104.      If your printer does strange things like move to the right margin
  105.      and just stay there, check your printer manual to see if it supports
  106.      double density graphics.  GT uses the following graphic commands.
  107.      If your printer does not respond as expected to these commands,
  108.      GT will not work.
  109.               ESC  @      resets printer to default settings.
  110.               ESC  2      sets line spacing to 1/6 in.
  111.               ESC  3 n    sets line spacing to n/180 or n/216.
  112.               ESC  L n m  sets printer to double density graphics mode
  113.                            with 256*m + n columns of data to follow.
  114.  
  115.     If GT doesn't finish printing, or prints people in strange places,
  116.     it's probably due to unexpected lines of data in the Descendant
  117.     chart.  GT identifies header and footer lines by looking for
  118.     "FAMILY EDGE" or "====" in them.  GT would try to treat a line of
  119.     asterisks as a person, and would go haywire.  Examine the format of
  120.     the SAMPLE.DOC file carefully, and compare it to your own.
  121.  
  122.                         THOUGHTS FOR THE FUTURE
  123.  
  124.      GT could easily be modified to handle 11 generations on a wide
  125.         carriage printer.  Is there any demand for this?
  126.      Suggestions and comments are welcome. Address them to me at
  127.         Compuserve 76407,132.
  128.  
  129.   The Family Edge is copyright Carl York
  130.                                150 E.30th Street
  131.                                New York, NY 10016
  132.                                Apt 2E
  133.