home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / TeX / tex_readme < prev    next >
Text File  |  2009-11-06  |  5KB  |  108 lines
  1. This group contains source, compiled binary, and other files
  2. needed to run 'Common TeX'.  The binary files were compiled
  3. on an MM/1 - should run on other "OSK" machines.  The source was
  4. obviously written to be as portable as possible and should 
  5. compile on a lot of different systems.
  6.  
  7. Note that I am NOT the author of these programs, see 
  8. the 'copying' and 'readme' files in ctexdoc.ar for authors
  9. instructions on distribution. 
  10.  
  11. Following is a quick program description and a few notes to help
  12. you decide if you want to download some or all of the files.
  13. To compile the CTeX files, you will need the GNU GCC compiler.
  14. For both CTeX and DVI2TTY you will need the TOPS 'os9lib.l' library
  15. or something similar.
  16.  
  17. **********  TeX **************
  18.  
  19. TeX is a typesetting program.  It reads a text file with embedded
  20. commands and produces a "DeVice Independent" (.DVI) file that will
  21. (with the aid of a suitable device-specific driver program) completely
  22. control the output device.  It specifies the position of just about
  23. every single mark on the paper.  A second program in this group (DVI2TTY)
  24. will take the DVI file and turn it into something that will display
  25. on a terminal screen or dot-matrix printer.
  26.  
  27. To run TeX, you will NEED the "TeXBook" by Donald Knuth (I got it at
  28. Waldens).  If you can figure out how to use the program without that
  29. book, you are a lot smarter than I am.  There is no documentation
  30. for TeX included here.
  31.  
  32.         The TeXbook, Donald E. Knuth ISBN 0-201-13448-9
  33.  
  34. Source and the makefiles I used on my MM/1 are in ctexsrc.ar.  Note
  35. that I could not get the Microware Compiler to swallow this source.
  36. The macros drove it nuts.  The GNU (GCC) compiler did fine.  More
  37. experienced "C" programmers could probably figure out how to get it
  38. through the MW compiler.  I rewrote some of the more complicated
  39. macros and the MW compiler liked it a lot better - but then I discovered
  40. that the GCC compiler would do it and I scrapped my patches.  The
  41. only modifications in the source are a few "#ifdef OSK" lines to cover
  42. differences in the names/locations of header files.
  43.  
  44. If you would rather not compile your own, you will need virtex.bin, 
  45. ctexinp.ar and ctextfms.ar.  Put all the <font>.tfm files in 
  46. /dd/usr/tex/tfms.  Put 'plain.fmt' in /dd/usr/tex/formats.  Put
  47. <file>.tex files in /dd/usr/tex/inputs.  Environment variables
  48. TEXFONTS, TEXFORMATS, AND TEXINPUTS will be read and used for
  49. paths if found.  The other .bin file 'initex.bin'  is used to produce
  50. 'plain.fmt' from 'plain.tex' - you will need it to make customized
  51. format files for your own use.  See the TeXbook.
  52.  
  53. See 'ctex.ins' <in ctexdoc.ar> for more info.
  54.  
  55.  
  56. *************** DVI2TTY ****************
  57.  
  58. This program was written to allow previewing of TeX .DVI files on a
  59. screen or dot-matrix printer.  It ignores some of the more complicated
  60. controls in the file and produces a pretty neat output.  It can be
  61. improved in some spots with a text editor (or a few strategic PROFF
  62. commands) to polish up the final printed output.  All source and docs
  63. are in dvi2tty.ar.  This one WILL compile with the Microware Compiler
  64. with no trouble.  Again, the only changes in the source were some
  65. little #ifdef OSK (the header is here, not there) type lines. If you
  66. just want to get the binary and run it, 'dvi2tty -?' will give you
  67. a pretty good idea for usage.  One undocumented option: '-e<n> will
  68. change the spacing between words.  The <n> can be a positive or negative
  69. number.  The author (one of them - there are several) warns that you
  70. can lose ALL the spaces if you get carried away -  '-e-11' is suggested.
  71. I used -e-15 on the .dvi files that come with the GNU compiler.
  72.  
  73.  
  74. John R. Wainwright
  75.  
  76. CIS: 72517,676    DELPHI: JOHNREED        GENIE: J.WAINWRIGHT        
  77.  
  78. ----------
  79.  
  80.  
  81. ADDITIONAL NOTES:
  82.  
  83.     I have recompiled the sources and added a utility program called
  84. 'tex', which simply takes its command line arguments and passes them
  85. along to virtex, along with the argument "&plain".  This alleviates the
  86. need to type:
  87.  
  88. virtex "&plain" foo.tex
  89.  
  90. every time you want to plain tex a file. This tiresome command line is
  91. thus replaced by:
  92.  
  93. tex foo.tex
  94.  
  95. Note, however, that my simple little program 'tex' does not return any
  96. error codes returned by virtex. It probably should, and I believe
  97. there's a simple modification, but at the moment my OS9 C manuals are
  98. packed away waiting to go along with me back to college.
  99.  
  100.     To compile the sources, you will need at least 2 MB of memory.
  101. Compilation on my Gimix Micro-20, 12.5 MHz 68020, took about 45 minutes
  102. or so. To run virtex requires just over 512k of free memory. I'd suggest
  103. running only on systems with greater than 768k.
  104.  
  105.  
  106. Russell E. Hoffman
  107. rh2y+@andrew.cmu.edu
  108.