home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / tex / texbase1 / !TeX / ReadMeOrig < prev   
Encoding:
Text File  |  1994-10-13  |  14.7 KB  |  372 lines
  1. This is README for the armTeX 3.141 package
  2.  
  3. It is written by Mark J. Sinke, marks@stack.urc.tue.nl. It may not be
  4. 100% correct, but it surely gives an indication of what you need and
  5. what not. If you find bugs, or have comments or anything, send them
  6. to my e-mail address or to
  7.  Mark J. Sinke
  8.  Mendelssohnstraat 5
  9.  5144 GD Waalwijk
  10.  
  11. You can also order discs from that address. Send a postcard first, so
  12. I can check how much it will cost, and how we'll transfer the money.
  13.  
  14. But now for the the real thing:
  15.  
  16. This file describes what to do when you want to install armTeX 3.141
  17. If you got the package by disc, you can skip the next part.
  18.  
  19. For all of you, that got the package by ftp or e-mail: you must first put
  20. all these files on disc. It's very convenient to have backups (I noticed
  21. this when I got this hard disc crash) and for the install scripts to work
  22. correctly it is absolutely necessary. Of course, you can determine what
  23. to do from the scripts and install them by yourself, if you want to.
  24.  
  25. To make these discs, label each disc according to the name of the received
  26. archive, e.g., an archive labeled `TeXContr1' should have a disc `TeXContr1'
  27. associated with it, and then unpack the files using Spark to the disc.
  28.  
  29. As an example, the `TeXFormats' archive is handled with as follows:
  30.   - Format a disc and label it TeXFormats
  31.   - Extract all the files from the TeXFormats archive to the TeXFormats disc
  32.     (these are two more archives)
  33.   - The disc will now hold the files TeXFormats and TeXmacros
  34.  
  35. Do this for all the discs you mailed or FTP'ed.
  36.  
  37. READ FURTHER HERE IF YOU GOT THE PACKAGE ON DISC OR E-MAIL OR FTP.
  38.  
  39. For both types of distribution:
  40.  - Create a temporary directory on your hard disc. 
  41.  - Copy the Set-TeX, BuildSmall and BuildEpson files from the Library1
  42.    disc to this directory
  43.  - Make this temporary directory the current and type
  44.      BuildSmall dir_name
  45.    where dir_name stands for the name of the directory to hold TeX in.
  46.  
  47. BuildEpson doesn't work, but look at it for how to copy fonts.
  48.  
  49. If you write a good installation program I'm very keen to have a copy!
  50. (But it must be freeware, as all programs in my distrib are).
  51.  
  52. The script will issue several questions for disc swaps.
  53.  
  54. (In the future there will be support for the Laserjet, Postscript and
  55. Deskjet devices as well)
  56.  
  57. After installation is complete, you can remove the temporary directory and
  58. its contents.
  59.  
  60. Now edit the Set-TeX file in the TeX directory for other filing systems
  61. if needed. Alter your !Boot application or file to run Set-TeX as well,
  62. and... presto, all should work well.
  63.  
  64.  
  65. The rest of this file describes what's on which disc.
  66.  
  67. The standard armTeX 3.141 distribution consists of the discs
  68.   TeXFormats Library1 Library2 MFSources1 RiscFonts1 RiscFonts2 LaTeXJan92
  69.   Support
  70.  
  71. The TeX sources & programs set consists of the discs
  72.   DviDrv RiscWare Unport1 TeXContr1 TeXContr2 MF Misc TeX_Source Utilities
  73.  
  74. The TeX Files set consists of the discs
  75.   LaTeXSour1 LaTeXSour2 MFBook BibSty1of2 BibSty2of2 AmsTeX1of2 AmsTeX2of2
  76.   Notes MFContrib TeXBook
  77.  
  78. Currently, only the standard distribution is available via FTP.
  79.  
  80. ===========================================================================
  81.  
  82. TeXFormats: precompiled formats from TeX plus tex.pool plus (plain) TeX
  83.             macros
  84.  
  85. Formats:
  86. lplain.fmt - format file for LaTeX (as of January '92, dutch & english
  87.              hyphenation patterns preloaded)
  88. plain.fmt  - format file for plain TeX
  89. Other:
  90. tex.pool   - TeX's string pool, from WEB.
  91.              You need a (Pascal) WEB run to recreate this.
  92.  
  93. These might be built using INITEX, but it's more convenient this way.
  94.  
  95. TeX macros:
  96. hyphen   - english hyphenation macros
  97. manmac   - macros for both the TeXbook and the METAFONTbook
  98. mftmac   - input file for files processed with mft
  99. nul,
  100. null     - null-length files, to escape \TeX's question for an
  101.          input file name
  102. plain    - the plain macro package
  103. story    - the story.tex file from the TeXbook
  104. tb0cyr   - a TUGboat article about the cyrillic and ams fonts
  105. tb0hyf   - a TUGboat hyphenation exception log
  106. testfont - a test file for font development
  107. tubguide - guide for TUGboat authors
  108. tugbot,
  109. tugboat,
  110. tugproc  - TUGboat \input files
  111. webmac   - macros used in files produced using weave.
  112.  
  113. ===========================================================================
  114.  
  115. RiscFonts1 and 2: Computer Modern fonts in Outline format and \LaTeX\ fonts
  116.            in bitmap format plus the !Preview application
  117.  
  118. cm1      - first part of the Computer Modern fonts
  119. cm2      - second part of the Computer Modern fonts
  120. LaTeX    - \LaTeX\ fonts
  121. !DVIview - The previewer (no sources)
  122.  
  123. =========================================================================== 
  124.  
  125. RiscWare: sources of programs written to run on an Archimedes only and
  126.           some other things
  127.  
  128. Programs:
  129. gftofnt  - convert a .gf file into a RISC OS style bitmap font (RISC OS 2 up)
  130. CWEB     - full port of CWEB to the Archimedes (some more memory, allow
  131.            RISC OS identifiers, ANSI C function specifiers and the like).
  132. tape     - a document style to produce tape labels
  133.  
  134. The gftofnt executable is on the Executables discs.
  135.  
  136. ===========================================================================
  137.  
  138. TeXbook: source of the TeXbook, as a giant TeX file.
  139.  
  140. TeXbook.tex - the source
  141.  
  142. You cannot view this on the (current version of the) previewer, as doesn't
  143. fit in memory (at least not in the way !Preview likes it. It is possible
  144. to generate the dvi file and print it out. This is not the meaning of this
  145. file. It is distributed only as an example of what TeX can do. It is a 
  146. good idea to buy the TeXbook anyway, if you want to use plain TeX. It
  147. costs about f79,- (Dutch guilders), and its very good value for money.)
  148.  
  149. ===========================================================================
  150.  
  151. Notes: lots of miscellaneous notes about porting TeX and its
  152.        companions plus the BibTeX sources
  153.  
  154. Notes    - archive of notes
  155. BibTeX   - BibTeX sources plus BibTeX input files
  156. TeXdoc   - some general \TeX\ documentation files: csname, errata.tex,
  157.            history, LiteratePr, PXLFormat, README, sample.tex, story.tex,
  158.            tex82_bug
  159. ManPages - manual pages for many of the programs on these discs
  160.            there's a tex file to compile for a reference manual.
  161.  
  162. ===========================================================================
  163.  
  164. Sources1...4: sources of various TeX utilities.
  165.            These four discs contain the complete sources of TeX and friends.
  166.            To recreate TeX or so, you need to glue these together and the
  167.            result is a readable archive.
  168.  
  169. Some notes: I didn't get mft to work. All the other utilities perform as should.
  170. TeX and MF have passed the trip and trap tests, respectively.
  171.  
  172. Also, I didn't port bibTeX, but it might turn out to be simple if I have
  173. a sed version >= 1.10 (the version I now have chokes on several _sed files
  174. in this distrib. I could get myself to do the sed commands myself for
  175. METAFONT, but for bibTeX, I didn't even try, as I don't use it myself).
  176.  
  177. ===========================================================================
  178.  
  179. MFContrib: METAFONT contributions
  180.  
  181. In the MFContrib archive are:
  182.  
  183. adobefonts - aftopl sources (convert AFM to PL files); unported.
  184. fonttool   - sources of fonttool, an interactive PXL file editor for Sun
  185.              workstations (unported).
  186. metafonts  - the following typeface families: CM cyrillic, Computer Concrete,
  187.              OCR, Pandora, Punk, Tamil and some miscellaneous.
  188.         
  189. ===========================================================================
  190.  
  191. TeXContr1 and 2: TeX contributions
  192.  
  193. In the TeXContr1 and TeXContr2 archives are:
  194.  
  195. chemtex    - how to typeset chemical formulas in (La)TeX
  196. gnuplot    - GNU plot program
  197. kamal      - several filters for TeX output etc. many of the executables are
  198.              on the executables disc. Some are unported.
  199. knit       - a change file for tangle/weave, to allow multiple change files
  200.              (unported)
  201. literate_m - a kind of WEB programming system for any language, with lots of
  202.              limitations (unported)
  203. miscellane - hptex (function unknown, looks outdated); profile_web: profile
  204.              web programs (not very useful, unported)
  205. pittman    - the cellular system for building tables in plain TeX. (Should
  206.              not need porting or the like).
  207. rusty      - source for the r2bib program, to convert refer files into
  208.              BibTeX format (unported).
  209. sauter     - automatic generation of CM parameter files. Implemented mostly
  210.              in Unix scripts, so unported.
  211. tib        - a program to use indexes and references in plain TeX. Unported.
  212. urban      - sources of ``\TeX, a guide for the troff user''.
  213. uw         - ansitar, a program to read ANSI tar files (unported);
  214.              cnowed, a demonstration of how to use \TeX\ and C mixed,
  215.              without external programs; fontbl_tex, a file to make a
  216.              table of a given font.
  217. van        - s2latex, convert Scribe to LaTeX, unported; tgrind,
  218.              pretty-print source files (for a.o. Pascal and C)
  219.              (busy porting).
  220.  
  221. ===========================================================================
  222.  
  223. MFbook: The METAFONTbook sources, and some MFT files
  224.  
  225. MFbook     - the sources for the METAFONTbook (see remarks about the TeXbook)
  226. MFTeXFiles - some mft files (I never tried them)
  227.  
  228. ===========================================================================
  229.  
  230. MFSources1: METAFONT sources for the CM fonts and the LaTeX fonts and many
  231.             TFM files
  232.  
  233. Basic_MF   - the plain format as an MF file etc.
  234. cm_MF      - sources of the CM fonts plus TFMs for them
  235. LaTeX_MF   - sources of the LaTeX fonts plus TFMs for them
  236. MFBases    - the plain format as a base file and mf.pool
  237. TFMs       - directory of archives holding TFMs of the cmcyr, concrete,
  238.              ocr, pandora, punk, tamil and washington fonts
  239.  
  240. ===========================================================================
  241.  
  242. LaTeXJan92: The LaTeX package, as of 15-Jan-92
  243.  
  244. doc      - documented style files
  245. sty      - uncommented style files
  246. general  - the LaTeX sources
  247. ExtraSty - a small bunch of the Babel macros, just enough to make LaTeX
  248.              work in dutch and english. A few other style files.
  249.  
  250. ===========================================================================
  251.  
  252. Unport1: Unported things
  253.  
  254. Spiderweb  - the spidery WEB system (I might port this in the near future)
  255. TeXgraphic - all kinds of graphics things for/by TeX
  256.  
  257. ===========================================================================
  258.  
  259. Library1 & 2: Executables discs.
  260.  
  261. Library1:
  262. dvieps    - Epson 9-pin printer driver
  263. initex    - 64k INITEX variant (armTeX 3.141)
  264. virtex    - 64k TeX variant (armTeX 3.141)
  265. inimf     - INIMF, version 2.71
  266. virmf     - MF, version 2.71
  267. biginitex - 256k INITEX variant. Need a virtual task window and about four meg
  268.             of swap space to run this.
  269. bigvirtex - 256k TeX variant. Idem.
  270.  
  271. Set-TeX   - Obey script to set up various system variables for use with TeX
  272. BuildSmall- Obey script to install a basic TeX/METAFONT package
  273. BuildEpson- Obey script to install the Epson printer driver and the most-used
  274.             fonts
  275.  
  276. Library2:
  277. dvialw    - Postscript printer driver
  278. dvijep    - Laserjet printer driver, using downloaded fonts
  279. dvidjp    - Deskjet printer driver
  280. lp        - simple obey script to save typing
  281. MF, TeX, cllatex, make300pk - same
  282. detex     - strip (La)TeX commands from TeX files (for spell checking etc.)
  283. dvitype   - display DVI file in human-readable way
  284. gftofnt   - convert GF file to RISC OS font files
  285. gftopk    - convert GF font to PK font
  286. lacheck   - check matching braces, environments etc. in (La)TeX documents
  287. mft       - pretty-print METAFONT programs (old version)
  288. patgen    - hyphenation pattern generator
  289. pktogf    - convert PK font to GF font
  290. pltotf    - convert PL file to TFM file
  291. pooltype  - show .pool file in human-readable format
  292. tangle    - convert WEB file to Pascal (needed to rebuild TeX)
  293. texeqn    - extract equations from TeX
  294. texexpand - expand a TeX file, i.e., read its \input and \include files
  295.             and output a single larger file
  296. texindex  - build indexes for use with the texinfo system
  297. texmatch  - check matching in TeX files
  298. tftopl    - convert TFM file to PL file
  299. tr2tex    - (do an attempt to) convert troff files to tex files
  300. vftovp    - convert VF files to VP files
  301. vptovf    - convert VP files to VF files
  302. weave     - convert WEB file to TeX
  303. biginimf  - 256k INIMF variant. Need a virtual task window.
  304. bigvirmf  - 256k MF variant. Idem.
  305.  
  306. makeobey - make an obey file containing lots of commands to generate all the
  307.            fonts in this directory at various \magstep's for a single
  308.            printer
  309. man2tex  - convert a Unix-style man page into a .tex file. It is not
  310.            complete, i.e., doesn't convert all .man files, but it does for
  311.            (most of) the man files from these discs.
  312.  
  313. ===========================================================================
  314.  
  315. BibSty1of2 and BibSty2of2: Bibliography of style files. Too much to describe
  316.            here. Perhaps I'll compile an index some time.
  317.  
  318. ===========================================================================
  319.  
  320. LaTeXSour1: LaTeX files
  321.  
  322. array      - Frank Mittelbach's array.sty
  323. Babel      - Johannes Braams' Babel package (multi-lingual LaTeX)
  324. Devanagari - typeset Hindu texts
  325. fontsel    - implementation of the NFSS
  326. ftnright   - better footnotes in multi-column context
  327. theorem    - define your own theorem-like environments
  328. verbatim   - enhanced verbatim envrionment
  329.  
  330. ============================================================================
  331.  
  332. LaTeXSour2: LaTeX files and TeX files
  333.  
  334. JemTeX  - Japanese TeX, needs a big TeX (> 64k)
  335. Seminar - Slides within LaTeX (not SliTeX)
  336.  
  337. ===========================================================================
  338.  
  339. AmsTeX1 and 2: The complete AmsTeX package
  340.  
  341. These two discs contain AmsTeX, as described in Spivak's `The Joy Of \TeX',
  342. including various fonts (Euler, ams symbol fonts, ...).
  343.  
  344. ===========================================================================
  345.  
  346. Support: support programs
  347.  
  348. MakeIndex - the LaTeX indexing program (unported, yet...)
  349.             (didn't fit on other disc)
  350. !Virtual  - A virtual task manager
  351. fcat      - A file concatenation program
  352. chop      - A file chopper
  353. sed       - A sed clone
  354. everywhere- A util to do things everywhere
  355. web2c     - directory containing web2c, splitup etc. If you need them,
  356.             you know what they do.
  357.  
  358. ============================================================================
  359.  
  360. DviDrv: Sources of various dvi drivers
  361.  
  362. dvidjp - dvi driver for HP Deskjet
  363. dvieps - for Epson 9-pin
  364. dvivw  - for !DviView
  365.  
  366. =============================================================================
  367.  
  368. LJFonts1...3: (three discs)
  369.  
  370. LaserJet fonts, fcat the three files together to build a usable archive.
  371.  
  372. =============================================================================