home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1994 #1 / monster.zip / monster / GENE / GEDCHT16.ZIP / README < prev   
Text File  |  1994-01-02  |  18KB  |  469 lines
  1. Gedchart version 1.6                         Jan. 1, 1994
  2. Copyright (C) 1993-1994 Thomas P. Blumer.  All Rights Reserved.
  3.  
  4. This is a beta test version of Gedchart.
  5. A future commercial version will have many additional features.  Please
  6. contact me at one of the addresses given below for more information.
  7.  
  8. I am not labeling this "shareware" because I plan to turn this into a
  9. commercial product soon.  But if you like Gedchart and want to support
  10. the development, then send me $20 and I will send you the first commercial
  11. version for free, when it is complete.
  12.  
  13. Or if you would like to help in another way, please distribute this
  14. release, or upload to your favorite bulletin board or network.
  15.  
  16. In any event, I am learning a lot from your comments and suggestions,
  17. please keep them coming.
  18.  
  19. Thanks, Tom
  20.  
  21. I would like to hear what you think about this program,
  22. please mail any comments or suggestions to:
  23.  
  24. Internet address:   blumer@ptltd.com
  25. Compuserve address: 70740,3403
  26. US mail:        Tom Blumer, 63 Sacramento St, Cambridge, MA  02138
  27. Phone:            617-864-6799 or 617-864-6268
  28.  
  29.  
  30. Table of Contents
  31.     
  32.  1. Overview
  33.  2. Getting Started with Gedchart
  34.  3. Printers supported by Gedchart
  35.  4. Printing on an HP LaserJet Printer
  36.  5. Printing on a PostScript Printer
  37.  6. Running Gedchart with command line options (batch mode)
  38.  7. International Character Sets
  39.  8. Uncompressing the Gedchart.zip file
  40.  9. Printing Gedchart PostScript Files on a Macintosh
  41. 10. Printing a Title Box on the Chart
  42. 11. Printing customized notes for each individual on the chart
  43. 12. Printing multiple pages for a large chart
  44. 13. Options for printing individual titles
  45. 14. Setting paper sizes
  46. 15. Using Downloaded Fonts with PostScript
  47. 16. Using Gedchart with large GED files
  48. 17. History of Changes and Bug Fixes for each Version
  49.  
  50.  
  51. 1. Overview
  52.  
  53. Gedchart is a program to prepare family tree charts on your laser
  54. printer.  It will produce an elegantly formatted chart of the
  55. ancestors or descendents of a given individual.  Ancestor charts have
  56. an option to print either just the direct ancestors or the direct ancestors
  57. with all of their siblings.
  58.  
  59. Using Gedchart you can easily produce up to 10 generation charts
  60. that will fit on letter size paper and still be quite readable.
  61.  
  62.  
  63. 2. Getting Started with Gedchart
  64.  
  65. To start the program, type:
  66.  
  67.     gedchart file.ged
  68.  
  69. and a menu of choices will appear.  Enter the surname and given name
  70. of an individual, the number of generations, the style of chart, the
  71. type of printer, and the name of the printer port (LPT1, COM1, etc)
  72. and gedchart will prepare an ancestor or descendent chart for that
  73. individual.
  74.  
  75.  
  76. 3. Printers Supported by Gedchart
  77.  
  78. It will run on any IBM PC (or compatible), and will read in a GED
  79. file and produce several styles of family chart on any of the
  80. following laser printers:
  81.  
  82. HP LaserJet III family or LaserJet 4 family
  83. Any other printer that supports the PCL5 language
  84. Apple LaserWriter NT or NTX or IIf or IIg
  85. HP LaserJet II or IIP or IID with PostScript cartridge
  86. Any other PostScript printer
  87.  
  88.  
  89. 4. Printing on an HP LaserJet Printer
  90.  
  91. All of the LaserJet III and LaserJet 4 printers have 2 modes,
  92. Page Protect=Off and Page Protect=On.  The default is page protect off,
  93. which is used when the printer does not have enough memory to store the
  94. entire page, and therefore simply tries to output the job in "bands" or
  95. horizontal strips.  If page is too complex to print, then the front
  96. panel will say something like "print overrun" or "complex page" and only
  97. a portion of the page will print.  In the case of gedchart the output
  98. will be some part of the paternal line at the top of the page.
  99.  
  100. The solution is to set Page Protect on for letter size paper via the front
  101. panel.  You will need at least 2 MB of RAM in the printer to do this,
  102. otherwise the option to turn on page protect will not be available in
  103. the menus.
  104.  
  105. To determine the amount of memory in the printer, print a test page.
  106. Usually there is a "test page" key on the front panel.  You may have to
  107. hold down the button for about 5 secs until the test page message appears
  108. and then let go.
  109.  
  110. If you don't have enough memory, consult the manual about the amount of
  111. RAM that is needed for Page Protect mode, then buy and install according
  112. to the instructions in your printer manual.
  113.  
  114. If the printer already has enough memory, you just need to go to the
  115. appropriate menu on the front panel, and change the setting:
  116.  
  117.     Press Online (light goes out to indicate offline)
  118.     Hold Menu key down for about 5 secs to get a new message
  119.     Press Menu enough times to see Page Prot=Off*
  120.       (the * indicates the current setting)
  121.     Press + to change to Page Prot=Ltr  (letter size)
  122.     Press Enter to change to Page Prot=Ltr*
  123.     Press Online
  124.  
  125. and then try the page again.
  126. These instructions happen to be for a IIID, they may be slightly different keys
  127. on other LaserJets, but the basic idea is the same.
  128.  
  129.  
  130. 5. Printing on a PostScript Printer
  131.  
  132. When using a PostScript language printer, the chart will be scaled to fit
  133. the current paper size.
  134.  
  135. If you generated a PostScript output file for the chart, the ability to scale
  136. to the current paper size is built in to the PostScript commands in the file,
  137. so you can print the same file on several different printers with different
  138. paper sizes.
  139.  
  140.  
  141. 6. Running Gedchart with command line options (batch mode)
  142.  
  143. You can run Gedchart from a DOS command line or from a batch file by
  144. typing a command such as:
  145.  
  146.     gedchart -g6 -php3 -NBlumer -nThomas blumer.ged >lpt1
  147.  
  148. The command line options on this example request a 6 generation chart,
  149. for the LaserJet 3, for the individual with last name Blumer and
  150. first name Thomas, from the GED file blumer.ged.  Output is directed to
  151. port "lpt1".
  152.  
  153. When there are no command line options, gedchart defaults to using the menu
  154. interface.
  155.  
  156. There are several reasons to use this command line interface.  If you are
  157. running the same type of chart repeatedly you can give the command in a
  158. batch file and thus print the chart with no operator intervention.
  159. The same is true for multiple copies sent to a printer, or creating multiple
  160. PostScript files to be sent to another computer, etc.
  161.  
  162. All of the options are also available from the menu interface except the
  163. "-m" option.  This option will scan the GED file and print a list of
  164. the individuals that have the greatest number of generations of ancestors
  165. in the GED file.
  166.  
  167. Type the command line:
  168.  
  169.     gedchart -h
  170.  
  171. to see the list of command line options as follows.
  172.  
  173. Gedchart 1.6   Copyright (C) 1993-1994 Thomas P. Blumer  All Rights Reserved.
  174. Usage: gedchart [options] file.ged
  175. -b    Birth and death dates on same line
  176. -bb    Name, birth and death dates on same line
  177. -Cn    Print n copies
  178. -Ffont    Font selection for text (PostScript printers only)
  179. -gn    Print n generations
  180. -i    Turn off interactive query on each name
  181. -N    Surname of root individual in chart
  182. -n    Given name of root individual in chart
  183. -php3    Printer is HP LaserJet III
  184. -php4    Printer is HP LaserJet 4
  185. -pps    Printer is PostScript (black and white)
  186. -pcps    Printer is Color PostScript
  187. -pver    Printer is VersaTek
  188. -pplot    Printer is HP DesignJet 650C
  189. -Psize    Paper size, size = letter, legal, A4, D, E
  190. -s    Print siblings of root individual (default off)
  191. -S    Style: -Sa for ancestor, -Sd for descendent, -Sf for ancestor fan
  192.  
  193. Example: gedchart -g6 -php4 -NBlumer -nThomas blumer.ged >lpt1
  194.     for 6 generation ancestor chart printed on HP LaserJet 4
  195.  
  196. -a    Abbreviate names by removing middle names (default off)
  197. -Af    Adjust font point size by factor f
  198. -B    Birth,death,marriage,separator: example "-Bb. /d. /m. /  " is default
  199. -G    Don't print names or dates (for fast look at chart depth)
  200. -m    Map of root individuals
  201. -M    Turn off marriage dates
  202. -O    Offset of name above line (in points)
  203. -rn    RIN # of root individual in chart
  204. -U    Names and titles in upper case
  205. -V    Vertical space adjustment factor for individuals
  206. -Wf    Adjust line width by factor f
  207. -w    Give stricter warning messages
  208. -xm:n    Multi page poster output: print page m of n horizontally
  209. -ym:n    Multi page poster output: print page m of n vertically
  210. -Y    Print the year only for each date
  211. -zn    Options for printing of individual titles:
  212.         -z0 do not print titles
  213.         -z1 print only suffix titles such as Jr. or III (default)
  214.         -z2 print all titles
  215.  
  216. -L    Line color for direct ancestors
  217. -l    Line color for indirect ancestors
  218. -T    Text color for direct ancestors
  219. -t    Text color for indirect ancestors
  220.  
  221.     Colors: r=red g=green b=blue c=cyan m=magenta y=yellow k=black
  222.     gedchart -F  gives a list of PostScript fonts
  223.  
  224. Examples:
  225. gedchart -C2 -g6 -pps -Sd -bb -NFuller -nSamuel blumer.ged >lpt1
  226.   2 copies of 6 generation descendent chart printed on PostScript printer
  227. gedchart -g7 -pps -Sf -NBlumer -nThomas blumer.ged >lpt1
  228.   7 generation ancestor fan chart printed on PostScript printer
  229. gedchart -g8 -php4 -Sf -x2:3 -y2:3 -NBlumer -nThomas blumer.ged >lpt1
  230.   center page of a 3x3 page large fan chart for LaserJet 4
  231. gedchart -g8 -php4 -Sa -sb -x2:3 -y2:3 -NBlumer -nTh blumer.ged >lpt1
  232.   center page of a 3x3 page large sibling ancestor chart for LaserJet
  233.  
  234.  
  235. 7. International Character Sets
  236.  
  237. A GEDCOM (.GED) file often has a CHAR command to specify the character
  238. set in the file to be either ANSEL or IBMPC.  Gedchart supports either
  239. option.  Files that are produced on a Macintosh may say CHAR MACINTOSH;
  240. the international characters in these files are not supported by Gedchart
  241. in this version.
  242.  
  243. Gedchart supports the international character set (code page) features in
  244. MSDOS 5.0 to allow different character sets to be entered at the keyboard
  245. or displayed on the screen.  Current supported code pages are:
  246.  
  247.     code page 437    English
  248.     code page 850    Multilingual
  249.     code page 863    French Canadian
  250.     code page 865    Danish-Norwegian
  251.  
  252. In order for the international (accented) characters to work properly,
  253. you must set the same code page when using Gedchart as when you used
  254. another program to create the GED file.
  255.  
  256.  
  257. 8. Uncompressing the Gedchart.zip File
  258.  
  259. If you received a uuencoded zip file:
  260.  
  261.     Delete the lines of the message above
  262.         begin gedchart.zip ...
  263.     and save the result in a file.
  264.  
  265.     Run the command: "uudecode filename" to produce gedchart.zip.
  266.  
  267. If you have a .zip file:
  268.  
  269.     Run(on a PC): pkunzip gedchart.zip
  270.  
  271. Please let me know if you have any problems or
  272. if you need me to send the file via some other method.
  273.  
  274. There are several versions of the pkunzip utility:
  275. Many internet sites have these files, I downloaded mine from
  276.     ux1.cso.uiuc.edu
  277. in the directory
  278.     /pc/exec-pc
  279.  
  280. pkz193a.exe    version 1.93a
  281. pkz204c.exe    version 2.04c
  282.  
  283.  
  284. 9. Printing Gedchart PostScript Files on a Macintosh
  285.  
  286. If you ask Gedchart for PostScript, and output to a file, then you
  287. have 2 options.
  288.  
  289. Carry the PostScript file to a PC, and connect the PC to a PS printer via
  290. serial or parallel cable, then copy the file to the printer:
  291.  
  292.     copy/b file.ps lpt1     (for parallel)
  293.     copy/b file.ps com1     (for serial)
  294.  
  295. Or carry the file to a Mac, start up Apple File Exchange, put in the DOS
  296. diskette, and transfer the file to the Mac.  Once the file is on the Mac, use
  297. a program such as "sendPS" or a modem program or font downloader to download
  298. the file to the printer over a serial (modem) port.
  299.  
  300. The Macintosh program sendPS is available by anonymous ftp from
  301. sumex-aim.stanford.edu.
  302.  
  303.  
  304. 10. Printing a Title Box on the Chart
  305.  
  306. Gedchart will print a customized title box on your family tree chart.
  307. If there is a file "label.txt" in the current directory then the text lines
  308. in that file will be enclosed in a small box and automatically positioned
  309. in one of the four corners of the chart, using the corner that has the most
  310. space.  Just edit the file "label.txt" with any text editor.
  311.  
  312. If you want the current date as part of the title box, use
  313. %d for the day, %m for the name of the month, and %y for the year, and
  314. the current day, month, and year will be filled in for you.
  315.  
  316. Similarly, %f will be replaced by the name of the input GED file.
  317.  
  318. This version of Gedchart does not support title boxes for PostScript
  319. printers.
  320.  
  321.  
  322. 11. Printing customized notes for each individual on the chart
  323.  
  324. When entering data into Personal Ancestral File (PAF) you have the option
  325. of creating notes for each individual.  If you include one line of text
  326. in the notes that starts with the word GEDCHART, followed by a space and
  327. some text, then that text will print on the chart under the birth/death
  328. date.
  329.  
  330. Example line of the notes:
  331.  
  332. GEDCHART Came over on the Mayflower
  333.  
  334.  
  335. 12. Printing multiple pages for a large chart
  336.  
  337. Gedchart has an option for printing a set of pages that can then be taped
  338. together to form a large chart (n pages wide by m pages high).
  339.  
  340. The command line options to do this are -xn1:n2 -ym1:m2, meaning that the
  341. current page to be printed is page n1 out of n2 pages wide and page m1 out
  342. of m2 pages high.
  343.  
  344. A DOS batch file to print a large chart 2 pages wide, and 3 pages high
  345. might look like this:
  346.  
  347. gedchart -g10 -i -php3 -Nblumer -nthomas -x1:2 -y1:3 ..\blumer3.ged >lpt1
  348. gedchart -g10 -i -php3 -Nblumer -nthomas -x2:2 -y1:3 ..\blumer3.ged >lpt1
  349. gedchart -g10 -i -php3 -Nblumer -nthomas -x1:2 -y2:3 ..\blumer3.ged >lpt1
  350. gedchart -g10 -i -php3 -Nblumer -nthomas -x2:2 -y2:3 ..\blumer3.ged >lpt1
  351. gedchart -g10 -i -php3 -Nblumer -nthomas -x1:2 -y3:3 ..\blumer3.ged >lpt1
  352. gedchart -g10 -i -php3 -Nblumer -nthomas -x2:2 -y3:3 ..\blumer3.ged >lpt1
  353.  
  354.  
  355. 13. Options for printing individual titles
  356.  
  357. When entering data into Personal Ancestral File (PAF) there is a title
  358. field that is used for an individual title such as Captain or Jr. or III.
  359. Gedchart gives three options for printing the titles:
  360.  
  361.     1. do not print the individual titles
  362.     2. print only the titles at the end of the name, such as Jr. or III
  363.     3. print all individual titles
  364.  
  365. The desired title option may be selected through the "Individual Titles"
  366. item on the menus, or through the -z0 or -z1 or -z2 command line options.
  367.  
  368.  
  369. 14. Setting paper sizes
  370.  
  371. If you have selected "PostScript printer" in the menus, the chart will be
  372. scaled automatically to fit the paper size, and the paper size setting in
  373. the menus is ignored.
  374.  
  375. If you have selected "LaserJet III" or "LaserJet 4" in the menus then
  376. you must set the desired paper size in the Gedchart menu, set the same
  377. paper size with the LaserJet front panel, and load the multi-purpose
  378. tray of the printer with the appropriate size paper.
  379.  
  380. For example, to setup Legal size paper on the LaserJet 4 front panel:
  381.  
  382.     Press "On Line" button (light goes off)
  383.     Press "Paper Size" button
  384.     Press "+" button until "MP TRAY=LEGAL" shows
  385.     Press "Enter" button
  386.     Press "On Line" button (light goes on)
  387.  
  388.     Press "On Line" button (light goes off)
  389.     Press "Menu" button until "PRINTING MENU" shows
  390.     Press "Item" button until "PAPER=..." shows
  391.     Press "+" button until "PAPER=LEGAL" shows
  392.     Press "Enter" button
  393.     Press "On Line" button (light goes on)
  394.  
  395.     Press "On Line" button (light goes off)
  396.     Press "Menu" button until "JOB MENU" shows
  397.     Press "Item" button until "PAGEPROTECT=..." shows
  398.     Press "+" button until "PAGEPROTECT=LGL" shows
  399.     Press "Enter" button
  400.     Press "On Line" button (light goes on)
  401.         
  402.  
  403. 15. Using Downloaded Fonts with PostScript
  404.  
  405. If you have a downloadable PostScript font file, you can use it
  406. for your charts as follows.  First download the font to the printer, then
  407. run Gedchart with the -Ffontname command line option to request the given
  408. font name.  Note that the font name required by the -F option may be
  409. different than the file name where the font is stored.
  410.  
  411.  
  412. 16. Using Gedchart with large GED files
  413.  
  414. There are two versions of Gedchart.  The standard version, named
  415. "gedchart.exe", handles GED files of limited size because it can
  416. only use the first 640K of memory.  This version has both a command
  417. line interface (type "gedchart -h" for usage) and a menu interface
  418. (type "gedchart filename.ged" to get the menu).
  419.  
  420. The extended version of Gedchart, named "gedcharx.exe" can handle
  421. very large GED files, because it can use memory beyond the first
  422. 640K.  This version has only the command line interface, and the
  423. commands are the same as in the standard version.
  424.  
  425. To use the extended version of Gedchart, you must a 386 or 486
  426. processor.  You also must have the file go32.exe in a directory
  427. on the current path, or in the same directory with gedcharx.exe.
  428.  
  429. The extended version of Gedchart is built using the DJGPP DOS
  430. extender software and the DJGPP port of the Free SoftWare Foundation
  431. GNU C compiler.  The DJGPP DOS extender software and the compiler
  432. port were done by DJ Delorie.  Sources and executables for the
  433. DOS extender and the GNU C compiler for MSDOS are available on
  434. internet by anonymous ftp.
  435.  
  436.     host:      omnigate.clarkson.edu
  437.     login:     ftp
  438.     password:  send your e-mail address
  439.     directory: ~ftp/pub/msdos/djgpp
  440.  
  441.  
  442. 17. History of Changes and Bug Fixes for each Version
  443.  
  444. Version 1.6   Added these features:
  445.     descendent charts
  446.     option for number of copies to be printed
  447.     option for setting line width
  448.     handling of fan charts for 8, 9, 10, 11 generations
  449.     multi page posters for PostScript printers
  450.  
  451. Version 1.5   Added these features:
  452.     options for handling individual titles
  453.     multi page posters for HP LaserJet printers
  454.     tagged notes feature
  455.     support for paper sizes
  456.     option for name, birth, death on same line
  457.     option for international symbols for birth, death, and marriage
  458.  
  459. Version 1.42  Fixed a bug that sometimes caused printing of the wrong
  460. birth and death dates.
  461.  
  462. Version 1.41  Fixed a bug in the "Remove middle names" feature.  The bug
  463. would only occur when "Remove middle names" was on, and some name was
  464. seen more than once in the chart (intermarriage).
  465.  
  466. --------
  467. PostScript is a registered trademark of Adobe Systems Inc.
  468. PCL is a registered trademark of Hewlett Packard Company.
  469.