==============================================================================
README.ENG (emTeX DISTRIBUTION) 02-Jul-1998
==============================================================================
emTeX: TeX for OS/2, PC-DOS and MS-DOS
------------------------------------------------------------------------------
Contents
------------------------------------------------------------------------------
1. Introduction
2. Installing emTeX
3. Getting help
4. Distribution files
5. Version numbers
6. License
7. How do I get emTeX?
8. The author
9. Reporting bugs
10. Directories
11. File names in the emTeX system
------------------------------------------------------------------------------
1. Introduction
------------------------------------------------------------------------------
This is a complete distribution of emTeX. It replaces the previous
official emTeX distribution as well as all previous betatest packages.
IMPORTANT: See CHANGES.ENG for changes with respect to the previous
emTeX distribution. See INSTALL.ENG for the general installation
instructions. See QUICK.ENG for quick installation instructions.
However, using the installation program (install.exe) is recommended.
IMPORTANT: Please use the new font library files (such as lj_base.fli)
instead of the old ones (such as lj_0.fli through lj_5b.fli) as the
Computer Modern font sources and the METAFONT modes have changed.
The emTeX distribution includes the TeX typesetter, the METAFONT font
generation program, printer drivers, screen previewers, and tools like
BibTeX and MakeIndex. It also includes the macro packages LaTeX 2.09
and LaTeX2e. Fonts are included as pixel files and METAFONT source
files.
Documentation for the TeX and METAFONT `programming languages' is not
included. You can get appropriate books at libraries and book stores.
However, the emTeX distribution includes documentation for the emTeX
implementations of TeX and METAFONT.
------------------------------------------------------------------------------
2. Installing emTeX
------------------------------------------------------------------------------
You'll find the general installation instructions in INSTALL.ENG.
You'll find quick installation instructions in QUICK.ENG. You can
avoid reading INSTALL.ENG and QUICK.ENG by using the installation
program (install.exe)!
You might want to print INSTALL.ENG file by typing
copy a:\install.eng prn
or print QUICK.ENG by typing
copy a:\quick.eng prn
(You don't need to print README.ENG.)
------------------------------------------------------------------------------
3. Getting help
------------------------------------------------------------------------------
You'll find some frequently asked questions with answers in
\emtex\doc\english\help.eng. Before asking, you should read that
file. Some don't like to be asked questions that are answered in
help.eng.
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].
------------------------------------------------------------------------------
4. Distribution files
------------------------------------------------------------------------------
changes.eng Changes from older versions (English)
changes.ger Changes from older versions (German)
diskette.doc How to put these files onto diskettes
help.eng Frequently asked questions with answers (English)
help.ger Frequently asked questions with answers (German)
install.dat Auxiliary file for install.exe
install.eng General installation instructions (English)
install.exe Installation program
install.ger General installation instructions (German)
install.ovl Auxiliary file for install.exe
quick.eng Quick installation instructions (English)
quick.ger Quick installation instructions (German)
readme.bet Read this if you have a betatest version installed
readme.eng You should read this (English)
readme.ger You should read this (German)
unz512.exe Info-ZIP's UnZip for OS/2, self-extracting archive
unz512x3.exe Info-ZIP's UnZip for DOS, self-extracting archive
bibtex4b.zip BibTeX, manages bibliography databases for LaTeX
dvid16g1.zip Printer drivers and screen previewers, part 1 of 2
dvid16g2.zip Printer drivers and screen previewers, part 2 of 2
dvisp10b.zip Convert a DVI file to a text file
emxrsx.zip emx and rsx runtime package (for tex386 etc.)
first.zip Documentation files and tools, to be installed first
fontams.zip Font source files and TFM files: AMSFonts
fontcm.zip Font source files and TFM files: Computer Modern
fontec.zip Font source files and TFM files: EC and TC fonts
fontemsy.zip Font source files and TFM files: em's symbol font
fontltx.zip Font source files and TFM files: LaTeX fonts
german.zip Files for typesetting documents written in German
l2base.zip Base distribution files of LaTeX2e
l2input.zip Unpacked input files of LaTeX2e
l2kurz.zip Brief introduction to LaTeX2e (German)
l2tools.zip Additional macros for LaTeX2e
latex209.zip LaTeX 2.09 macro package
lkurz.zip Brief introduction to LaTeX 2.09 (German)
makeindx.zip MakeIndex: generating an index for a LaTeX document
mf4b.zip METAFONT: generating fonts
mfjob12d.zip MFjob: assists METAFONT in generating fonts
mfware.zip Tools for font files
pictex.zip PiCTeX macro package
pkedit.zip Tool for editing pixel font files
srcmkidx.zip Source code for MakeIndex
srctcad.zip Source code for TeXcad
tex4b.zip emTeX typesetter
texcad.zip TeXcad: interactive designer for LaTeX pictures
texware.zip Tools for DVI and TFM files, etc.
web.zip WEB: literate programming in Pascal
bj_base.fli Base fonts for the Canon BubbleJet (360 DPI)
dj_base.fli Base fonts for the HP DeskJet (300 DPI)
fax_base.fli Base fonts for Fax (204x196 DPI)
fx_base.fli Base fonts for 9-pin printers (240x216 DPI)
ito_base.fli Base fonts for the C.ITOH 8510A (160x144 DPI)
ljh_base.fli Base fonts for the HP LaserJet 4 (600 DPI)
lj_base.fli Base fonts for the HP LaserJet (300 DPI)
p6h_base.fli Base fonts for 24-pin printers (360 DPI)
p6l_base.fli Base fonts for 24-pin printers (180 DPI)
p6m_base.fli Base fonts for 24-pin printers (360x180 DPI)
qj_base.fli Base fonts for the HP QuietJet (192 DPI)
sty_base.fli Base fonts for the EPSON Stylus 800 (360 DPI)
The *.eng and *.ger file can also be found in first.zip.
ljh_base.fli does not fit on a 1200KB diskette (130mm, 5.25"). You
might want to use Info-ZIP's Zip program (UnZip's companion) to
compress that file to make it fit.
------------------------------------------------------------------------------
5. Version numbers
------------------------------------------------------------------------------
BibTeX 0.99c
dvidrv 1.6g
dvispell 1.0b
DVItype 3.5
fontlib 1.2b
GFtoDVI 3.0
GFtoPK 2.3
GFtype 3.1
METAFONT 2.718
MFT 2.0
MFjob 1.2d
makedot 1.2e
MakeIndex 2.12
maketcp 1.1d
PCLtoMSP 1.1a
pkedit 1.1h
pkeditpm 1.1a
PKtoGF 1.0
PKtype 2.3
PLtoTF 3.5
PXtoPK 2.2
TANGLE 4.4
TFtoPL 3.1
TeX 3.14159
TeXconv 1.2a
VFtoVP 1.2
VPtoVF 1.4
WEAVE 4.4
LaTeX 2.09 <25 March 1992>
LaTeX2e 1998/06/01
plain.tex 3.141592
plain.mf 2.71
german.sty 2.5d
AMSFonts 2.2
EC Fonts 1.0
------------------------------------------------------------------------------
6. License
------------------------------------------------------------------------------
Software written by Eberhard Mattes which is part of the emTeX
distribution may be used without restrictions.
Software written by Eberhard Mattes which is part of the emTeX
distribution may only be distributed in UNCHANGED and COMPLETE form,
including all the files listed in README.ENG's `Distribution files'
section, and only if this is done WITHOUT CHARGE (you are allowed to
omit some or all of the *.fli files).
(If you want to distribute only parts of emTeX or if you want to
charge a fee for handling etc., you have to contact the author. In
particular, commercial distribution on CDROM or diskettes is
prohibited without explicit permission.)
For all other software of the emTeX distribution, the license
accompanying that software applies.
(In general, non-commercial use is allowed for all software
distributed with emTeX. Apparently commercial use is restricted for
the German hyphenation patterns (ghyph31.tex) only. In general,
distribution of unmodified and complete software is allowed if you
don't take money for use or distribution. In particular, the files of
l2input.zip must not be distributed without the files of l2base.zip.)
No guarantee is made as to the proper functioning of the software. No
liability will be admitted for damage resulting from using the
software.
Instead of a list: All the trademarks used in this document and all
the other emTeX documents are registered to whoever it is that owns
them.
------------------------------------------------------------------------------
7. How do I get emTeX?
------------------------------------------------------------------------------
- Anonymous ftp:
ftp.dante.de /tex-archive/systems/msdos/emtex
ftp.cdrom.com /pub/tex/ctan/systems/msdos/emtex
ftp.tex.ac.uk /tex-archive/systems/msdos/emtex
- Mail server:
[email protected]
[email protected]
Note that BINARY mode must be used for downloading all the files.
------------------------------------------------------------------------------
8. The author
------------------------------------------------------------------------------
Address:
Eberhard Mattes
Teckstrasse 81 (Teckstra\ss e)
D-71696 Moeglingen (M\"oglingen)
Germany
No telephone calls please! Please inclose a self-addressed return
package with postage if you expect a response. Read HELP.ENG first!
Electronic mail (subject to change):
Internet:
[email protected]
If you want support by telephone, obtain a commercial TeX package.
------------------------------------------------------------------------------
9. Reporting bugs
------------------------------------------------------------------------------
If you find a bug please tell the author so that it can be corrected. Please
send the following information which is needed for the task:
- machine type (XT, AT, 386 etc.), CPU, BIOS, video card, printer
(manufacturer and model), operating system and version number
(note: SYSLEVEL command with OS/2). For instance:
AT compatible, 286, Award, Paradise VGA, DeskJet+, IBM PC-DOS 3.3 .
- the text of the autoexec.bat and config.sys in use when the error
occurred: if possible, with an explanation of the programs called and
drivers installed that are not part of the operating system.
- emTeX version
- enough information for the error to be reproduced, if possible a
diskette containing the appropriate files (see also dvidrv.doc).
- the DLG file, if the error is in a driver
- the part of the printed output which shows the error, if the error is in
a printer driver.
Please inclose a self-addressed return package with postage if you
expect a response.
------------------------------------------------------------------------------
10. Directories
------------------------------------------------------------------------------
The following directories are created during the installation:
\emtex
This is the root directory of the emTeX directory tree. It should
contain only subdirectories, no files. The EMTEXDIR environment
variable points to this directory.
\emtex\bibtex\bib
Bibliography database for BibTeX. The (optional) BIBINPUT
environment variable points to this directory.
\emtex\bibtex\bst
Style files for BibTeX. The (optional) BSTINPUT environment
variable points to this directory.
\emtex\bin
Executable files (that is, programs). Add this directory to your
PATH.
\emtex\bmfbases
METAFONT base files (macro packages such as `plain' in a
fast-loading format) and mf.poo, for bigMETAFONT and mf386. The
(optional) BMFBAS environment variable points to this directory.
\emtex\book
OS/2 on-line manuals. This directory has the following
subdirectories:
english English manuals
german German manuals
To view an OS/2 on-line manual (such as dvidrv.inf), type
view c:\emtex\book\english\dvidrv
If you have added c:\emtex\book\english to the BOOKSHELF
environment variable, the following command will also work:
view dvidrv
\emtex\btexfmts
TeX format files (macro packages such as LaTeX, in a fast-loading
format) and tex.poo, for bigTeX and tex386. The (optional)
BTEXFMT environment variable points to this directory.
\emtex\data
Various configuration, parameter, and data files. This directory
is located via the EMTEXDIR environment variable.
\emtex\dist\latex
LaTeX2e distribution files.
\emtex\dll
Dynamic link libraries for OS/2. This directory should be listed
in the LIBPATH statement of config.sys.
\emtex\doc
Instructions and manuals. The texts in this directory are
available in one language only (English or German).
\emtex\doc\english
English instructions and manuals.
\emtex\doc\german
German instructions and manuals.
\emtex\doc\latex209
Documentation for LaTeX 2.09.
\emtex\doc\rsx
Documentation for the rsx DOS extender. (The documentation for
emx is in \emx\doc.)
\emtex\help
OS/2 on-line help files. Presentation Manager programs use the
files in this directory for displaying on-line help. This
directory should be listed in the HELP environment variable.
\emtex\htexfmts
TeX format files (macro packages such as LaTeX, in a fast-loading
format) and tex.poo, for htex386. The (optional) HTEXFMT
environment variable points to this directory.
\emtex\idxstyle
Style files for MakeIndex. To use MakeIndex style files, the
INDEXSTYLE environment variable points to this directory, as
MakeIndex does not use a default directory.
\emtex\install
Files used by the installation program.
\emtex\mfbases
METAFONT base files (macro packages such as `plain' in a
fast-loading format) and mf.poo. The (optional) MFBAS environment
variable points to this directory.
\emtex\mfinput
Text files (font sources) which will be read by METAFONT. This
directory should contain only subdirectories, no files. The
(optional) MFINPUT environment variable points to this directory.
\emtex\mfjob
Job files for MFjob. The (optional) MFJOB environment variable
points to this directory.
\emtex\mftstyle
Style files for MFT. The filename of the style file given to MFT
must explicitly reference this directory.
\emtex\remove
Package contents listings for emremove.exe.
\emtex\src
Source code for package which must be distributed with source
code.
\emtex\texfmts
TeX format files (macro packages such as LaTeX, in a fast-loading
format) and tex.poo. The (optional) TEXFMT environment variable
points to this directory.
\emtex\texinput
Text files (macro and style files) which will be read by TeX.
This directory should contain only subdirectories, no files. The
(optional) TEXINPUT environment variable points to this directory.
\emtex\tfm
TFM files (TeX font metrics). This directory should contain only
subdirectories, no files. The (optional) TEXTFM environment
variable points to this directory.
\emx\bin
Executable files (that is, programs) of emx. Add this directory
to your PATH.
\emx\book
OS/2 on-line manuals. This directory should be listed in the
BOOKSHELF environment variable.
\emx\dll
OS/2 dynamic link libraries of emx. This directory should be
listed in the LIBPATH statement of config.sys.
------------------------------------------------------------------------------
11. File names in the emTeX system
------------------------------------------------------------------------------
.aux Auxiliary file created and used by LaTeX
.bak Backup file (fontlib, pkedit)
.bas Fast-loading base file for METAFONT (no, not BASIC)
.bat Batch file (DOS)
.bbl Output file of BibTeX
.bgi Video graphics driver (used by TeXcad)
.bib Bibliography database for BibTeX
.blg Transcript file (BibTeX)
.bmp Bitmap file
.bst Bibliography style for BibTeX
.bug List of bugs
.cfg Configuration file (LaTeX2e)
.ch Change file (TANGLE, WEAVE and MFT)
.clo Document class option (LaTeX2e)
.cls Document class (LaTeX2e)
.cmd Batch file (OS/2)
.cnf Configuration file for dvidrv
.dat Data file (for makefmt, makebas, and install)
.def Definitions (LaTeX2e)
.dlg Transcript file (dvidrv)
.dll OS/2 dynamic link library
.doc Instructions (straight text) or commented sty file
.dot Parameter file for dvidot
.dsb dvispell binary parameter file
.dsi dvisprep input file (dvispell parameter file)
.dtx Documented code file
.dvi Device independent output of TeX
.eng English documentation file
.err Error messages and warnings (dvidrv); errata for LaTeX books
.exe Executable program
.fd Font definition file (LaTeX2e)
.fdd Documented source for .fd file
.fli Font library file (dvidrv)
.fmt Fast-loading format file for TeX
.ger German documentation file
.gf Font file created by METAFONT (usually .#gf)
.gft Default extension for the output of GFtype
.glo LaTeX auxiliary file for \glossary
.hlp OS/2 on-line help file
.ico OS/2 icon file
.idx Index entries (created by LaTeX)
.ilg MakeIndex transcript file
.ind Index entries (created by MakeIndex)
.inf OS/2 on-line manual
.ins Installation script (docstrip)
.ist MakeIndex style file
.lof LaTeX auxiliary file for \listoffigures
.log Transcript file (TeX and METAFONT)
.lot LaTeX auxiliary file for \listoftables
.ltx LaTeX input file
.mac TeXcad macro file
.mf Source text for a font
.mfj Job file for MFjob
.mft Style file for MFT
.msp Bitmap file
.mtc maketcp input file for a .tcp file
.opt TeXcad parameters
.ovl Overlay
.pas Pascal source file (TANGLE)
.pcx Bitmap file
.pic Picture environment created by TeXcad
.pk Compressed font file
.pkt Default extension for the output of PKtype
.pl Readable form of a TFM file
.poo String pool for INITEX or INIMF (pool file)
.pxl Font file (obsolete)
.rem Package contents listing for the `emremove' program
.sty Document style or document style option for LaTeX
.sub Font substitution file (dvidrv)
.tcp TeX code page (translation of code pages and special characters)
.tex TeX text
.tfm Symbol widths and other properties of a font (font metrics)
.toc Notes of LaTeX for contents
.txt Documentation file, instructions
.ver List of program versions (TeXcad)
.vf Virtual font (dvidrv, VFtoVP, VPtoVF)
.vpl Readable form of a VF file (VFtoVP and VPtoVF)
.web WEB source text (TANGLE and WEAVE)
.zip ZIP archive file (collection of compressed files)
(No claim as to completeness.)
-------- End of README.ENG -------------
