************************************************************
* *
* emTeX/TDS *
* *
* Installation Instructions *
* and General Information *
* *
************************************************************
Version 0.56
2001-09-30
Walter Schmidt
Copyright (C) 1999--2001 Walter Schmidt
************************************************************
* *
* Support for emTeX/TDS will be discontinued on 2002-06-30.*
* *
* If you are new to TeX on OS/2, install VTeX/2 instead: *
* see CTAN:systems/vtex . *
* *
************************************************************
Contents:
=========
1) Overview
2) Prerequisites
3) Installing Ghostscript
4) Installing emTeX/TDS
5) Environment variables and LIBPATH
6) Documentation
7) Setting up the printer
8) Running an example document through LaTeX
Appendix:
A) Uninstalling emTeX/TDS
C) Support
D) Legal stuff
1) Overview
===========
emTeX/TDS is an emTeX-based TeX system for OS/2 Warp with a
TDS-compliant directory structure. emTeX/TDS comes with an
installation program for setting up the following components:
LaTeX2e with additional packages: "graphics", "tools",
"german", "babel" and others.
Postscript font support for LaTeX, aka. "psnfss" (for
the 35 standard fonts); support for the Adobe Euro
fonts.
Additional Metafont and PostScript fonts, including the
Type1 (PostScript) versions of the CM, AMS and Euler
fonts.
plain TeX
TeX hyphenation patterns for American English and many
European languages, pre-installed in LaTeX and plain TeX.
dvips 5.83
dvipm
emTeX dvi printer driver for Laserjet/Deskjet
Metafont incl. MFJob and various tools (gftodvi etc.)
Makeindex 2.12
Bibtex 0.99c with the original styles
The "EPM TeX Front End" is recommended as a GUI. This is a
powerful integrated TeX environment based on the OS/2
"Enhanced Editor" (EPM). It is distributed from CTAM, see
the directory systems/os2/epmtfe.
2) Prerequisites
================
TeX is to be installed on a HPFS drive, because emTeX/TDS
will be using long filenames.
The Ghostscript program is required for viewing PostScript
documents -- see the next section.
The TeX system requires about 30MB for the files to be
installed. The fonts, which will be generated on demand
when viewing or printing documents, will be stored on the
same drive; extra 30MB should be provided at least for these
fonts and for future additions. The latest version of
Ghostscript incl. GSView needs 12MB.
Installation will require about 14MB of temporary disk space
which may be released afterwards.
Installing Ghostscript as well as emTeX will require the
program "unzip.exe". In case it is not available on your
PC, you may obtain it from the same directory where
emTeX/TDS is located; you will have to copy it to a
directory where other programs are kept, too; e.g., to the
directory \OS2 on the boot drive.
Ghostscript and emTeX are based on the the emx runtime
environment, version 0.9d; it can be installed automatically
in conjunction with Ghostscript. However, older versions of
emx should be updated manually, before installing emTeX or
Ghostscript!
In addition to the emTeX/TDS distribution you will also need
various files of the original emTeX distribution; the
particular files are be listed below. They can be obtained
from the CTAN directory systems/msdos/emtex.
3) Installing Ghostscript
=========================
Obtain the following files:
<
ftp://ftp.cs.wisc.edu/pub/ghost/ghostgum/gsv36os2.zip>
<
ftp://ftp.cs.wisc.edu/ghost/aladdin/gs650/gs650os2.zip>
The files gsv36os2.zip and gs650.zip are also distributed
from CTAN. The file and directory names reflect the version
numbers and may have changed in the meantime.
In case the emx runtime environment needs also to be
installed, the file
<
ftp://ftp-os2.nmsu.edu/pub/os2/dev/emx/v0.9d/emxrt.zip>
is required, too.
Unzip gsv36os2.zip to a temporary directory, place the files
gs650os2.zip (and emxrt.zip, if required) in the same
directory, and run os2setup.exe then. (Pay attention to the
instructions of the program, if you are also installing emx
during this step!) The temporary directory can be deleted
afterwards.
4) Installing emTeX/TDS
=======================
Please, read this section carefully and completely, even if
you intend to update an existing emTeX/TDS only. In this
case, notice the file NEWS, too: Important changes
introduced with the latest version are listed there.
1. Copy the following files into one directory (which can be
removed once the installation is completed):
From this emTeX/TDS distribution:
tdsinst.cmd (the installation program)
config.zip
texmf.zip
From the original emTeX distribution,
i.e., CTAN:systems/msdos/emtex:
bibtex4b.zip
dvid16h1.zip
dvid16h2.zip
makeindx.zip
mf4b.zip
mfjob12d.zip
mfware.zip
tex4b.zip
texware.zip
The latter files are NOT required, if you only want to
update from version 0.53 or above!
2. Go to the above directory; then start the installation
program "tdsinst". (tdsinst CANNOT be executed from a
different directory!) You will be asked for the drive,
where TeX is to be installed ("TeX drive"); it will be
installed in the directory "\texmf" of that drive.
If a version of emTeX/TDS < 0.55 is found on your HD, the
installation program needs to overwrite various
configuration files; however, you will be asked to agree:
tex/latex/local/hyphen.cfg
tex/latex/local/graphics.cfg
tex/latex/local/color.cfg
tex/latex/local/ltxdoc.cfg
tex/latex/local/ltxguide.cfg
tex/plain/local/plain.cfg
emtex/data/vp.cnf
emtex/data/dvijet.cnf
In case you have customized any of the above files, then
you should unpack the new version under a different name
first (enter "r" when asked for) and compare the changes
with yours, before you run TeX or the dvi drivers.
The installation program will ask you whether you want a
program object for the dvi viewer "dvipm" to be created
on the desktop. When installing emTeX/TDS for the first
time, you cannot run this program unless you will have
performed the below steps 3 and 5. You may want to
change the settings of this program object so as to
associate all files of type "*.dvi" with it by default.
emTeX/TDS requires various environment variables to be
set; the LIBPATH as well as PATH and HELP are to be
changed. The installation program can apply the
necessary changes to the OS/2 configuration file
config.sys, but will ask you before doing so. You may
quit the program there and perform the changes manually;
the necessary information can be found in the section
below. This must be done before you can proceed with the
following steps!
In case the installation program terminates abnormally
with a message including the word "Error", please,
cut-and-paste as much as possible from the command window
to a file and send it to me via email. See the below
section "Support" for the address.
3. Shut down OS/2, then reboot.
4. Now execute the program "makelatex" to generate the LaTeX
format file; This can be done from any directory.
5. Execute the program "makemf" to generate the Metafont
base file; this can be done in an arbitrary directory,
too.
6. Execute the program "makeplaintex" in an arbitrary
directory in order to to create the plain TeX format
file. In case you want to use LaTeX only or do not
understand what "plain TeX" is, you may skip this step.
*** The above steps 4, 5 (and 6) need also to be ***
*** executed, when an existing emTeX/TDS is updated. ***
7. The directory texmf\doc\emtextds contains the "Technical
Manual" (filename manual.eng) WHICH YOU SHOULD READ NOW!
This directory also holds the below mentioned file
eurofont.eng.
*** Adobe Euro Fonts ***
8. The file eurofont.eng tells you how to obtain and install
the Adobe Euro fonts ("Euro" symbols in Type1/PostScript
format). Their use is supported through a LaTeX package,
but the fonts are not included here due to legal reasons.
*** EPM TeX Front End ***
9. The "EPM TeX Front End" can be obtained from the CTAN
directory systems\os2\epmtfe; see the file README.epmtfe
for initial information then. The emTeX/TDS distribution
contains a suitable configuration file tfe.cfg for the
EPM TeX Front End.
*** VTeX/2 ***
10. When installing emTeX/TDS v0.56 over VTeX/2 7.3x, LaTeX
will be updated. You MUST create a new format file for
VTeX afterwards!
5) Environment variables and LIBPATH
====================================
You need NOT read this section if the installation program
has already applied the necessary changes to the OS/2
configuration file config.sys!
The following settings are required for running emTeX/TDS:
TMP
must point to a directory where temporary files can be
created.
EMTEXDIR=C:\TEXMF\EMTEX
The base directory for emTeX and dvips stuff.
TEXMACROS=C:\TEXMF\TEX
Points to the base directory for TeX macros in a TDS
tree. This variable is evaluated by the shell scripts
tex.cmd and latex.cmd.
TEXTFM=C:\TEXMF\FONTS\TFM!!;.
According to the TDS standard, the directory
texmf\fonts\tfm and all its subdirectory must be searched
for font metrics. Additionally, font metrics can be
taken from the current directory (.).
BFONTS=C:\TEXMF\FONTS\PK
VFONTS=C:\TEXMF\FONTS\VF!!
According to the TDS standard, bitmap fonts and virtual
fonts are stored below these directories. These
environment variables are evaluated by dvipm, dvihplj,
and dvips (see the appropriate configuration files).
Additionally the current directory will be searched for
.pk files.
TYPE1FONTS=C:\TEXMF\FONTS\TYPE1
PostScript fonts for dvips are to be found below this
directory.
TEXCONFIG=.;C:\TEXMF\DVIPS!!
The search path for dvips' configuration files, i.e.
config.ps, *.cfg and *.map
EMTEXSWCHAR=-
Options to the dvi drivers must be introduced by a
minus sign, not by a slash. Thus the slash can be used
more freely as a directory separator, as with Un*x.
MFOPT=-mp50000
Default Metafont option; useful for certain large
applications.
MFJOBOPT=-3 -i
Makes MFJob run mf386 (-3) and ignore Metafont errors
(-i).
MFINPUT=C:\TEXMF\FONTS\SOURCE!!;C:\TEXMF\METAFONT!
The default Metafont input directories. Must point to
the TDS directories where Metafont font sources and other
.mf files are stored.
INDEXSTYLE=C:\TEXMF\MAKEINDEX
Here we keep .ist files for the Makeindex program.
BSTINPUT=C:\TEXMF\BIBTEX\BST
BIBINPUT=C:\TEXMF\BIBTEX\BIB
The directories where BibTeX's .bst and .bib files are
stored.
PATH C:\TEXMF\EMTEX\BIN must be part of the PATH. All
executable programs of emTeX/TDS are located here.
LIBPATH
C:\TEXMF\EMTEX\DLL must be part of the LIBPATH.
HELP
C:\TEXMF\EMTEX\HELP must be part of the HELP path.
TMP may be set individually. All other environment
variables should have the values shown here, except, of
course for the drive letter (here C: as an example).
Caution: The particular programs may recognize further
environment variables!
6) Documentation
================
Documentation of the emTeX/TDS system is located in the
directory texmf\doc\emtextds.
!!! READING THE "TECHNICAL MANUAL" (FILE manual.eng) !!!
!!! IS HIGHLY RECOMMENDED !!!
The documentation for LaTeX, dvips, BibTeX and Makeindex is
located in the other directories below texmf\doc.
Files with the extension ".dvi" can be opened using the dvi
previewing program once you have completed the installation.
Documentation for the programs from the emTeX distribution
(TeX, Metafont, dvipm, dvihplj et al.) can be found in the
directories texmf\emtex\doc (ASCII) and texmf\emtex\book
(OS/2 .inf). Caution: These documents may refer to
components of the original emTeX distribution which are not
provided and/or not usable here.
See also the file help.eng of the original emTeX collection,
which resides in the CTAN directory systems/msdos/emtex/.
7) Setting up the printer
==========================
Due to the modular nature of TeX several programs have to be
configured separately for the printer to be used.
7.1) The dvi previewing program "dvipm"
---------------------------------------
dvipm should make use of the same bitmap fonts as the
printer; thus one can print from the graphical user
interface of dvipm on any printing device supported by OS/2.
Initially, dvipm is configured so as to use fonts for a HP
Laserjet 4, Laserjet 5L or Deskjet with a resolution of
600dpi. You need not change anything as long as you are
using one of these or a compatible one.
Configuring dvipm works through editing the file vp.cnf in
the directory texmf\emtex\data\dvips . Search for the
following lines:
% Options for dvipm.exe, using "ljfour" mode:
%
+resolution=600
+metafont-mode=ljfour
Enter the resolution of your printing device and the
suitable Metafont mode here. Typical "modes" are:
mode printer
.....................................................
deskjet Deskjet (300dpi)
cx Laserjet (300dpi), except for the following:
jetiiisi Laserjet IIIsi, Laserjet 4L (300dpi)
ljfour Laserjet 4, Laserjet 5L (600dpi)
ljfive Laserjet 5P (600dpi)
ljfivemp Laserjet 5MP (600dpi)
jfzzz LaserJet 4000N, ProRes mode (1200dpi)
ljfzzzfr LaserJet 4000 FastRes (600dpi)
As long as you do not make use of PostScript fonts or
PostScript graphics in your TeX documents, no further
programs need to be configured.
7.2) dvips
----------
dvips should be configured appropriately for your printing
device in order to make use of PostScript elements in TeX.
Initially it is set up for a Laserjet 4, Laserjet 5L or
Deskjet with 600dpi. You need not change anything as long
as you are using one of these or a compatible one.
Any printer-specific information is to be entered in the
file dvips.ini in the directory texmf\dvips\local . You will
have to create the directory and the file if they do not yet
exist. At least the Metafont mode and the resolution must
be specified; e.g., for a 300dpi Deskjet the following two
lines must be in dvips.ini:
D 300
M deskjet
D indicates the resolution, M is for the Metafont mode. See
above (dvipm) for typical modes.
dvips is described in the file texmf\doc\dvips\dvips.dvi .
See the "Technical Manual" for information about using dvips
with emTeX/TDS (default settings, configuration files,
search paths etc.).
7.3) The dvi printer driver "dvihplj"
-------------------------------------
emTeX/TDS also supports direct printing of dvi files
(without PostScript images or fonts) on a Laserjet, Deskjet
or compatible device. This is faster and needs less memory
than printing via dvipm. Configuring dvihplj may, however,
be somewhat difficult.
A general description of dvihplj can be found in the file
texmf\emtex\book\german\dvidrv.inf (OS/2 inf format).
See the "Technical Manual" for information about using
dvihplj with emTeX/TDS (default settings, configuration
file, search paths etc.).
7.4) EPM TeX Front End
----------------------
In case you are using the EPM TeX Front End as your TeX
environment, you may want to configure a command for the
menu item "Print" suitable for your printing device.
The configuration file tfe.cfg which is distributed with
emTeX/TDS has two example entries for using dvihplj and for
printing on a PostScript printer. Initially these entries
are commented out.
In case you prefer to print via the graphical user interface
of dvipm or GSview only, you may just leave the PRINT_CMD
empty; the related menu item will not be displayed then.
(This holds for texfe version 2.4 and above only.)
8) Running an example file through LaTeX
========================================
Having installed emTeX/TDS, you should run an example file
through LaTeX. Do this via the command line so as to check
the functions of the "basic" TeX system (as opposed to an
IDE):
1. Open an OS/2 window (i.e. a command line) in an
arbitrary directory outside the texmf tree
2. Copy the file C:\texmf\tex\latex\base\small2e.tex to this
directory. (Replace "C:" with the drive where TeX has
actually been installed.)
3. Run this file through LaTeX by executing the command
latex small2e
4. Start the previewer by executing the command
vp small2e
If the fonts used in the document small2e do not yet
exist, dvipm will ask you whether they should be created
by running MFJob; click on "Yes". When MFJob has
finished, dvipm will ask whether to reload the document
(now using the fonts which have been created); click on
"Yes" again.
************************************************************
* *
* Appendix *
* *
************************************************************
A) Uninstalling emTeX/TDS
=========================
The distribution contains a REXX script tdskill.cmd, which
can remove emTeX/TDS from your HD. It is to be run from any
directory outside the \texmf tree to be deleted. The script
removes all entries for emTeX/TDS from the configuration
file config.sys, too, after asking for confirmation, of
course. This script can also be used to remove a corrupt or
incomplete TeX system.
In case there remain any files or dirctories in the texmf
tree after executing tdskill.cmd, they can be deleted after
re-booting the system.
B) Support
==========
Bug fixes and additional information concerning emTeX/TDS
are available from <
ftp://ftp.dante.de/tex-archive/> or from
any other CTAN host in the directory
systems/os2/emtex-contrib/emtexTDS .
The latest version of emTeX/TDS will also be made available
there.
Questions, bug reports and suggestions should be addressed
to the author:
Walter Schmidt
<
[email protected]>
Please, understand that I cannot answer any questions
concerning particular programs like tex386, dvips or LaTeX
packages; they should be addressed to the authors of these
programs.
There is an electronic mailing list, EMTEX-USER, for emTeX.
To get information on how to subscribe and unsubscribe, send
a message containing
HELP
INFO EMTEX-USER
in the body to <
[email protected]>.
C) Legal stuff
===============
You are allowed to distribute the following set of files as
long as it is complete and all files are unchanged:
readme.eng
readme.ger
NEWS
tdsinst.cmd
tdskill.cmd
texmf.zip
config.zip
tfe.cfg
unzip.exe
You are NOT allowed to take money for these files or changed
versions, except for a nominal charge for copying etc.
No guarantee is made as to the proper functioning of this
software. No liability will be admitted for damage
resulting from using this software.
NOTE: emTeX/TDS is packaged using Info-ZIP's compression
utility. The installation program makes use of Info-ZIP's
UnZip program, the version 5.40 of which is provided in
conjunction with emTeX/TDS. Info-ZIP's software (Zip, UnZip
and related utilities) is free and can be obtained as source
code or executables from various internet sites, including
<
ftp://ftp.dante.de/tex-archive/tools/zip/info-zip/>.
NOTE: The original sources of the "dvips" program and the
patches to be applied for the PC version can be obtained
from any CTAN site, e.g. <
ftp://ftp.dante.de/tex-archive/>;
they are located in the directories:
dviware/dvips/dvips583.tar.gz
and
systems/os2/dviware/dvips/dvips583.zip
-- finis
P.S. I would like to apologize for my bad English.
English is not my native language.
