01659@AECLCR.BITNET (Greg Csullog) (05/02/89)
The following shows some of the documentation that came with the Current Notes
TeX/LaTeX disks. Details have been removed to shorten the listing
--------------------------------------------------------------------
TeX for ATARI ST
This is just the ST specific executables for TeX. The entire TeX
distribution is large but can be obtained from other sources.
The WEB (ie PASCAL) sources for TeX were translated to C by TEX-TO-C.
The C sources had to be modified to get around bugs in the MEGAMAX C
compiler. GNU C should compile the originals.
There are 2 TeX programs:
INITEX is only used to build format files (FMT). Once this is
done it can be put away in a safe place.
VIRTEX (or just TEX) is the production program . It loads the FMT
files (PLAIN for plain TeX , LPLAIN for LATEX etc) and then typesets
your document.
Sugested directories:
\TEX\ put TEX.TTP and *.FMT here
\TEX\TFM\ put TFM files here
\TEX\INPUTS\ put LATEX Style files etc here
More info on TEXST.TEX .
TeX is written by Donald Knuth
Tex-to-C is written by Tim Morgan and Tony Rokicki
TeX Shell is a graphical interface to TeX, a typesetting program. This
documentation assumes that you know something about TeX already. TeX is
available (as I write this) via anonymous FTP from "clio.math.lsa.umich.edu"
and no doubt other sites.
When running TeX on a 1 meg machine, there isn't enough free memory to
run shells such as Gulam. So, I wrote TeX Shell. TeX Shell displays a
menu and lets you choose to run TeX or LaTeX, and uses the file selector
to choose the input file. TeX Shell then Pexec()s TeX with an appropriate
command line. It can also Pexec DVIST, the screen preview program.
As you can see, most of the menu items are disabled. Eventually I would
like to add several features: an editable environment, and a direct chain
(a la Simon Poole's DLII) to a graphical version of the DVI program available
elsewhere. Also, if you could chain to your editor from TeXShell, then
you would not have to go back to the desktop at all while
editing/texing/previewing.
Since you have no way of setting environmental variables (yet), you
MUST install TeX with all the default paths. It must be on the same
disk as TeX Shell, in the directory \TEX, be named TEX.TTP, and be
with PLAIN.FMT and LPLAIN.FMT, the Plain TeX and LaTeX format files.
The font metric files (.TFM) should reside in \TEX\TFM, and style
files should reside in \TEX\INPUTS. DVIST should be located in
\TEX\DVIST.TTP (pick one of DVISTND or DVISTDL), and fonts should be
in the default \FONTS\... directories.
Should an error occur during the Pexec, such as file not found or
whatnot, weird things will happen. I have not managed to get an
intelligible error message out of Pexec yet, so you'll have to guess.
I have included another file, TEXHINTS, in this archive to help you
set up TEX and DVIST to work together.
If you have any suggestions for this program, or find any bugs (heaven
forbid!), please feel free to contact me.
Greg Lindahl internet: gl8f@virginia.edu
1700 Cherry Avenue bitnet: gl8f@virginia.bitnet
Charlottesville VA 22903
(804) 979-3814
This is a set of hints for using the ST version of TeX together
with DVIST, a screen preview program.
The .FMT files dictate which fonts TeX will use. Most sizes of
fonts can be generated in two ways: either by using exactly the
correct font, or using a magnification of some other smaller or
larger font.
As it turns out, DVIST is distributed with only a limited set of
fonts. TeX is not distributed with .FMT files, so you must build
them using INITEX and input files PLAIN.TEX, LPLAIN.TEX, LATEX.TEX,
and LFONTS.TEX taken from your favorite minicomputer. I have access
to two different machines running TeX. One of them had its LaTeX
fonts built with 12 point fonts as 12 point fonts, and the other
had 12 point fonts made with magnified 10 point fonts. The
distribution of DVIST contains 10 point fonts in the magnification
needed to mimic the 12 point fonts, but does not have 12 point
fonts.
I randomly built LPLAIN.FMT using the real 12 point fonts, and found
that DVIST could not process any .DVI output generated by TeX due
to missing fonts. I ended up rebuilding it using the magnified 10
point version of LFONTS.TEX, and everything works fine now.
What we really need are an archive of .FMT files which work with
DVIST.
OVERVIEW OF ST TeX/LaTeX/DVIST/DVIEPS/etc.
==========================================
<<<<<<<<<<<<< details deleted for NET posting >>>>>>>>>>>>>>>>>
WHAT'S IN THIS DISTRIBUTION:
============================
TEX.TTP - The TeX program itself for the ST.
*.TEX - Documents that TeX/LaTeX can read as inputs.
(Can be text of your manuscript, TeX macro
definitions to implement new commands, etc.)
*.DVI - TeX binary output files that can be viewed,
printed, etc. with DVIST, DVIEPS, etc., or moved
to another kind of computer and printed there too.
PLAIN.FMT - Compiled TeX macros that define the standard TeX
features.
LPLAIN.FMT - Compiled TeX macros to implement LaTeX.
INITEX.TTP - Compiles TeX macro libraries.
DVIEPS.TTP - Program to print DVI files on an Epson 9-pin
printer at 240x216 dots-per-inch.
DVIE72.TTP - Like DVIEPS but uses extremely low resolution (the
"plot mode" on many Epsons), that does
72x72 dots-per-inch quickly.
DVIST.TTP - Program to display DVI files on the screen as they
would appear if printed. (Monochrome!)
*.TFM - "TeX Font Metric" files. These are read by TeX to
let it know how big each character in a typeface is
when it processes your document.
*.PK - Files containing compressed font image data, for
DVIEPS and DVIST. A particular font (say CMR10,
which is 10-point tall Computer Modern Roman) will
have one .TFM file and many .PK files (for printing
at different magnifications.)
*.STY - Style files for LaTeX styles. (Article, Report,
Book, Memo, German, Esperanto, etc.)
*.DOC - These are commented versions of the .STY files.
TEX.POO - The TeX "string pool" -- a resoruce file that
contains all the text that TeX needs to print to
the screen when it runs.
TEXSHELL.PRG - A graphic shell for TeX/LaTeX/etc. on the ST. TeX
needs almost all the memory on a 1-Meg machine to
run, so this little shell is needed at times, if
you don't want to give TEX.TTP commands from the
desktop.
INSTALLING THESE:
=================
<<<<<<<<<<<< details deleted for NET posting >>>>>>>>>>>>>>>>>>>>>>>>>
RUNNING TeX OR LaTeX
====================
<<<<<<<<<<<< details deleted for NET posting >>>>>>>>>>>>>>>>>>>>>>>>>>
USING DVIST TO VIEW
===================
<<<<<<<<<<<<<< details deleted >>>>>>>>>>>>>>>>>>>>>>>>>
USING DVIEPS TO PRINT
=====================
<<<<<<<<<<<<<<< details deleted >>>>>>>>>>>>>>>>>>>>>>
NOTES ON PRINTER FONTS (somewhat technical)
======================
<<<<<<<<<<<<<< details deleted >>>>>>>>>>>>>>>>
WHERE THESE PROGRAMS CAME FROM
==============================
I don't remember which of many particular files came from which
places, but here are systems where files related to ST TeX, or TeX in
general, may be found (if you have access to FTP and/or UUCP):
netlib@lakesys.uucp - Atari ST UseNet archives
clio (35.195.16.4) - Where I got DVIST and ST TeX
dsrgsun.ces.cwru.edu (129.22.16.2) - Sources for another TeX
implementation, "CommonTeX", for the ST
score.stanford.edu - The main source for generic TeX. Lots
of .GF format fonts.
science.utah.edu - Similar to above (but no fonts)
sun.soe.clarkson.edu - Home of lots of LaTeX .STY files.
There are also some .PK font files.
cs.washington.edu - Un*x TeX sources
(I can't guarantee that this information is currently correct, nor can I
tell you much more about these hosts. These are taken from the notes
in my little black book.) Many of fonts and style files came from
local computers I have accounts on.
There are additional "toys" you can get to go with standard TeX,
which can probably be made to work on STs. These include, among
others: PiCTeX, for drawing diagrams; BibTeX, for compiling
bibliographies; and SliTeX, for making slides.
Many thanks to the authors of these programs, for writing them
for the good of all, and especially to John R. Dunning who was kind
enough to mail me DVIEPS.
Good luck with ST TeX. Let me know what happens...
- James "Kibo" Parry