home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / textprocess / armtex / texbase1 / ReadMe
Text File  |  1995-03-16  |  10KB  |  291 lines
  1. ArmTeX 3.141 - Release 2.05        15/03/95
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4. *********************************************************************
  5. * NOTE TO DOWNLOADERS: These archives are all ZIP deflate archives. *
  6. * A recent version of SparkFS/Spark/SparkPlug is required to unpack *
  7. * these. Always check you are using the most recent version around  *
  8. * before you complain to me - Hensa/Stuttgart have recent versions. *
  9. *********************************************************************
  10.  
  11. These directories contain a pre-installed and setup version
  12. of ArmTex 3.141, with LaTeX 2.09, 2e and all the trimmings. It
  13. is hoped that by supplying these files in this easy to install
  14. form many first time users of TeX and LaTeX will succeed in
  15. getting started.
  16.  
  17. Where did the files come from?
  18. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  19.  
  20. The files were pulled back from the University of Stuttgart ftp
  21. server, and manually unpacked. I then discovered to my horror
  22. that not only were there minimal setup instructions, the script
  23. they suggested using was broken. They also required David
  24. Pillings excellent 'SparkFS' software to be loaded whilst
  25. running the software.
  26.  
  27. Fortunately Bryan Scattergood stepped in and spent a merry
  28. evening manually rearranging the distribution into the workable
  29. state you have now. He therefore deserves the bulk of the
  30. credit for this release.
  31.  
  32. LaTeX2e (optional)
  33. ~~~~~~~~~~~~~~~~~~
  34.  
  35. A new version of LaTeX, LaTeX2e was recently released, and this
  36. is (to my knowledge) the first release of it for the Arc. It
  37. provides (apparently) lots of new features and has a backwards
  38. compatibility mode. I had to recompile initex and virtex to
  39. increase the pool size to make this work with LaTeX2e. I had some
  40. trouble doing this, and I can give no guarantees that it won't
  41. all fall over horribly when you try and do something I have
  42. missed - it does however pass all the tests I have run on it.
  43.  
  44. While we can make no guarantees that the setup as given is the
  45. best TeX setup possible on the Arc, it does seem to work fairly
  46. reliably for us. Hopefully it will be of some use to others too.
  47. If you do find any problems with it, then please get in touch
  48. (especially if you know how to solve them >8*) ).
  49.  
  50. Some early releases of this distribution had problems with
  51. LaTeX2e running out of space. I have now increased the memory
  52. available, and juggled some of the variables, so hopefully
  53. everything should now work. (Yeah right!)
  54.  
  55. DVIPS (optional)
  56. ~~~~~~~~~~~~~~~~
  57.  
  58. Included in this release is a new port of dvips 5.55, supplied
  59. with source if required. This was ported by David Bryan, who's
  60. full address can be found in the !dvips.!ReadMe file, and is
  61. designed especially to work with ArmTeX.
  62.  
  63. As well as the dvips archives, you also need to take the PSFonts
  64. archive.
  65.  
  66. MakeIndex (optional)
  67. ~~~~~~~~~~~~~~~~~~~~
  68. Again ported by David Bryan, this is the useful MakeIndex utility,
  69. again with full source if required.
  70.  
  71. DaTeX (optional)
  72. ~~~~~~~~~~~~~~~~
  73.  
  74. This is a nice front end for TeX. For people that are scared
  75. of the command line.
  76.  
  77. SemTeX (optional)
  78. ~~~~~~~~~~~~~~~~~
  79.  
  80. This is another (nicer?) front end for TeX. Try both and see
  81. which one you like.
  82.  
  83. BibTeX (optional)
  84. ~~~~~~~~~~~~~~~~~
  85.  
  86. This is BibTeX ripped out of Graham Toals ArMaTuReS TeX
  87. distribution. It seems to work OK though thanks to the help
  88. of Alun Jones and Dick Alstein. Dick has also provided a nice
  89. little WIMP front end for BibTeX that fills the deficiency
  90. in DaTeX.
  91.  
  92. archepsf.sty
  93. ~~~~~~~~~~~~
  94.  
  95. This little piece of TeX hackery is used for including the output
  96. from Acorns Printer drivers (and Artworks EPS?) in TeX documents.
  97. Basically, it is the same as epsf.sty but with the minor mod
  98. that it will accept stuff normally found in the Header anywhere
  99. in the document. This makes up for the (atend) bits of postscript
  100. that conventional epsf.sty doesn't like.
  101.  
  102. AMS-LaTeX
  103. ~~~~~~~~~
  104.  
  105. This is the American Mathematical Societies set of macros that
  106. augment LaTeX to provide fun and exciting maths sybols and the
  107. like. Included with these are some TeX fonts - !DVIview will not
  108. preview these yet, but maybe someday... Thanks to Chris Taylor
  109. for this. You require LaTeX2e before you can use this.
  110.  
  111. Tr2LaTeX
  112. ~~~~~~~~
  113.  
  114. This is the source and binaries for a tool for converting tr files
  115. (like Unix man pages) to LaTeX. Again this is down to Chris
  116. Taylor.
  117.  
  118. What are TeX and LaTeX?
  119. ~~~~~~~~~~~~~~~~~~~~~~~
  120.  
  121. TeX is a professional typesetting program used especially for
  122. typesetting technical or mathematical material. Using plain
  123. TeX is a bit like trying to mow Wembley Stadium with nail
  124. clippers, so Leslie Lamport produced a set of macros for
  125. TeX, called LaTeX, that drastically reduce the work required
  126. to produce high quality documents.
  127.  
  128. TeX was designed by Knuth for him to write his (still
  129. unfinished) epic "The Art of Computer Programming" with, and
  130. has since been adopted by (amoung others) the American
  131. Mathematical Society. Many technical publications now only
  132. accept submissions in TeX or LaTeX format.
  133.  
  134. Many books on TeX and LaTeX are available - amoung the best
  135. are "The TeX book" and "The LaTeX book" by Knuth and Lamport
  136. respectively.
  137.  
  138. If you stil don't have a clue what I am going on about then
  139. don't worry - TeX is probably not for you.
  140.  
  141. How do TeX/LaTeX compare with (say) Impression?
  142. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  143.  
  144. There is no comparison - that's not to say that one is better
  145. than the other, just that they address totally different
  146. needs.
  147.  
  148. Impression (and similar programs) are WYSIWYG (What you see
  149. is what you get); you construct a page on the screen exactly
  150. as you would see it on the printed page. Creating attractive
  151. posters, pamphlets and even books is a relatively simpe task,
  152. but technical reports with many inline equations, diagrams
  153. and special characters can pose real problems.
  154.  
  155. TeX and LaTeX are different. You write a text file that
  156. contains both your text and formatting instructions, along
  157. with pointers to illustrations to include, and then submit
  158. this to TeX, which 'compiles' you an output file (known as
  159. a DVI file). Creating technical or mathematical reports is
  160. trivial with TeX as it structures and consistently lays out
  161. your document in a given style, but creating posters etc is
  162. much harder work.
  163.  
  164. Another big point in TeXs favour is its standardness - TeX
  165. implementations exist for a vast number of machines,
  166. particularly Unix systems, and so your document source code
  167. is trivially portable between many systems. Many people
  168. doing 'science' subjects at University will use TeX in
  169. one form or another.
  170.  
  171. So how do I use it?
  172. ~~~~~~~~~~~~~~~~~~~
  173.  
  174. First, using your favourite editor, you create a LaTeX or a
  175. TeX file, and save this onto disc. TeX and LaTeX files have
  176. type &2A7 and &2A8 respectively.
  177.  
  178. Next, just double click these and TeX/LaTeX should do its job.
  179. When they finish you should be left with a Log file that
  180. describes what went on during compilation, and a DVI output
  181. file.
  182.  
  183. To check the output, double click the DVI file and !DVIView
  184. should start up and display the DVI file.
  185.  
  186. To print, either take the DVI file to the nearest machine
  187. with a DVI printer routine on it, or save the pages out as
  188. Draw files from the previewer and print those.
  189.  
  190. Installation
  191. ~~~~~~~~~~~~
  192.  
  193. Be prepared - it takes a lot of space.
  194.  
  195. First you unpack DVIview, TeXBase1, TeXBase2, TeXFnts1,
  196. TeXFnts2, TeXFnts3, TeXFnts4 and TeXFnts5 into the same
  197. directory. This is a fairly minimal working setup.
  198.  
  199. Next, if you want DaTeX (and/or SemTeX), unpack that into the
  200. same directory.
  201.  
  202. Next, if you want LaTeX2e, unpack that into the same directory.
  203.  
  204. All this stuff I have tested, and it works as far as I can see.
  205.  
  206. If you want dvips, then unpack this into the same directory.
  207.  
  208. If you want lgrind, then unpack this into the same directory. I
  209. haven't tested this at all :-(
  210.  
  211. If you want BibTeX, then unpack this into the same directory. This
  212. is the ArMaTuReS BibTeX, but it seems to work OK now.
  213.  
  214. If you want AMS-LaTeX, then unpack this to the same directory.
  215.  
  216. If you want Tr2LaTeX, then unpack this whereever you want to.
  217.  
  218. For the would be TeX hackers out there, you can also unpack TeXExtr1
  219. and TeXExtr2 to get some more intersting TeX binaries and other
  220. associated files.
  221.  
  222. For the really hardcore out there, the entire source for LaTeX2e
  223. can be found in L2eSrc1 and L2eSrc2.
  224.  
  225.  
  226. Changes from 2.03 -> 2.05
  227. ~~~~~~~~~~~~~~~~~~~~~~~~~
  228.  
  229. New dvips.
  230. New MakeIndex.
  231. New tr2LaTeX and AMSLaTeX programs.
  232.  
  233. Changes from 2.01 -> 2.03
  234. ~~~~~~~~~~~~~~~~~~~~~~~~~
  235.  
  236. New DVIview (and TeXFonts upgrade).
  237. Included SemTeX in the distribution.
  238. Fixed names of Ulasy.fd and Ullasy.fd t avoid warnings in LaTeX2e.
  239.  
  240. Changes from 2.01 -> 2.02
  241. ~~~~~~~~~~~~~~~~~~~~~~~~~
  242.  
  243. Fixed problems with MFInputs$Path.
  244. Updated Run$Path rather than multiple aliases.
  245. Fix dvips to find binaries.
  246.  
  247. Changes from 2 -> 2.01
  248. ~~~~~~~~~~~~~~~~~~~~~~
  249.  
  250. Fixed problem with dvips assuming !TeX.Bin was in the Run$Path.
  251. Fixed problem with LaTeX 2.09/2e exec scripts unsetting BibTeX from path.
  252.  
  253. Credits:
  254. ~~~~~~~~
  255. (If I have missed anyone, then sorry - contact me, and I'll put you in)
  256.  
  257. Dick Alstein        (BibTeX/!BibTeX)    wsinda@win.tue.nl
  258. David Arnold        (DaTeX)            daa93@aber.ac.uk
  259. David Bryan        (!dvips/!MakeIndex)    djb1003@phx.cam.ac.uk
  260. Chris Holgate        (Fix for !dvips)    c.holgate@ic.ac.uk
  261. Paul Field        (!DVIview)        paulf@dcs.qmw.ac.uk
  262. Alun Jones         (BibTeX/archepsf.sty)
  263. Mark J Sinke        (Original Port)        marks@stack.urc.tue.nl
  264. Bryan Scattergood    (Making it all work!)    jbs@comlab.ox.ac.uk
  265. Chris Taylor        (Hinted fonts)        c.taylor@ucl.ac.uk
  266. Graham Toal        (BibTeX port)
  267.  
  268. (Alun Jones, is on email, but I don't have his address with me. If people
  269. want it, then mail me.)
  270. -------------------------------------------------------------------------
  271. Well, thats about all I can think of to say at present. Good
  272. luck. If you have any trouble with this, then feel free to
  273. write to me at:
  274.  
  275. Warm Silence Software,
  276. St Catherines College,
  277. Manor Road,
  278. Oxford, OX1 3UJ
  279.  
  280. or e-mail me at:
  281.  
  282. Robin.Watts@comlab.ox.ac.uk
  283.  
  284. I am by no means a TeXpert, but I will help if I can. (It
  285. should be stressed that this is NOT a Warm Silence Software
  286. product, so please don't blame us if it all goes wrong.)
  287.  
  288. Happy TeXing,
  289.  
  290.         Robin Watts
  291.