============================================================ Installation instructions for VTeX/2 7.33 ============================================================ Walter Schmidt 2001-06-21 Contents -------- What is VTeX/2? Overview Prerequisites Installing VTeX/2 over emTeX/TDS Installing VTeX/2 Deleting obsolete files Configuring VTeX/2 Creating the LaTeX format file Running LaTeX Using the EPM TeX Front End with VTeX/2 Documentation Support Legal stuff What is VTeX/2 ? ---------------- VTeX/2 is a TeX program for OS/2 Warp that generates PDF or PostScript output immediately from the TeX source file. It comes with a complete LaTeX system, including many additional packages and fonts, as well as the Bibtex and Makeindex programs. A basic plain TeX system is also included. In contrast to pdfTeX, VTeX includes a full PostScript interpreter, so inclusion of EPS images is fully supported, as well as inline PostScript programming, i.e. PSTricks, psfrag etc. 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. The common PostScript and PDF viewers GSView and Acrobat Reader are to be used for (pre)viewing and printing. VTeX's output files 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.55. Overview -------- The distribution is made up from the following files: vtex2.zip binaries, shell scripts, main configuration file vtex-texmf.zip vtex-texmfb.zip vtex-special.zip vtex-fonts.zip vtex-sem.zip Macros (TeX and LaTeX), PostScript fonts and LaTeX documentation for a basic working TeX system. vtex-doc.zip gex.zip VTeX-specific documentation Prerequisites ------------- * VTeX/2 requires Warp 3 or better, and at least 16Mb of physical memory. * You must have installed Ghostscript, so as to provide a PostScript and PDF reader; furthermore, the Type1 fonts that are part of the Ghostscript distribution will be used by VTeX, too. * 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 40MB of disk space. 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. If you install VTeX/2 on the same drive as an existing emTeX/TDS, the will share the same texmf directory tree, this saving lots of disk space. Make sure that you have installed the latest version 0.55 of emTeX/TDS! If you keep VTeX and emTeX on different drives, they will be completely independent. Installing VTeX/2 ----------------- (0) In case you are already running a previous version of VTeX/Free, you should back up the configuration files: vtex\bin\vtex.ini texmf\vtex\config\pdf.fm texmf\vtex\config\ps.fm They will be overwritten in course of the subsequent installation procedure; please, check your settings against the new files afterwards! * * Any version of VTeX _prior_ to 7.10 is to be deleted! * (1) Unzip vtex2.zip in the root directory of a drive, say C:. This will create a directory named \vtex with several subdirectories.: c: cd \ unzip \vtex2 The unzip program may ask you several times whether to overwrite existing files: Enter "A" (i.e, "all files"). This holds for the next step, too. * * If you had installed v7.32 previously, you need not * unzip the remaining files, as they are unchanged. * Proceed with section "Creating the LaTeX format file". * (2) Unzip the remaining ZIP files in the root directory of the same drive. Doing so will create a directory named \texmf with several subdirectories: unzip \vtex-texmf unzip \vtex-texmfb unzip \vtex-fonts unzip \vtex-sem unzip \vtex-doc If you do not intend to use the Seminar and Prosper packages for LaTeX, you may omit vtex-sem.zip (or install it later). You may omit gex.zip, if you are not interested in the technical details of VTeX's built-in PostScript interpreter. Do _not_ omit any zip files, if you are installing VTeX over emTeX/TDS; a few files of the emTeX system need to be updated. (3) When VTeX/2 is installed for the first time: Edit the system configuration file config.sys then, adding "c:\vtex\bin" to the PATH and "c:\vtex\dll" to the LIBPATH settings. (Replace "c:" with the actual drive, where you have unpacked the file vtex2.zip -- see step 1) Shut down and reboot OS/2, to make the changes come into effect. (4) When installing over an existent VTeX 7.10, the following files are to be deleted manually, as they are obsolete now. They are not overwritten in step (2), because they reside in other directories now or have been renamed: vtex\bin\vbibtex.exe vtex\bin\vmakeindex.exe texmf\doc\makeindex\makeindex.txt texmf\doc\vtex\local.ger texmf\doc\vtex\psfonts.ger texmf\tex\latex\seminar\fancybox.sty Configuring VTeX/2 ------------------ There are three main configuration files which must be adapted to your system: \vtex\bin\vtex.ini \texmf\vtex\config\pdf.fm \texmf\vtex\config\ps.fm File vtex.ini: Change any occurence of "c:\texmf" and "c:\vtex" to reflect the drive letter, where you have installed VTeX/2. Files pdf.fm and ps.fm: Locate the following section of each file: LOCAL-OS2 { TEXMF = "c:/texmf/" URW = "c:/gstools/fonts/" } Edit "c:/texmf/" so as to reflect the drive letter where you have installed VTeX/2. Edit "c:/gstools/fonts/" so as to reflect the directory where the fonts, that came with Ghostscript, are located. Notice that both ps.fm and pdf.fm need to be edited, that the paths use slashes -- not backslashes -- as directory separators, and that the paths must provide a trailing slash! Creating the LaTeX format file ------------------------------ c: cd \texmf\tex\latex\base vtex -i latex.tex (Notice, that "latex.tex" is NOT a typo!) Check the log file latex.log, then move it to \vtex\fmt\ for later reference; this is the directory where the format files are kept. If there is a complaint in the log file about "BAD file texsys.aux", then you have to delete the file texsys.aux from the directory \texmf\tex\latex\base\ and try again; installation should run smoothly then. Running LaTeX ------------- LaTeX is executed through the cmd scripts vlatex.cmd and vlatexp.cmd: vlatex or vlatexp "vlatex" will generate PDF output, whereas "vlatexp" will generate a PostScript file First, you should run the file ltxcheck.tex through LaTeX, thus making sure that the installation works. The file resides in the directory source\latex\base\ of your texmf tree: c: cd \texmf\source\latex\base vlatex ltxcheck LaTeX will complain that the EC fonts aren't available. This is correct: VTeX can handle PostScript fonts only, and the EC fonts in Type1 format are not distributed with VTeX/Free. 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 . When using the particular "VTeX" variant of the TeX Front End, you have to make sure that VTeX is executed with correct options; these can be examined and changed through the "Settings" menu of the TeX Front End. The default settings of the TeX Front End, version 3.0 or before, may be inappropriate for VTeX/Free 7.32. In PostScript mode, the recommended options are: -ov -pu0 -ofps -$s(g=a In PDF mode, the recommended options are: -ov -pu0 -ox2 -ob2 -ofpdf -$p(h=29.7cm,w=21cm,f=cf,t=f,g=f,! * * Note "f=cf", i.e. embedding fonts in CFF format! This * was introduced with v7.30 and results in a remarkable * decrease of the size of the generated PDF files! * 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 (you may ignore it, if you don't know what "plain TeX" is) vtex.pdf The VTeX/Free manual font-setup.txt Preliminary description of the VTeX font setup gex.pdf GeX Manual forms.pdf How to use PDF forms from TeX animgif.pdf How to include animated GIF's into PDF documents psfonts.eng How to install additional Type1 fonts examples\* Sample documents 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 is run by Majordomo, so to subscribe send a message to with the following line in the body subscribe ntg-vtex The mailing list itself can be reached as Legal stuff ----------- MicroPress and VTeX are trademarks of MicroPress, Inc. The MicroPress' components of the VTeX/2 distribution are Copyright (C) 1998-2001 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 commercial license from MicroPress if you intend to redistribute VTeX/2 on a permanent media (CD). Adobe, Acrobat and PostScript are trademarks of Adobe Systems Incorporated. == finis