================================================================
   Welcome to 4allTeX / 4TeX -- the modular package from the NTG
==============================================================v2

(You might not make sense of all technical talk in this document. As most
of the tips are essential, it is still wise to follow them up or ask
someone else to follow them up for you, as they will put you on the right
track for a foolproof trip through 4allTeX.)

Make sure that you don't have a directory in use called EMTEX on the disk
where you are about to install 4allTeX (when you have, either rename it or
empty it. In fact, a rename could be wise, when you want to hold on to the
opportunity to simply switch back to your old EMTEX setup).
For a minimal install (i.e. disk 1) you will need about 3 Mb free disk space.
The installation script automatically creates all necessary directories and it
also takes care of putting all files in the right place. You will only need
to make a simple change to your config.sys file. The `environment space' must
be set to at least 2048 (to avoid some weird error returns while operating
TeX). To do this, the following lines in your config.sys file could exist:
    SHELL=c:\command.com /e:2048 /p
    FILES=40
4DOS/NDOS users can increase their environment space from their special
initialisation files (consult the 4DOS/NDOS documentation for more information).
Now reboot your PC, to let the above changes take effect.

Take care not to make your `original' PATH line too long. Keep it to less
than one hundred characters. One directory \EMTEX\BIN is added to this PATH in
the use of the batchfile `set_tex.bat'.


INSTALL 4allTeX
===============
We start wit floppy number 1, there are three of them:
disk01 : LaTeX2e and emTeX386. For a 386 or higher.
disk1a : LaTeX209 and emTeX86. For an XT or higher.
disk1b : LaTeX2e (autoload) and emTeX86. For an XT or higher.
These three disks can be installed over eachother (and contain
mostly the same software).

The installation program 4INSTALL.BAT needs two parameters: the source
drive and the target drive. To install disk 1 from a: to c:, issue the command

   4INSTALL A C

The program first displays a nice opening screen. It contains
some self-explanatory options. The important option is 'A': Start
installation. This will first unpack all ZIP archives from floppy 1 to
the directory c:\EMTEX and it will create the full directory structure.
Subsequently, the so called FORMAT files are produced. During this
generation of format files, some error messages are to be expected (and to
be ignored!). For your interest: FORMAT files contain binary sets of macro
commands to TeX, enabling the typesetting engine to start faster.
FORMAT files come in flavours for "plain" TeX with Dutch and American
English hyphenation patterns as well as for LaTeX (as opposed to "plain"
TeX) with Dutch, American English, "BABEL" and the New Font Selection
Scheme (NFSS), or LaTeX2e. Should something err during install,
the install script will report this to you.

Running TeX on the docs and previewing
======================================

Our first document to be looked at will be a short LaTeX manual.
For those who are comfortable with Dutch, the command
    LATEX LKORT
will run LaTeX on some Dutch documentation. The LKORT course is
also available in German (LKURZ, this is what ignited it) and
English (LSHORT), but not on disk01 (space limitations.....)
Several courses about TeX and LaTeX in english can be found on
disk D1 of the 4allTeX distribution.

The result is a binary file named lkort.dvi.
A .DVI file is the name for a `printer independant' outputfile. It can be
used to print the identical document on almost any type of printer, and it can
even be viewed on screen. Every time you run LaTeX on a file,
a file like this with .DVI extension is produced, along with some other
files each with a different extension indicating their function (to name some:
.AUX for label definitions and page references, .LOG containing a list of
your errors and some aesthetic warnings). The driver software you use makes the
same .DVI file usable to produce results on photosetters, laserjets, matrix
printers and the computer screen. The quality to the eye will differ, but it
will allways be the same document in the same typeface with the same layout.

You can use the command
    V LKORT
to view a (Dutch) LaTeX manual on your screen.

