                                 README.TXT                        9-Jan-1996
                                 ==========


Documentation for MAKEINST.               Copyright (c) 1995 by Santiago Vila

This is version 0.3a of MAKEINST, a program to create .BATch files to
install emTeX (and related programs). This program may be useful if
you have to install emTeX in more than one or two computers.

Please, read this file complete before doing anything (it is not very long).


To run makeinst and use the resulting .BAT file you need:

* emTeX.
* GNU awk. It may be found, for example, in any simtel mirror, under
  `msdos/awk' subdirectory. See more on this at the end.
* MS-DOS 6 (CHOICE command) if you want the batch file to ask the user.
* 386 or higher (16-bit UNZIP does not work properly with -x @ option)
  (alternatively, you can use P*UNZIP in your 286 using "PK" option
  of MAKEINST).

MAKEINST needs a file called EMTEX.DAT.
This may be 286.DAT, 386.DAT or 486.DAT.

- Use 286.DAT if your computer is a 286.
- Use 386.DAT if you have a 386 but don't have a math coprocessor (also if
  you have a 486SX).
- Use 486.DAT if you have a 486 (DX), a 386 with math coprocessor,
  or a Pentium.

For example, if you don't have a math coprocessor you should:

COPY 386.DAT EMTEX.DAT

Default EMTEX.DAT is a copy of 486.DAT.


MAKEINST normally creates a .BAT file with English messages.
If you want to change this, change the messages in makeinst.awk


MAKEINST also needs a file named MT.TXT ("Master Table").
This file tells MAKEINST how to translate '?' in .DAT files.
You might want to update this file according to the emTeX files you really
downloaded from CTAN. It works O.K. with the emTeX update of 21 Dec 1995.


First of all, you should run makeinst once and see the kind of INSTALL.BAT
it produces. Type:

gawk -f makeinst.awk -vBATFile=INSTALL mt.txt emtex > INSTALL.BAT

(If you think this is too long, you may put this line in a file
named makeinst.bat, there is already such makeinst.bat, so you can type
'makeinst' directly).

MAKEINST reads three files, mt.txt, emtex.dat and emtex.dsk, and
creates the file INSTALL.BAT. You may now EDIT this file and see the result.

INSTALL.BAT can be run from any directory, but exclude files (see later)
must be in the current directory. UNZIP386.EXE is supposed to be
already installed in your computer, in a directory listed in the PATH.
You can also use P*UNZIP instead if you create INSTALL.BAT typing this:

gawk -f makeinst.awk -vBATFile=INSTALL -vpk=1 mt.txt emtex > INSTALL.BAT

INSTALL.BAT simply ask the user for diskettes and UNZIPs the .ZIP files
for you. In addition to this, it is highly configurable:

* Arrangement of diskettes are read from EMTEX.DSK. You can change this file
to suit your needs (But it follows Eberhard Mattes's DISKETTE.DOC official
recommendation).

* The file EMTEX.DAT tells makeinst what files should be installed (Y of
'Yes') and what files should not be installed (N of 'No'). Moreover
there is an option A for 'Asking' the user with CHOICE command.

For each package listed in EMTEX.DAT there may be any number of
exclude files. The meaning of some of the exclude files I use is:

*.os2         for OS/2 stuff (I don't have OS/2)
*.nus         for programs Not USed by me
*.dot         for DVIDOT stuff (I don't have any dot matrix printer).
*.mk          for makefmt and makebas, which I don't use either.
tex.ml        for not extracting ML-TeX files, I use other files for ML-TeX.
texware.nus   these are dvitype, pltotf, tftopl, vftovp and vptovf
mfware.g2d    this is all gftodvi stuff
mfware.mft    this is all mft stuff
mfware.nus    these are gftype, pktogf, pktype and pxtopk, which I never use.
dvi2.pcl      PCLtoMSP
dvi2.flb      FontLib (well, I currently do not exclude this).
dvi1.6        } You may exclude this if you
dvi2.6        } have math coprocessor (or 486DX)
dvi2.7        Exclude this if you don't have math coprocessor.
dvi1.s        DviScr S
dvi2.vik      DviVik
latex209.doc  .DOC files  from LaTeX 2.09
fontams.cyr   cyrillic fonts of fontams.zip (which I don't use)
fontams.dis   distribution files of fontams.zip (usually not needed)
fontams.doc   exclude this if you exclude cyrillic fonts!
makeindx.2    makeindx.exe (exclude this if you have 386 or higher)
makeindx.3    mkidx32.exe  (exclude this if you have 286 or lower)
bibtex.2      bibtex.exe   (exclude this if you have 386 or higher)
bibtex.3      bibtex32.exe (exclude this if you have 286 or lower)

Of course you don't have to use exclude files at all, or you can create your
own exclude files (or modify the supplied here).
You can even exclude some files twice, for example,  makedot.inf is both
in dvi1.os2 and dvi1.dot. In this case, UNZIP complains and says:
"exclude filename not matched", but it doesn't matter.

Bear in mind that UNZIP is case sensitive (althought DOS itself is not!).

Note 1: exclude files may be easily created with  ZIPINFO -1
Perhaps you will need to find and replace "/" by "\".

Note 2: If you haven't done this before, do it now: COPY UNZIP.EXE ZIPINFO.EXE
and then execute ZIPINFO with no arguments to see available options.

You should change EMTEX.DAT to suit your needs before running MAKEINST.
In this case, you might better want to modify MAKEDAT.BAT, the file that
generated 286.DAT, 386.DAT and 486.DAT. Feel free to do this. *.DAT files
supplied here are simply the ones I use for me and my friends.

You can modify makeinst.awk to create .BAT files in your own
language (if you don't like ENGLISH).


Note: MAKEINST only creates an 'unzipping' .BAT file. I think it will not
become a complete setup program, because everybody has a different way of
creating format files. However, I would recommend to write your own .BAT
file to create TeX format files and metafont bases, because this way you
will be able to upgrade easily to newer versions of emTeX.


Related utilities
=================

From version 0.3a, there is the following method to create diskette sets:
Type

MKEMTEX

to create a file named emtex from mt.txt and emtex.dsk.
Now, if you store your original emTeX ZIP files in ..\EMTEX.ZIP you can
make installation disk (for your friends) using DISK.BAT. Usage is

DISK n path

Where "n" is any number from 1 to 8 and "path" is [Unit:]directory.
Important!: You have to use double backslashes, example:

DISK 1 F:\\EMTEX\\DISK1

will copy emTeX disk 1 files from ..\EMTEX.ZIP to F:\EMTEX\DISK1.

DISK.BAT calls DISK.AWK, which takes the information it needs from the
file "emtex".


Please, mail your suggestions (even erratas, typos, etc) to:

Santiago Vila
e-mail: sanvila@unex.es

------------------------------------------------------------------------------

MAKEINST is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation; either version 2, or (at your option) any later
version.

MAKEINST is distributed in the hope that it will be useful, but WITHOUT ANY
WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
for more details.

You should have received a copy of the GNU General Public License
along with MAKEINST; see the file COPYING.  If not, write to
the Free Software Foundation, 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.

------------------------------------------------------------------------------
History:

 9-Jul-1995. Version 0.1. Initial release.

17-Jul-1995. Version 0.2

* Now the .BAT file only ask the user for a diskette if it really has
  something to unzip from it.

* LANGUAGE.TXT changed slightly. Now it contains only messages for the .BAT
  file. Run-time messages of makeinst will be in english.

* Now the .BAT file makes a little check each time it ask the user for a
  new diskette. If the diskette is wrong, user is warned about it.

7-Aug-1995. Version 0.3

* 'Master Table' MT.TXT introduced. Now MAKEINST is much easier to update.

* Some exclude files updated.

29-Dec-1995. Version 0.3a

* LANGUAGE.TXT dissappeared. 
* makeinst rewritten in awk, which is free :-)
* EMTEX.DSK updated following DISKETTE.DOC.
* New DISK.BAT and MKEMTEX allows to make a set of diskettes.

------------------------------------------------------------------------------
Bugs:

* There are too many exclude files...

------------------------------------------------------------------------------
Where to find GNU awk:

1. OS/2 32-bit version
     ftp-os2.cdrom.com:pub/os2/32bit/unix/gnuawk.zip

2. OS/2 16-bit version
     ftp-os2.cdrom.com:pub/os2/16bit/unix/gawk2156.zip

3. DOS 16-bit, and OS/2 and DOS 32-bit version (gawk.exe, gawk-emx.exe)
     oak.oakland.edu:SimTel/msdos/awk/
   with executables in gawk2156.zip and sources in gawk215t.zip

4. The original GNU sources
     prep.ai.mit.edu:pub/gnu/gawk-2.15.6.tar.gz
