home *** CD-ROM | disk | FTP | other *** search
/ rtsi.com / 2014.01.www.rtsi.com.tar / www.rtsi.com / OS9 / OSK / APPS / TeXSystem.lzh / Installation.text < prev    next >
Text File  |  1992-11-25  |  10KB  |  211 lines
  1.                INSTALLING THE OS9/TeX SYSTEM
  2.  
  3.    Installing the OS9/TeX system consists primarily of correctly
  4. unpacking the archives, which will build the directories and many of the
  5. files, and running some shell scripts which will build a number of other
  6. files.  The archives were all created with LHa version 2.01 for OSK,
  7. ported by Mike Haaland.  You'll need this or a compatible program
  8. to dearchive.
  9.    The installation requires at least 10 megabytes of free space on your
  10. hard disk (in addition to the 3 meg required to hold the archives), and
  11. "mfree -e" should show a free block of at least 1500k to carry out some
  12. of the steps in the installation. You may need to reboot, terminate some
  13. programs, and unload some things from memory.  This memory requirement
  14. is primarily for initex and virtex. If you can't get this much free
  15. memory, you may need to find an older version of initex and virtex (and
  16. the accompanying tex.pool file) which requires less memory.
  17.  
  18. ------------------------------------------------------------------------------
  19.  
  20. Step 0: Print out this file, and check off each step as you do it.
  21.  
  22. ------------------------------------------------------------------------------
  23.  
  24. Step 1: Install the executables.
  25.  
  26.    a. Choose an appropriate directory on your system.  I use
  27. /DD/CMDS/TEXCMDS, but there may be something more appropriate for your
  28. system.  Then chd to that directory, and unpack the executable archives
  29. with:
  30.         lha -x <full path of texcmds.lzh>
  31.         lha -x <full path of dvitranslators.lzh>
  32. If you downloaded the tangle and weave program archive, you can also
  33.         lha -x <full path of tangleweave.lzh>
  34.  
  35.    b. Check the attributes.  All the executable files should have an
  36. appropriate ownership, and have public and private read and execute
  37. privileges.
  38.  
  39.    c. Set your PATH variable(s) accordingly.  If you created a new
  40. directory for these commands, you'll need to add this to the PATH
  41. variable in the .login files for each user that will want to
  42. access these programs.
  43.  
  44. ------------------------------------------------------------------------------
  45.  
  46. Step 2: Install the data files.
  47.  
  48.    a. Choose and create an appropriate directory.  I _STRONGLY_
  49. recommend you use /DD/SYS/TEX.  The executables currently look by
  50. default in /DD/SYS/TEX and then /DD/USR/TEX.  These can be overridden by
  51. appropriate environment variables, but this can be complicated to get
  52. right.  I've not tried installing the system in /DD/USR/TEX, though it
  53. should work.
  54.  
  55.    b. Unpack the archive.  As above, first chd to /DD/SYS/TEX, then
  56.          lha -x <full path of texdir.lzh>
  57. This will take several hours to unpack, so be patient.
  58.  
  59. ------------------------------------------------------------------------------
  60.  
  61. Step 3: Select a printer, and edit some configuration files.
  62.  
  63.    a. Choose a DVI translator program.  Included in the package
  64. are DVI translators for a number of popular printers.  These
  65. are the executables named dvi___.  This is a list of the
  66. ones included:
  67.         dvialw  - Apple LaserWriter and other 300dpi Postscript printers
  68.         dvidjp  - Hewlett Packard Deskjet Plus
  69.         dvieps  - Epson MX/FX and compatible 9-pin printers
  70.         dviimp  - imPRESS/Imagen laser printer family
  71.         dvijet  - Hewlett Packard LaserJet
  72.         dvijep  - Hewlett Packard LaserJet Plus
  73.         dvilj2  - Hewlett Packard LaserJet II
  74.         dvimac  - Apple ImageWriter 144dpi printer
  75.         dvioki  - Okidata 192 144dpi printer (should work with Oki 92?)
  76.         dvitos  - Toshiba P-1351 180dpi printer
  77.    Four have been carefully tested under OS9/68k: dvialw, dvieps,
  78. dvilj2, and dvioki.  If you have trouble with one of the others, please
  79. tell me and I'll try to fix the problem.
  80.    If your printer is not on this list, you'll need to find,
  81. write, or buy a DVI translator program for it.
  82.  
  83.    b. MetaFont has a "modes" file which tells it the resolution
  84. and other properties of various printers.  This information is used
  85. whenever MetaFont creates a font.  You should look through the
  86. file /DD/SYS/TEX/MFINPUTS/modes.mf to select the printer description
  87. that's appropriate for your printer.  You should then edit the
  88. line (about 6 lines from the bottom of the file) which reads
  89.     localfont := CanonCX;
  90. to include the name of the appropriate printer description.
  91. If in doubt, CanonCX is a good choice for any 300dpi laser printer,
  92. and you should use EpsonMXFX for 9-pin Epson-compatible printers.
  93. For other printers, read the file carefully and choose the best
  94. one.  If you must create your own, start by copying and modifying
  95. another one, and proceed carefully.  It will help to consult
  96. the METAFONTBook.
  97.  
  98.    c. Edit the "makefont" program.
  99.       Since running MetaFont to build a new font involves a somewhat
  100. complicated command line, I've written a Microware Basic program to
  101. help.  "Makefont.b" will prompt you for the name of the font to make,
  102. and the size, and will then run METAFONT to build the font, and handle
  103. some other housekeeping chores.  You'll first need to edit the
  104. Makefont.b source code, contained in the FONTS directory, to reflect
  105. your directories and preferred printer.  Once you've done this, you
  106. should create the packed Makefont program using the following commands:
  107.       basic
  108.       load makefont.b
  109.       chx /DD/CMDS/TEXCMDS
  110.       pack makefont
  111.       bye
  112. Note that "makefont" will not work correctly for all fonts, since
  113. it assumes some things about the naming.  For fonts that don't
  114. match makefont's assumptions, you'll have to run MetaFont
  115. by hand.  The file Usage.text should help.
  116.  
  117. ------------------------------------------------------------------------------
  118.  
  119. Step 4: Create the format and base files
  120.  
  121.    a. TeX and MetaFont are macro languages, and for speed of operation,
  122. they are designed to load pre-compiled macros.  The "initex" and "inimf"
  123. programs are used to pre-compile macro sets which can be loaded by
  124. "virmf".  First, make sure you have enough free memory, since initex is
  125. especially memory hungry.  On my 3 meg MM/1, I sometimes have to reboot
  126. in order to have sufficient free memory.  Then
  127.          chd /dd/sys/tex
  128.          install
  129. The "install" shell script will build the "format" files, which are
  130. precompiled macros for TeX, and the "base" files, which serve a similar
  131. purpose for MetaFont.  It takes almost an hour to build the three format
  132. files for Plain TeX, LaTeX, and SliTeX, and the two base files for
  133. Plain METAFONT and the Computer Modern base.
  134.  
  135. ------------------------------------------------------------------------------
  136.  
  137. Step 5: Test all the pieces
  138.  
  139.    a.  To make sure TeX works, go to the SAMPLES directory, and
  140.          tex story.tex
  141. After a few minutes, you should see
  142.          This is TeX, C Version 3.14
  143.          (story.tex [1])
  144.          *
  145. The number in brackets is a page number.  The open parentheses is
  146. printed when TeX opens a file, followed by the file name.  The
  147. close parenthese is printed when TeX closes the file.  So, this
  148. output means that TeX has completely read the file story.tex, and
  149. has generated one page of output.  Type "\end" at the prompt to
  150. finish TeX (normally, the \end is part of the input file).  You
  151. will then see
  152.          Output written on story.dvi (1 page, 668 bytes).
  153.          Transcript written on story.log.
  154.   The dvi file is a DeVice Independent file that contains instructions
  155. about where to put each character on the page.  The log file is a text
  156. file with information about this run.  The byte size may vary.
  157.  
  158.    b.  Build some test fonts
  159.    Before you can print it out, you'll need to create some fonts.
  160. This particular document requires three fonts: cmr10, cmsl10, and
  161. cmbx10.
  162.        cmr10  - Computer Modern Roman 10 pt.
  163.        cmsl10 - Computer Modern Roman Slanted 10pt
  164.        cmbx10 - Computer Modern Bold Extended 10pt
  165. To build them, use the "makefont" program
  166.            makefont
  167.            Name of font: cmr10
  168.            Size to make font: <Return>
  169. Makefont will run MetaFont to build the GF-format font file, then
  170. run "gftopk" to convert it into a more compact PK format, and finally
  171. delete some extraneous files.  Similarly, you should create the cmsl10
  172. and cmbx10 fonts.
  173.  
  174.    c.  Print it out.
  175.    If you're using one of the DVI translators supplied with the package,
  176. you should be able to simply
  177.           dvi___ story.dvi
  178. Where dvi___ is one of the dvi translator programs.  This will
  179. create a file suitable for sending to your printer.  For all but
  180. Postscript printers, you should be careful to use "merge" to
  181. print the file, since these are graphics files.  For example,
  182. if you are using the LaserJet II translator, the commands are
  183.           dvilj2 story.dvi
  184.           merge story.dvi_lj2 >/p
  185. If the translator program prints out any error messages, you'll
  186. need to diagnose and fix the problem.  The most common problem
  187. at first will be missing fonts, but as you create more and more
  188. fonts, this problem will occur less frequently.
  189.  
  190. ------------------------------------------------------------------------------
  191.  
  192. Step 6: Use it!
  193.  
  194.    a.  Read the file Usage.text for notes about operating the
  195. various programs.
  196.  
  197.    b.  Buy a copy of "LaTeX: A Document Preparation System" and/or
  198. "The TeXBook" for further details on how to use TeX.
  199.  
  200.    c.  Format and print out other documents.  There are several other
  201. documents in the SAMPLES directory that you may want to look at.  Format
  202. them with TeX or LaTeX, as appropriate (if one of the  first lines is a
  203. "\documentstyle" command, then use LaTeX).  You can then print them as
  204. above.  You will probably need to create more fonts in order to print
  205. them successfully.  (You  may want to examine the Makefiles which appear
  206. in subdirectories of the FONTS directory for ideas on building many
  207. fonts at one time.)
  208.  
  209. ------------------------------------------------------------------------------
  210.  
  211.