This is README for the armTeX 3.141 package

It is written by Mark J. Sinke, marks@stack.urc.tue.nl. It may not be
100% correct, but it surely gives an indication of what you need and
what not. If you find bugs, or have comments or anything, send them
to my e-mail address or to
 Mark J. Sinke
 Mendelssohnstraat 5
 5144 GD Waalwijk

You can also order discs from that address. Send a postcard first, so
I can check how much it will cost, and how we'll transfer the money.

But now for the the real thing:

This file describes what to do when you want to install armTeX 3.141
If you got the package by disc, you can skip the next part.

For all of you, that got the package by ftp or e-mail: you must first put
all these files on disc. It's very convenient to have backups (I noticed
this when I got this hard disc crash) and for the install scripts to work
correctly it is absolutely necessary. Of course, you can determine what
to do from the scripts and install them by yourself, if you want to.

To make these discs, label each disc according to the name of the received
archive, e.g., an archive labeled `TeXContr1' should have a disc `TeXContr1'
associated with it, and then unpack the files using Spark to the disc.

As an example, the `TeXFormats' archive is handled with as follows:
  - Format a disc and label it TeXFormats
  - Extract all the files from the TeXFormats archive to the TeXFormats disc
    (these are two more archives)
  - The disc will now hold the files TeXFormats and TeXmacros

Do this for all the discs you mailed or FTP'ed.

READ FURTHER HERE IF YOU GOT THE PACKAGE ON DISC OR E-MAIL OR FTP.

For both types of distribution:
 - Create a temporary directory on your hard disc. 
 - Copy the Set-TeX, BuildSmall and BuildEpson files from the Library1
   disc to this directory
 - Make this temporary directory the current and type
     BuildSmall dir_name
   where dir_name stands for the name of the directory to hold TeX in.

BuildEpson doesn't work, but look at it for how to copy fonts.

If you write a good installation program I'm very keen to have a copy!
(But it must be freeware, as all programs in my distrib are).

The script will issue several questions for disc swaps.

(In the future there will be support for the Laserjet, Postscript and
Deskjet devices as well)

After installation is complete, you can remove the temporary directory and
its contents.

Now edit the Set-TeX file in the TeX directory for other filing systems
if needed. Alter your !Boot application or file to run Set-TeX as well,
and... presto, all should work well.


The rest of this file describes what's on which disc.

The standard armTeX 3.141 distribution consists of the discs
  TeXFormats Library1 Library2 MFSources1 RiscFonts1 RiscFonts2 LaTeXJan92
  Support

The TeX sources & programs set consists of the discs
  DviDrv RiscWare Unport1 TeXContr1 TeXContr2 MF Misc TeX_Source Utilities

The TeX Files set consists of the discs
  LaTeXSour1 LaTeXSour2 MFBook BibSty1of2 BibSty2of2 AmsTeX1of2 AmsTeX2of2
  Notes MFContrib TeXBook

Currently, only the standard distribution is available via FTP.

===========================================================================

TeXFormats: precompiled formats from TeX plus tex.pool plus (plain) TeX
            macros

Formats:
lplain.fmt - format file for LaTeX (as of January '92, dutch & english
             hyphenation patterns preloaded)
plain.fmt  - format file for plain TeX
Other:
tex.pool   - TeX's string pool, from WEB.
             You need a (Pascal) WEB run to recreate this.

These might be built using INITEX, but it's more convenient this way.

TeX macros:
hyphen   - english hyphenation macros
manmac   - macros for both the TeXbook and the METAFONTbook
mftmac   - input file for files processed with mft
nul,
null     - null-length files, to escape \TeX's question for an
         input file name
plain    - the plain macro package
story    - the story.tex file from the TeXbook
tb0cyr   - a TUGboat article about the cyrillic and ams fonts
tb0hyf   - a TUGboat hyphenation exception log
testfont - a test file for font development
tubguide - guide for TUGboat authors
tugbot,
tugboat,
tugproc  - TUGboat \input files
webmac   - macros used in files produced using weave.

===========================================================================

RiscFonts1 and 2: Computer Modern fonts in Outline format and \LaTeX\ fonts
           in bitmap format plus the !Preview application

cm1      - first part of the Computer Modern fonts
cm2      - second part of the Computer Modern fonts
LaTeX    - \LaTeX\ fonts
!DVIview - The previewer (no sources)

=========================================================================== 

RiscWare: sources of programs written to run on an Archimedes only and
          some other things

Programs:
gftofnt  - convert a .gf file into a RISC OS style bitmap font (RISC OS 2 up)
CWEB     - full port of CWEB to the Archimedes (some more memory, allow
           RISC OS identifiers, ANSI C function specifiers and the like).
tape     - a document style to produce tape labels

The gftofnt executable is on the Executables discs.

===========================================================================

TeXbook: source of the TeXbook, as a giant TeX file.

TeXbook.tex - the source

You cannot view this on the (current version of the) previewer, as doesn't
fit in memory (at least not in the way !Preview likes it. It is possible
to generate the dvi file and print it out. This is not the meaning of this
file. It is distributed only as an example of what TeX can do. It is a 
good idea to buy the TeXbook anyway, if you want to use plain TeX. It
costs about f79,- (Dutch guilders), and its very good value for money.)

===========================================================================

Notes: lots of miscellaneous notes about porting TeX and its
       companions plus the BibTeX sources

Notes    - archive of notes
BibTeX   - BibTeX sources plus BibTeX input files
TeXdoc   - some general \TeX\ documentation files: csname, errata.tex,
           history, LiteratePr, PXLFormat, README, sample.tex, story.tex,
           tex82_bug
ManPages - manual pages for many of the programs on these discs
           there's a tex file to compile for a reference manual.

===========================================================================

Sources1...4: sources of various TeX utilities.
           These four discs contain the complete sources of TeX and friends.
           To recreate TeX or so, you need to glue these together and the
           result is a readable archive.

Some notes: I didn't get mft to work. All the other utilities perform as should.
TeX and MF have passed the trip and trap tests, respectively.

Also, I didn't port bibTeX, but it might turn out to be simple if I have
a sed version >= 1.10 (the version I now have chokes on several _sed files
in this distrib. I could get myself to do the sed commands myself for
METAFONT, but for bibTeX, I didn't even try, as I don't use it myself).

===========================================================================

MFContrib: METAFONT contributions

In the MFContrib archive are:

adobefonts - aftopl sources (convert AFM to PL files); unported.
fonttool   - sources of fonttool, an interactive PXL file editor for Sun
             workstations (unported).
metafonts  - the following typeface families: CM cyrillic, Computer Concrete,
             OCR, Pandora, Punk, Tamil and some miscellaneous.
        
===========================================================================

TeXContr1 and 2: TeX contributions

In the TeXContr1 and TeXContr2 archives are:

chemtex    - how to typeset chemical formulas in (La)TeX
gnuplot    - GNU plot program
kamal      - several filters for TeX output etc. many of the executables are
             on the executables disc. Some are unported.
knit       - a change file for tangle/weave, to allow multiple change files
             (unported)
literate_m - a kind of WEB programming system for any language, with lots of
             limitations (unported)
miscellane - hptex (function unknown, looks outdated); profile_web: profile
             web programs (not very useful, unported)
pittman    - the cellular system for building tables in plain TeX. (Should
             not need porting or the like).
rusty      - source for the r2bib program, to convert refer files into
             BibTeX format (unported).
sauter     - automatic generation of CM parameter files. Implemented mostly
             in Unix scripts, so unported.
tib        - a program to use indexes and references in plain TeX. Unported.
urban      - sources of ``\TeX, a guide for the troff user''.
uw         - ansitar, a program to read ANSI tar files (unported);
             cnowed, a demonstration of how to use \TeX\ and C mixed,
             without external programs; fontbl_tex, a file to make a
             table of a given font.
van        - s2latex, convert Scribe to LaTeX, unported; tgrind,
             pretty-print source files (for a.o. Pascal and C)
             (busy porting).

===========================================================================

MFbook: The METAFONTbook sources, and some MFT files

MFbook     - the sources for the METAFONTbook (see remarks about the TeXbook)
MFTeXFiles - some mft files (I never tried them)

===========================================================================

MFSources1: METAFONT sources for the CM fonts and the LaTeX fonts and many
            TFM files

Basic_MF   - the plain format as an MF file etc.
cm_MF      - sources of the CM fonts plus TFMs for them
LaTeX_MF   - sources of the LaTeX fonts plus TFMs for them
MFBases    - the plain format as a base file and mf.pool
TFMs       - directory of archives holding TFMs of the cmcyr, concrete,
             ocr, pandora, punk, tamil and washington fonts

===========================================================================

LaTeXJan92: The LaTeX package, as of 15-Jan-92

doc      - documented style files
sty      - uncommented style files
general  - the LaTeX sources
ExtraSty - a small bunch of the Babel macros, just enough to make LaTeX
             work in dutch and english. A few other style files.

===========================================================================

Unport1: Unported things

Spiderweb  - the spidery WEB system (I might port this in the near future)
TeXgraphic - all kinds of graphics things for/by TeX

===========================================================================

Library1 & 2: Executables discs.

Library1:
dvieps    - Epson 9-pin printer driver
initex    - 64k INITEX variant (armTeX 3.141)
virtex    - 64k TeX variant (armTeX 3.141)
inimf     - INIMF, version 2.71
virmf     - MF, version 2.71
biginitex - 256k INITEX variant. Need a virtual task window and about four meg
            of swap space to run this.
bigvirtex - 256k TeX variant. Idem.

Set-TeX   - Obey script to set up various system variables for use with TeX
BuildSmall- Obey script to install a basic TeX/METAFONT package
BuildEpson- Obey script to install the Epson printer driver and the most-used
            fonts

Library2:
dvialw    - Postscript printer driver
dvijep    - Laserjet printer driver, using downloaded fonts
dvidjp    - Deskjet printer driver
lp        - simple obey script to save typing
MF, TeX, cllatex, make300pk - same
detex     - strip (La)TeX commands from TeX files (for spell checking etc.)
dvitype   - display DVI file in human-readable way
gftofnt   - convert GF file to RISC OS font files
gftopk    - convert GF font to PK font
lacheck   - check matching braces, environments etc. in (La)TeX documents
mft       - pretty-print METAFONT programs (old version)
patgen    - hyphenation pattern generator
pktogf    - convert PK font to GF font
pltotf    - convert PL file to TFM file
pooltype  - show .pool file in human-readable format
tangle    - convert WEB file to Pascal (needed to rebuild TeX)
texeqn    - extract equations from TeX
texexpand - expand a TeX file, i.e., read its \input and \include files
            and output a single larger file
texindex  - build indexes for use with the texinfo system
texmatch  - check matching in TeX files
tftopl    - convert TFM file to PL file
tr2tex    - (do an attempt to) convert troff files to tex files
vftovp    - convert VF files to VP files
vptovf    - convert VP files to VF files
weave     - convert WEB file to TeX
biginimf  - 256k INIMF variant. Need a virtual task window.
bigvirmf  - 256k MF variant. Idem.

makeobey - make an obey file containing lots of commands to generate all the
           fonts in this directory at various \magstep's for a single
           printer
man2tex  - convert a Unix-style man page into a .tex file. It is not
           complete, i.e., doesn't convert all .man files, but it does for
           (most of) the man files from these discs.

===========================================================================

BibSty1of2 and BibSty2of2: Bibliography of style files. Too much to describe
           here. Perhaps I'll compile an index some time.

===========================================================================

LaTeXSour1: LaTeX files

array      - Frank Mittelbach's array.sty
Babel      - Johannes Braams' Babel package (multi-lingual LaTeX)
Devanagari - typeset Hindu texts
fontsel    - implementation of the NFSS
ftnright   - better footnotes in multi-column context
theorem    - define your own theorem-like environments
verbatim   - enhanced verbatim envrionment

============================================================================

LaTeXSour2: LaTeX files and TeX files

JemTeX  - Japanese TeX, needs a big TeX (> 64k)
Seminar - Slides within LaTeX (not SliTeX)

===========================================================================

AmsTeX1 and 2: The complete AmsTeX package

These two discs contain AmsTeX, as described in Spivak's `The Joy Of \TeX',
including various fonts (Euler, ams symbol fonts, ...).

===========================================================================

Support: support programs

MakeIndex - the LaTeX indexing program (unported, yet...)
            (didn't fit on other disc)
!Virtual  - A virtual task manager
fcat      - A file concatenation program
chop      - A file chopper
sed       - A sed clone
everywhere- A util to do things everywhere
web2c     - directory containing web2c, splitup etc. If you need them,
            you know what they do.

============================================================================

DviDrv: Sources of various dvi drivers

dvidjp - dvi driver for HP Deskjet
dvieps - for Epson 9-pin
dvivw  - for !DviView

=============================================================================

LJFonts1...3: (three discs)

LaserJet fonts, fcat the three files together to build a usable archive.

=============================================================================