The screen output is a true replica of what will be on the printed
page. You can use the cursor keys and the PgUp / PgDn keys to navigate over
the page images. The `q' key will get you out of the viewer program.

Never mind the hickups and errors the previewer complains to you about: they
only tell you where it got the proper fonts from, and with what it
replaced any fonts it missed. With only disk 1 installed, many fonts will be
not found. These are all substituted by a clever substitution process. The
result will be suitable for a first impression of the look and feel of LaTeX.

At this point, with only disk 1 installed, printing the course material is not
possible yet. To do this, you should install disk 2, which offers you the
the commands PRTFX (9 pin, 240dpi), PRTLQH, PRTSTY (24 pin, 360dpi or
epson stylus inkjet), PRTHPDJ, PRTHPLJ (300dpi, inkjet or laserjet), and font
libraries to print the course on such a printer. Disk 02 also has the
documentation of all of the DVI drivers. The previewer, for example, has many
more options not mentioned here.

Now, you're all set and ready to create your first document. It is a good idea
to give all TeX and/or LaTeX documents the extension .TEX as all TeX programs
use that as the same default extension.
In the directory \EMTEX\DOC there is much more documentation on the system.

Installation of more disks
==========================
The other disks in the 4allTeX collection basically only contain .ZIP archives.
Every disk needs about 3 MB free hard disk space. The archive-unpacker
UNZIP.EXE and the installation program 4INSTALL.BAT on disk 1, and after
installation they will also be in \EMTEX\BIN, and sitting on your PATH.

Every floppy disk has its own installation program description file
'4ALTEXxx.INS', where xx is the disk number. If you want to install another
disk, run the installation program 4INSTALL (remember, it sits on your PATH!),
in the same way as you did to install disk 1. The program checks if the source
drive contains an .INS file, and if the destination disk had 4allTeX installed
on it. Then it shows the nice intro screen, and offers you several options to
install the packages on the disk.

Some packages require post-processing (like generation of format files, help
files, all to save disk space :-). It is recommended to use 4INSTALL.EXE.
If you wish to manually install an archive on, say, disk C, issue the commands
C:
CD\
UNZIP A:PACKET

The destination path name for your hard disk is retained in the ZIP archive,
so you need not worry about where to put what's in them.
Just calling UNZIP without any arguments presents you some help on screen.
If you want to use PKUNZIP, do not forget the -d option!

Font libraries
==============
On disk 1, there is a font library 4ALL1.FLI for previewing (300dpi).
On disk 02, 4ALL2.FLI and 4ALL3.FLI provide 240dpi and 360dpi fonts. However,
in order to fit everything on a disk, the font libraries are kept to the bare
minimum (enough for the LaTeX course). They should be enough for the starting
user, even for a term paper! There are two ways to go from here. First, in the
'official emTeX distribution', there are additional font libraries for
different printers. You can drop them in \EMTEX\TEXINPUT if you wish. To make
them active you must edit \emtex\data\4all.cnf, and comment out the line the
line '/pl=.......' (by putting a '%' in front of it). This disables ALL
4allTeX fontlibraries.
A better solution is to install disk M1, and generate your fonts on the fly.
Postscript fonts may be generated using disk ps2pk on disk P1, or by
installing disk P1,P2 (obligatory for Postscript), P5,P6 (fontlibraries).

Suggestions
===========
Some user specific settings need to be known every time you run TeX. These
settings are saved in EMTEX\SET-TEX.BAT. There are two options:
1  You wish to keep using the relatively simple batch files. (named latex.bat,
   plain.bat, tex.bat, view.bat etcetera) Then you should run SET-TEX.BAT
   before every session in which you use TeX.
   During installation of disk 1, it is asked to put a line in AUTOEXEC.BAT:
               CALL c:\emtex\set-tex.bat
2  We urge you to install a TeX 'shell'. There are several options:
   4TeX (disk03) An intuitive deluxe menu system, simple to use,
        and with lots of bells and whistles, also for some of the TeX
        guru tasks!
   TeXShell (disk05) A Turbo-pascal like environment. Fast, but
        not as extended as 4TeX (these two also work together!)
   For Windows: TeXtelMeXtel or emacs, both on disks3.
3 In case you are using the environment variables set by SET-TEX.BAT and you
  want to clean these up before using other programs, you can achieve this by
  running the batchfile UNSETTEX.BAT (this batchfile is also handy to run
  after an installation failure from disk 1)

Windows users
=============
In order to use 4allTeX in Windows (in DOS boxes), you must install RSX.EXE
(disk 05). This is a windows-compatible DOS-extender needed to run the tex386
engine. On disk S2 there is also RSXWIN, which runs tex386 in its own box.
The Windows disks S2 and S3 contain specific Windows applications, like
GsView, dviwin, TeXtelmextel and WinEmacs. In order to create icons in the
Program Manager screen, open Program Manager and File Manager together, such
that both are visible. Create a new program group 'TeX' in Program Manager.
In File Manager, open a directory window '\emtex\windows'. Now select (using
Ctrl-click) all executables, and drag them to the empty Program Manager group.
A load of new icons, ready to click appears. Note that most programs may need
some configuration: they have been set up with 4allTeX installed on a D:
drive. Most of the programs have an options dialog to do this. WinEmacs has
a configuration file \emtex\windows\emacs\emacs.rc, which must be edited.

OS/2 users
==========
On disk S1, there are special OS/2 versions of the TeX and METAFONT
'compilers'. However, it is recommended to use tex386, mf386 which are adapted
for both DOS and OS/2. Most of 4allTeX will run in an OS/2 DOS box. This box
needs some adaptation (in the DOS settings notebook):
    DPMI_DOS_API        AUTO        (default: auto)
    DPMI_MEMORY_LIMIT	8-16 MB 	(default: only 4 MB (Warp V3))
    EMS,XMS             is not needed
    DOS FILES           40-100      (default: only 20)
Also, edit your OS/2 CONFIG.SYS file, using this template, which
assumes you are installing on D:\EMTEX
    SHELL=C:\OS2\MDOS\COMMAND.COM C:\OS2\MDOS /e:4096 /p
    LIBPATH=C:\OS2\DLL;C:\OS2\MDOS;C:\OS2\APPS\DLL;D:\EMTEX\DLL;
    SET PATH=C:\OS2;C:\OS2\SYSTEM;C:\OS2\MDOS;C:\OS2\APPS;D:\EMTEX\BIN
    SET HELP=C:\OS2\HELP;C:\OS2\HELP\TUTORIAL;D:\EMTEX\HELP
    SET BOOKSHELF=C:\OS2\BOOK;D:\EMTEX\BOOK\ENGLISH
    IOPL=YES
In order to use the system under OS/2, you MUST put the complete
SET_TEX.BAT file in your CONFIG.SYS file! CALL SET_TEX.BAT in
CONFIG.SYS, AUTOEXEC.BAT or STARTUP.CMD *does not work*. So add:
    SET EMTEXDIR=D:\EMTEX
    SET TEXINPUT=.;%EMTEXDIR%\TEXINPUT!
    SET INDEXSTYLE=D:\EMTEX\IDXSTYLE
    SET DVIDRVFONTS=D:\EMTEX\TEXFONTS
    SET MFJOBOPT=/i /3
    SET EMTEXED=emacsclient +%1 %2
    SET TEXFONTS=%EMTEXDIR%\TFM\\
    SET TEXVFONTS=%EMTEXDIR%\TEXFONTS\VF\\
    SET T1INPUTS=D:\EMTEX\PS\FONTS
    SET TEXCONFIG=D:\EMTEX\PS
    SET GS_LIB=D:\EMTEX\PS;D:\EMTEX\PS\FONTS;D:\EMTEX\utils\ghostscr;
    SET GS_FONTPATH=D:\EMTEX\PS\FONTS;D:\EMTEX\utils\ghostscr\fonts;
    SET SPELL=%EMTEXDIR%\SPELL

Good luck and many beautiful documents to you!

