home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / textutil / tex / readme < prev   
Encoding:
Text File  |  1994-10-13  |  6.5 KB  |  176 lines
  1. These directories contain a pre-installed and setup version
  2. of ArmTex 3.141, with LaTeX 2.09, 2e and all the trimmings. It
  3. is hoped that by supplying these files in this easy to install
  4. form many first time users of TeX and LaTeX will succeed in
  5. getting started.
  6.  
  7. Where did the files come from?
  8. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.  
  10. The files were pulled back from the University of Stuttgart ftp
  11. server, and manually unpacked. I then discovered to my horror
  12. that not only were there minimal setup instructions, the script
  13. they suggested using was broken. They also required David
  14. Pillings excellent 'SparkFS' software to be loaded whilst
  15. running the software.
  16.  
  17. Fortunately Bryan Scattergood stepped in and spent a merry
  18. evening manually rearranging the distribution into the workable
  19. state you have now. He therefore deserves the bulk of the
  20. credit for this release.
  21.  
  22. LaTeX2e (optional)
  23. ~~~~~~~~~~~~~~~~~~
  24.  
  25. A new version of LaTeX, LaTeX2e was recently released, and this
  26. is (to my knowledge) the first release of it for the Arc. It
  27. provides (apparently) lots of new features and has a backwards
  28. compatibility mode. I had to recompile initex and virtex to
  29. increase the pool size to make this work with LaTeX2e. I had some
  30. trouble doing this, and I can give no guarantees that it won't
  31. all fall over horribly when you try and do something I have
  32. missed - it does however pass all the tests I have run on it.
  33.  
  34. While we can make no guarantees that the setup as given is the
  35. best TeX setup possible on the Arc, it does seem to work fairly
  36. reliably for us. Hopefully it will be of some use to others too.
  37. If you do find any problems with it, then please get in touch
  38. (especially if you know how to solve them >8*) ).
  39.  
  40. What are TeX and LaTeX?
  41. ~~~~~~~~~~~~~~~~~~~~~~~
  42.  
  43. TeX is a professional typesetting program used especially for
  44. typesetting technical or mathematical material. Using plain
  45. TeX is a bit like trying to mow Wembley Stadium with nail
  46. clippers, so Leslie Lamport produced a set of macros for
  47. TeX, called LaTeX, that drastically reduce the work required
  48. to produce high quality documents.
  49.  
  50. TeX was designed by Knuth for him to write his (still
  51. unfinished) epic "The Art of Computer Programming" with, and
  52. has since been adopted by (amoung others) the American
  53. Mathematical Society. Many technical publications now only
  54. accept submissions in TeX or LaTeX format.
  55.  
  56. Many books on TeX and LaTeX are available - amoung the best
  57. are "The TeX book" and "The LaTeX book" by Knuth and Lamport
  58. respectively.
  59.  
  60. If you stil don't have a clue what I am going on about then
  61. don't worry - TeX is probably not for you.
  62.  
  63. How do TeX/LaTeX compare with (say) Impression?
  64. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  65.  
  66. There is no comparison - that's not to say that one is better
  67. than the other, just that they address totally different
  68. needs.
  69.  
  70. Impression (and similar programs) are WYSIWYG (What you see
  71. is what you get); you construct a page on the screen exactly
  72. as you would see it on the printed page. Creating attractive
  73. posters, pamphlets and even books is a relatively simpe task,
  74. but technical reports with many inline equations, diagrams
  75. and special characters can pose real problems.
  76.  
  77. TeX and LaTeX are different. You write a text file that
  78. contains both your text and formatting instructions, along
  79. with pointers to illustrations to include, and then submit
  80. this to TeX, which 'compiles' you an output file (known as
  81. a DVI file). Creating technical or mathematical reports is
  82. trivial with TeX as it structures and consistently lays out
  83. your document in a given style, but creating posters etc is
  84. much harder work.
  85.  
  86. Another big point in TeXs favour is its standardness - TeX
  87. implementations exist for a vast number of machines,
  88. particularly Unix systems, and so your document source code
  89. is trivially portable between many systems. Many people
  90. doing 'science' subjects at University will use TeX in
  91. one form or another.
  92.  
  93. So how do I use it?
  94. ~~~~~~~~~~~~~~~~~~~
  95.  
  96. First, using your favourite editor, you create a LaTeX or a
  97. TeX file, and save this onto disc. TeX and LaTeX files have
  98. type &2A7 and &2A8 respectively.
  99.  
  100. Next, just double click these and TeX/LaTeX should do its job.
  101. When they finish you should be left with a Log file that
  102. describes what went on during compilation, and a DVI output
  103. file.
  104.  
  105. To check the output, double click the DVI file and !DVIView
  106. should start up and display the DVI file.
  107.  
  108. To print, either take the DVI file to the nearest machine
  109. with a DVI printer routine on it, or save the pages out as
  110. Draw files from the previewer and print those.
  111.  
  112. Installation
  113. ~~~~~~~~~~~~
  114.  
  115. Be prepared - it takes a lot of space.
  116.  
  117. First you unpack DVIview, TeXBase1, TeXBase2, TeXFnts1,
  118. TeXFnts2, TeXFnts3, TeXFnts4 and TeXFnts5 into the same
  119. directory. This is a fairly minimal working setup.
  120.  
  121. Next, if you want DaTeX, unpack that into the same directory.
  122. This is a WIMP front end for TeX, SliTeX, LaTeX and DVIview
  123. which some people like.
  124.  
  125. Next, if you want LaTeX2e, unpack that into the same directory.
  126.  
  127. All this stuff I have tested, and it works as far as I can see.
  128.  
  129. Now for the dodgy bits - none of this will break anything that
  130. works at present - the new bits just may not work quite right.
  131. They are almost right, but may need some tweaking. I will try
  132. and refine these for later releases anf make them more reliable,
  133. but there is a rush in for the CD pressing deadline.
  134.  
  135. (If anyone does manage to make these work, please let me know :-) )
  136.  
  137. If you want dvips, then unpack this into the same directory.
  138. This appears to work OK, but I haven't tested it thoroughly by
  139. any means.
  140.  
  141. If you want lgrind, then unpack this into the same directory. I
  142. haven't tested this at all :-(
  143.  
  144. If you want BibTeX, then unpack this into the same directory. This
  145. is the ArMaTuReS BibTeX, and seems to have problems with its input
  146. paths. Fixing these should make it all work (hopefully).
  147.  
  148. For the would be TeX hackers out there, you can also unpack TeXExtr1
  149. and TeXExtr2 to get some more intersting TeX binaries and other
  150. associated files.
  151.  
  152. For the really hardcore out there, the entire source for LaTeX2e
  153. can be found in L2eSrc1 and L2eSrc2.
  154.  
  155. ------------------------------------------------------------
  156. Well, thats about all I can think of to say at present. Good
  157. luck. If you have any trouble with this, then feel free to
  158. write to me at:
  159.  
  160. Warm Silence Software,
  161. St Catherines College,
  162. Manor Road,
  163. Oxford, OX1 3UJ
  164.  
  165. or e-mail me at:
  166.  
  167. Robin.Watts@comlab.ox.ac.uk
  168.  
  169. I am by no means a TeXpert, but I will help if I can. (It
  170. should be stressed that this is NOT a Warm Silence Software
  171. product, so please don't blame us if it all goes wrong.)
  172.  
  173. Happy teXing,
  174.  
  175.         Robin Watts
  176.