============================================================
   Installation instructions for VTeX/Free 8.44.2 on OS/2
                     ( = VTeX/2 8.44b)
============================================================
                                                  2005-02-11
                                              Walter Schmidt

Contents
--------
  What is VTeX/2?
  Prerequisites
  Installing VTeX/2 over emTeX/TDS
  Required files
  Installing VTeX/2
  What to do, if the installation fails ?
  Installing the Adobe Euro fonts
  Creating the LaTeX format file
  Creating the plain TeX format file
  Documentation 
  Using the EPM TeX Front End with VTeX/2
  Support
  Legal stuff



What is VTeX/2 ?
----------------
VTeX/2 is an eTeX program for OS/2 Warp to generate PDF or
PostScript output immediately from the TeX source file.  It
comes with a basic LaTeX system, including many additional
packages and fonts, as well as the Bibtex and Makeindex
programs.  Plain TeX is also included.  

In contrast to traditional TeX systems, no intermediate DVI
files need to be generated, no "dvi driver programs" are
required, and there is no need to take care of their --
sometimes fussy -- setup.

In contrast to pdfTeX, VTeX includes a full PostScript
interpreter, so that inclusion of EPS images as well as inline
PostScript programming, i.e.  PSTricks, psfrag etc.  are
fully supported,

The common PostScript and PDF viewers GSView and Adobe
Reader can be used for (pre)viewing and printing.

Output files from VTeX are immediately suitable for public
distribution, e.g., over the WWW, since PostScript and PDF
are standardized document formats -- as opposed to the
TeX-specific DVI format.  

The VTeX engine supports the eTeX extensions.

VTeX/2 can either be installed as a standalone LaTeX system
or on top of an existing emTeX/TDS system, version 0.56.



Prerequisites
-------------
* VTeX/2 requires Warp 3 or better, and at least 16Mb of
physical memory.

* You should have installed Ghostscript, so as to provide a
PostScript and PDF reader.

* It is highly recommended to provide also Acrobat Reader,
because this is the "canonical" PDF reader, and because
certain hypertext features of the PDF format are not
supported by Ghostscript.

* The VTeX/2 is to be installed on a HPFS drive, because it
will make use of long file names.  The complete TeX system
will require about 80MB of disk space.

| The installation program requires the default OS/2 command
| shell CMD.EXE, i.e. there is absolutely no guarantee, that
| it works with any alternative shell such as 4OS2.


Installing VTeX/2 over emTeX/TDS
--------------------------------
VTeX/2 can be installed as a stand-alone TeX system or "on
top" of an existing emTeX/TDS, provided that you have got
the latest emTeX7DS version 0.56.

If you install VTeX/2 on the same drive as an existing
emTeX/TDS, they will share the same TeX directory tree,
thus saving lots of disk space.  Also installing of VTeX 
will update many components of your emTeX system.

If you keep VTeX and emTeX on different drives, they will be
completely independent.

| After installing VTeX over emTeX/TDS 0.56, you _must_
| re-make the emTeX format files.
|
| Furthermore, you _must_ change the environment variable
| TEXCONFIG so as to comply with the latest TDS 
| specifications:
|
|   TEXCONFIG=C:\TEXMF\DVIPS!!;C:\TEXMF\FONTS\MAP\DVIPS;C:\TEXMF\FONTS\ENC\DVIPS
| 
| (Replace "C:" with the letter of the volume where you have 
| actually installed emTeX.)


Installing VTeX/2 over emTeX/TDS will update the font map
files psfonts.map and cmfonts.map, so that dvips can use the
additional Type1 fonts that come with VTeX -- except for the
EC/TC and the Hebrew fonts of the ArabTeX system, which work 
with VTeX only.



Required files
--------------

  vtexinst.cmd              (installation program)
  vtex2-8442.zip
  vtex-base-8442.zip
  vtex-base2-8442.zip
  vtex-special-8442.zip
  vtex-fonts-8442.zip
  vtex-fonts2.zip
  vtex-doc-8422.zip 
  vtex-cbfonts.zip                      (optional)
  vtex-sem.zip                          (optional)
  vtex-gex.zip                          (optional)
  vtex-koma.zip                         (optional)

Remarks:

vtex-gex.zip is unchanged since v7.320.  vtex-fonts2.zip is
unchanged since v7.53.  You need not download them once 
again, if you have them already.

vtex-cbfonts.zip contains the Greek Computer Modren fonts, 
aka "CB fonts".  Omit this archive, if you do not intend to 
use them.

vtex-gex.zip includes the documentation of VTeX's built-in
PostScript interpreter; omit this file, if you want.  

The archive vtex-koma.zip includes the "KOMA-Script"
document classes for use with LaTeX.  In case you have
already installed these document classes yourself, or if you
don't intend to use them, omit this archive.

The archive vtex-sem.zip includes the LaTeX packages seminar
and prosper; you need not install it, unless you actually
want to use these packages. 

Optional files can be installed later, by simply unpacking 
the archives in the root directory of the drive where VTeX/2
is installed.



Installing VTeX/2
-----------------

(0)
Any existent version of VTeX _prior_ to 7.10 must be deleted
manually.  Later versions can be updated automatically.

(1)
Put the installation program vtexinst.cmd and all required
ZIP files (see above) into a temporary directory.  The
contents of this directory can be removed, once the
installation is completed.

(2)
Go to the above directory; then start the installation
program "vtexinst".  (Note that vtexinst CANNOT be executed
from a different directory!)

