============================================================ Installation instructions for VTeX/2 8.11 ============================================================ Walter Schmidt 2003-03-12 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 a TeX 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 are generated, no "dvi driver programs" are required, and there is no need to care for their -- sometimes problematic -- 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 Acrobat 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. Note that PDF files created by VTeX version 7.30 and above do not conflict with Acrobat Reader 5. 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, version 0.56. If you install VTeX/2 on the same drive as an existing emTeX/TDS, they will share the same texmf directory tree, thus saving lots of disk space. Make sure that you have installed the latest version 0.56 of emTeX/TDS! If you keep VTeX and emTeX on different drives, they will be completely independent. After installing VTeX 8.11 over emTeX/TDS 0.56, you should re-make the emTeX format files. Installing VTeX/2 over emTeX/TDS will update the dvips map files psfonts.map and cmfonts.map, so that dvips can use the additinal Type1 fonts that come with VTeX -- except for the EC fonts, which work with VTeX only. Required files -------------- vtexinst.cmd (installation program) vtex2.zip vtex-texmf.zip vtex-special.zip vtex-fonts.zip vtex-fonts2.zip vtex-doc.zip vtex-sem.zip (optional) vtex-gex.zip (optional) Remarks: In contrast to previous versions, you must not omit any of the (non-optional) archives, when installing iver emTeX. When updating from v7.53, the huge file vtex-fonts2.zip is not needed once again. 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. vtex-gex.zip includes the documentation of VTeXs built-in PostScript interpreter; omit this file, if you want. You may still install these two files at any later time. The files are unchanged since release 7.460 (vtex-sem) and 7.320 (vtex-gex). Installing VTeX/2 ----------------- (0) Any existent version of VTeX _prior_ to 7.10 must be deleted manually. (Sorry...) (1) Put the installation program vtexinst.cmd and all required ZIP files (see above) in 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!) You will 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. If a previous version of VTeX is found, the following configuration files will be backed up, with the extension ".sav" appendend to the original name: \vtex\bin\vtex.ini \texmf\vtex\config\hyphen.cfg \texmf\vtex\config\plain.cfg \texmf\vtex\config\pdf.fm \texmf\vtex\config\ps.fm According to the existing version of VTeX, the installation program will either restore the existing files, or it will replace them with new ones and issue an appropriate message. These actions are also logged in the file vtexinst.log (transcript of the installation process). (3) VTeX/2 requires the following settings in the system configuration file config.sys of OS/2: PATH must include :\VTEX\BIN LIBPATH must include :\VTEX\DLL (Replace 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! | Installing the Adobe Euro Fonts ------------------------------- VTeX/Free already includes the macro package, the font metrics and a font map file for the "Adobe Euro" fonts, which provide the "Euro" currency symbol. Due to legal reasons the fonts are NOT distributed in conjunction with VTeX; instead, you have to download them from Adobe's FTP server. The fonts are available for free, and installing them is *** highly recommended ***. Obtain the following file via the internet: ftp://ftp.adobe.com/pub/adobe/type/win/all/eurofont.exe or ftp://ftp-pac.adobe.com/pub/adobe/type/win/all/eurofont.exe This is a self-extracting archive for DOS/Win, which can also be unpacked using unzip. Copy all files of type .pfb from the subdirectory "eurofont" of the archive to the directory "texmf/fonts/type1/adobe/eurofont" of your VTeX system, and rename them as follows: _1______.PFB -> zpeurs.pfb _1B_____.PFB -> zpeubs.pfb _1I_____.PFB -> zpeuris.pfb _1BI____.PFB -> zpeubis.pfb _2______.PFB -> zpeurt.pfb _2B_____.PFB -> zpeubt.pfb _2I_____.PFB -> zpeurit.pfb _2BI____.PFB -> zpeubit.pfb _3______.PFB -> zpeur.pfb _3B_____.PFB -> zpeub.pfb _3I_____.PFB -> zpeuri.pfb _3BI____.PFB -> zpeubi.pfb The Euro fonts can be used with LaTeX through the "eurosans" package, which is documented in the file texmf/doc/latex/eurosans/README.eurosans 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 . 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 gex.pdf GeX Manual forms.pdf How to use PDF forms from TeX animgif.pdf How to include animated GIFs into PDF documents examples\* Sample documents | | Read the file local.eng; it has been thoroughly updated! | The sample file tryanim.tex and part of the examples in the document animgif.pdf do not work with Acrobat Reader 5, 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 In conjunction with VTeX/2 v8.11 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: The OS/2 port has been done primarily by Michael Vulis. The distribution and the documentation are maintained by Walter Schmidt. Additional thanks to Domald Arseneau, Jon Babcock, Denis Girou, Taco Hoekwater, Christoph Kloeters, Alexander Mai, Bernd Mulansky, Herbert Voss and others for their help and advice. Special thanks to Heiko Oberdiek for constantly improving the Hyperref support. Legal stuff ----------- MicroPress and VTeX are trademarks of MicroPress, Inc. The MicroPress' components of the VTeX/2 distribution are Copyright (C) 1998-2003 by MicroPress Inc. The MicroPress' components of the VTeX/2 distribution are free for personal use, subject to the following restriction: You must obtain a permission from either MicroPress Inc or Walter Schmidt, if you intend to redistribute VTeX/2 on a permanent media (CD), or host it on a Web site other than by mirroring the official distribution. Adobe, Acrobat and PostScript are trademarks of Adobe Systems Incorporated. == finis