diff options
Diffstat (limited to 'systems/vtex/os2/readme-os2.eng')
-rw-r--r-- | systems/vtex/os2/readme-os2.eng | 370 |
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 |