When the program asks you, for the version of VTeX/2 to
install, enter:

  8.44.2
  
You will also be asked for the drive where VTeX is to be
installed or updated.  It will be installed in the
directories \vtex and \texmf of that drive.

Note that the configuration program will update various 
configuration files:

  \texmf\vtex\config\hyphen.cfg
  \texmf\vtex\config\plain.cfg
  \vtex\bin\vtex.ini            (*)
  \texmf\vtex\config\ps.fm      (*)
  \texmf\vtex\config\pdf.fm     (*)
  
The files marked by (*) are updated only if your previous
version of VTeX was < 8.44.  

Existing configuration files are always backed up, with the
extension ".sav" appended to the original name.  If you have
customized them, don't forget to check your changes against
the updated instances!

| If you have previously installed the "CB fonts" package
| from <http://home.vr-web.de/cb4vtex>, you must delete the
| record for cb.ali from the .fm files now (unless the files
| are updated, enyway.)
| Rationale:  Records for the CB fonts are now part of the
| default configuration, see the file cm.ali.


(3)
VTeX/2 requires the following settings in the system 
configuration file config.sys of OS/2:

  PATH    must include <drive>:\VTEX\BIN
  LIBPATH must include <drive>:\VTEX\DLL
  
(Replace <drive> with the letter of the drive, where VTeX/2 
is actually installed.)

The installaton program can modify config.sys appropriately;
however, it will _not_ do so without asking you before, and 
you may chose to edit config.sys manually.

| Do _not_ forget to reboot OS/2, after any changes to
| config.sys have been made!



What to do, if the installation fails ?
---------------------------------------

The installation program should tell you about the reason
of the error; just read what it writes to the screen.  Maybe
it is something you can fix, e.g., one of the required files
might be missing.

If you don't understand the message at all, or if the reason
of the failure seems to be outside your responsibility, you
may ask me for help:  The installation program will generate
a transcript file named vtexinst.log.  Please, send this
file, together with a verbal description of the problem to
<vtexfree(at)gmx.net>



Creating the LaTeX format file
------------------------------
Open an OS/2 comand line in an arbitrary directory and
execute the following command:

  makevlatex

If there are any error messages, you should check the log
file, which is created in the directory \vtex\fmt.

Now you should check, whether the installation works:  Run
the file ltxcheck.tex through LaTeX, thus making sure that
the installation works.  The file resides in the directory
\texmf\source\latex\base.  Switch to this directory

  cd \texmf\source\latex\base
       
and execute the following command:

  vlatex ltxcheck
       
This will produce a number of messages, each of which should
be "OK".



Creating the plain TeX format file
----------------------------------
Omit this step, if you don't know what "plain TeX" is!

Open an OS/2 comand line in an arbitrary working directory
and execute the following command:

  makevplain

If thee are any error messages, you should check the log
file, which is created in the directory \vtex\fmt.



Documentation
-------------
See the files in the directory texmf\doc\vtex:

local.eng        Preliminary LaTeX Local Guide
                 (READ THIS FIRST!)
plain.eng        plain TeX Local Guide
                 (ignore it, if you don't know
                 what "plain TeX" is)
vtex.pdf         The VTeX/Free manual
etex_man.pdf     eTeX manual
gex.pdf          GeX Manual
mm_man.pdf       How to use MM fonts with VTeX
forms.pdf        How to use PDF forms from TeX
animgif.pdf      How to include animated GIFs into
                  PDF documents
examples\*       Sample documents

The sample file tryanim.tex and part of the examples in the
document animgif.pdf may not work with Acrobat Reader 5 or
later, due to the "features" of the latest Acrobat.  They
do, however, work with Acrobat 4 and (almost) with Acrobat
Reader 3 on OS/2.



Using the EPM TeX Front End with VTeX/2
---------------------------------------
The EPM TeX Front End is a powerful integrated TeX
environment, based on the OS/2 editor EPM; see

  <ftp://dante.ctan.org/tex-archive/systems/os2/epmtfe/>

In conjunction with VTeX/2 v8.44 it is highly recommended to
use the latest version 4.x of the TeX Front End!



Support
-------
The NTG hosts a mailing list that can be used both to ask
questions and to report bugs in the software and/or
installation.  The list has a web interface for subscribing,
unsubscribing, accessing the archives etc:

  <http://www.ntg.nl/mailman/listinfo/ntg-vtex>



Legal stuff
-----------
MicroPress and VTeX are trademarks of MicroPress, Inc.  
The MicroPress' components of the VTeX/Lnx distribution are

  Copyright (C) 1998--2005 by MicroPress Inc.

The MicroPress' components of the VTeX/2 distribution are
free for personal use, subject to the following restriction:
Redistribution is allowed only as a part of the complete
VTeX/2 system, and only if all of the following files remain
unchanged and are distributed as a whole:


  readme-os2.eng
  vtexinst.cmd         
  vtex2-8442.zip       
  vtex-base-8442.zip   
  vtex-base2-8442.zip  
  vtex-special-8442.zip
  vtex-fonts-8442.zip  
  vtex-fonts2.zip      
  vtex-doc-8422.zip    
  vtex-cbfonts.zip     
  vtex-sem.zip         
  vtex-gex.zip         
  vtex-koma.zip        
      

Adobe, Acrobat and PostScript are trademarks of Adobe
Systems Incorporated.


== finis
