summaryrefslogtreecommitdiff
path: root/systems/vtex/os2/readme-os2.eng
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /systems/vtex/os2/readme-os2.eng
Initial commit
Diffstat (limited to 'systems/vtex/os2/readme-os2.eng')
-rw-r--r--systems/vtex/os2/readme-os2.eng370
1 files changed, 370 insertions, 0 deletions
diff --git a/systems/vtex/os2/readme-os2.eng b/systems/vtex/os2/readme-os2.eng
new file mode 100644
index 0000000000..03c8baa5b2
--- /dev/null
+++ b/systems/vtex/os2/readme-os2.eng
@@ -0,0 +1,370 @@
+============================================================
+ 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