------------------------------------------------------------

             LaTeX Local Guide for VTeX/Free

------------------------------------------------------------
                                                  2000-08-24


Copyright (C) 2000 Walter Schmidt



Contents
--------
Running LaTeX, BibTeX and Makeindex
Creating the format file
Additional LaTeX classes and packages
Using particular classes and packages with VTeX
The CM fonts in PostScript format
Using additional fonts
Documentation overview
The LaTeX configuration files
Languages supported with LaTeX
Cyrillic languages support
The file system layout of VTeX/Free



Running LaTeX, Bibtex and Makeindex
-----------------------------------
LaTeX is to be called through the commands

       vlatex
or       
       vlatexp

"vlatex" runs VTeX in PDF mode; "vlatexp" will create
PostScript output.  With both Linux and OS/2 these are shell
scripts.  
The name of the LaTeX source file is to be passed as the
argument; the default file type is ".tex".

In PDF mode, the GeX backend is automatically invoked as
soon as it is actually used.  In PostScript mode, GeX is not
used by default.  These and other settings can be changed by
editing the shell scripts; see the VTeX/Free manual
(vtex.pdf) for a description of the command line options.

Bibtex is executed through the command

       vbibtex 
       
and Makeindex is executed through

       vmakeindex

With Linux, these are shell scripts; with OS/2, the programs
are executed directly.  (Notice, that the names were chosen
so as not to clash with teTeX or emTeX, which may be
installed in parallel.)  
Usually, the name of the document, without (!)  extension,
is to be passed as the only argument.  You may obtain a
detailed description of the arguments that can be passed to
Bibtex and Makeindex by calling them with the option "-?".



Creating the format file
------------------------
Switch to the directory texmf/tex/latex/base, then run the 
following command:

with Linux:  /usr/local/vtex/bin/vtexlnx -i latex.tex

with  OS/2:  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.



Additional LaTeX classes and packages
-------------------------------------
In addition to the LaTeX base system the VTeX/Free
distribution inludes the following classes and packages:

* The "Tools" collection:  General extensions to the basic
LaTeX.

* AMS-LaTeX:  The classes and packages of the American
Mathematical Society

* The packages "graphics" and "color":  graphics inclusion
and color output.

* The packages "german" and "ngerman":  Ger,man language
support

* The package "babel":  multi-language support; see also the
below section "Languages supported with LaTeX".

* The package "hyperref":  using the hypertext facilities of
the PDF format.

* The "PSTricks" bundle:  PostScript graphics programming at
(La)TeX level.

* The "seminar" bundle

* FoilTeX: making foils and PDF presentations; this is a
special version 2.1.3b, supporting the [landscape] option
and rotated foils with VTeX.

* The "url" package: typesetting URLs and filenames;
documentation is contained as comment in the package file
texmf/tex/latex/misc/url.sty .

* The package "colortbl": color tables.

* The package "psfrag"

* The package "soul":  hyphenateable spacing out
(letterspacing), underlining, and some derivatives.

* The package "geometry":  facilities for easily changing
the page layout.



Using particular classes and packages with VTeX
-----------------------------------------------
Certain classes and packages need special attention when 
used with VTeX:

Packages amssymb, amsfonts, eufrak:  These packages need 
  NEVER be loaded with the option [psamsfonts].

Packages color und graphicx:  You need not specify the
  option [vtex] when loading these packages.  VTeX will read
  the configuration files color.cfg and graphics.cfg from
  the directory texmf/vtex/config; these files set up the
  packages for use with VTeX.  Do NOT provide any color.cfg
  or graphics.cfg files of your own for use with VTeX!
  
  See also the VTeX/Free manual (texmf/doc/vtex/vtex.pdf)
  for additional information on graphics inclusion
  facilities which are specific for VTeX.
  
Package hyperref:  You need not specify the option [vtex]
  when loading this package.  VTeX will read the
  configuration file hyperref.cfg from the directory
  texmf/vtex/config; this file sets up the hyperref package
  for use with VTeX.  Any options, which are specified when
  loading the hyperref package may overwrite the default
  settings from that .cfg file.  Do NOT provide a
  configuration file of your own for use with VTeX!
  
  See also the VTeX/Free manual (texmf/doc/vtex/vtex.pdf)
  for additional information on hypertext facilities which
  are specific for VTeX.

Package geometry:  Use of VTeX is autodetected; you need not
  specify the option [vtex] when loading this package.
  Furthermore, do NOT provide a configuration file
  geometry.cfg of your own for use with VTeX!
  
FoilTeX:  Use of VTeX is autodetected; you need not specify
  the option [vtex] when loading the foils class.

Seminar:  VTeX will read the configuration file seminar.con
  from the directory texmf/vtex/config; this file sets up
  the Seminar class for use with VTeX and includes also
  special patches for VTeX.  Do NOT provide a seminar.con
  file of your own for use with VTeX!
  
Package PSTricks:  VTeX will read the configuration file
  pstricks.con from the directory texmf/vtex/config; this
  file sets up the PSTricks package for use with VTeX and
  includes also special patches for VTeX.  Do NOT provide
  a pstricks.con file of your own for use with VTeX!



The CM fonts in PostScript format
---------------------------------
The default Computer Modern fonts are provided in PostScript
Type1 format for use with VTeX.  

Notice, however, that VTeX/Free does _not_ include EC fonts.
These are available from MicroPress, Inc, see
<http://www.micropress-inc.com/samples/ecfonts.htm>.  As a
substitute, you can use the virtual AE fonts; they "fake"
the T1 encoding (not TS1, however!)  as far as possible,
using the glyphs available with the ordinary CM fonts.  See
the file texmf/doc/latex/ae/README for the documentation.



Using additional fonts
----------------------
* The 35 PostScript base fonts, as well as Adobe Utopia and 
Bitstream Charter can be used through the PSNFSS bundle. 

* The package "mathrsfs" makes "Ralph Smith's Formal Script"
available for math.

* The package "wasysym" provides additional text and math
symbols from Roland Waldi's symbol font.

* The "mflogo" package:  Support for using the special fonts
for the Metafont/Metapost logo.

* The package "eurosans" makes the Euro symbol available.
The related fonts are, due to legal reasons, not part of the
VTeX distribution; the document doc/vtex/psfonts.eng
explains wher to obtain them for free and how to install
them.  Doing so is heavily recommended!

* VTeX/Free is prepared for additional PostScript fonts (CM
Bright, HV-Math and others) to be installed easily; see the
file texmf/doc/vtex/psfonts.eng for more information.



Documentation overview
----------------------
Documentation can be found in subdirectories of texmf/doc:

Topic               Directory below texmf/doc/

VTeX/Free        :  vtex
LaTeX base system:  latex/base
Bibtex           :  bibtex
Makeindex        :  Makeindex
Tools            :  latex/tools
AMS-LaTeX        :  latex/amsfonts
                    latex/amsmath
                    latex/amscls
graphics, color  :  latex/graphics
Babel            :  generic/babel
hyperref         :  latex/hyperref
PSTricks         :  generic/pstricks
Seminar          :  latex/seminar
FoilTeX          :  latex/foiltex
colortbl         :  latex/carlisle
psfrag           :  latex/psfrag
soul             :  generic/soul
geometry         :  latex/geometry
PSNFSS           :  latex/psnfss
mathrsfs         :  latex/jknappen
wasysym          :  latex/wasysym
mflogo           :  latex/mflogo
eurosans         :  latex/eurosans



The LaTeX configuration files
-----------------------------
The directory texmf/vtex/config contains the following
configuration files for LaTeX; please, do not alter these
files unless you know exactly what you are doing:

hyphen.cfg      : language support (hyphenation)
color.cfg       : for the color package
graphics.cfg    : for the graphics and graphicx packages
hyperref.cfg    : for the hyperref package
pstricks.con    : for PSTricks
seminar.con     : for the document class "seminar"
geometry.cfg    : for the "geometry" package
latex.tex,      : creating the LaTeX format file
preload.cfg     : (dito)

The directory texmf/vtex/config is _always_ searched before
the other subdirectories of texmf/tex.

When VTeX/2 is installed "on top" of emTeX/TDS, you may
provide different instances of these files for use with
emTeX in any subdirectories of texmf/tex/, which are
effectively "invisible" to VTeX then.  In turn, emTeX does
not search the directory texmf/vtex/config, so the files in
this directory are special for VTeX.



Languages supported with LaTeX
------------------------------
Automatic hyphenation is supported for the following
languages:

USenglish  ( American English )
english    ( British English )
catalan
danish
dutch
finnish
french
german     ( traditional spelling )
ngerman    ( new spelling )
italian
norwegian
polish
portuges
russian    ( for use with T2A encoded fonts only)
slovene
usorbian   ( = Upper Sorbian )
spanish
swedish

The Babel system as well as german.sty or ngerman.sty can be
used for language support.  



Cyrillic languages support
--------------------------
VTeX/Free contains the so-called "cyrillic bundle", i.e.
the basic interface for cyrillic input and output; see the
file texmf\doc\latex\base\cyrguide.pdf for the
documentation.  Russian hypenation patterns are also
provided, see above.  For the time being, however, Cyrillic
fonts are not yet distributed with VTeX/Free.



The file system layout of VTeX/Free
-----------------------------------
The directory structure of VTeX/Free complies with the 
"TDS" standard (see CTAN: tds/draft-standard/tds/).
The root directory of the TEXMF tree is

        /usr/local/vtex/texmf  (Linux)
or
        <drive>:\texmf         (OS/2)
        
VTeX will search recursively for TeX input files, font
metrics (.tfm) and virtual fonts, in the "usual"
directories.

Notice, however, a few peculiarities:

* Type-1 fonts (.pfb) are located below texmf/fonts/type1;
VTeX does, however, not search for them recursively.
Instead, their location must be specified in the font map
("aliasing") files -- see the VTeX manual (vtex.pdf) and the
"Description of the font setup" (font-setup.txt).

* Makeindex style files (.ist) are located in the directory
texmf/makeindex only.  The VTeX implementation of Makeindex
will not search the subdirectories of texmf/makeindex.  You
may specify further directories for .bst files in the main
configuration file (keyword MSTDIR).  Recursive searching is
not possible, however.

* Bibtex style files (.bst) are located in the directory
texmf/bibtex/bst, and 
* Bibtex database files (.bib) are located in the directory
texmf/bibtex/bib.  
The VTeX implementation of Bibtex will not search any
subdirectories of these, unless you specify them in the main
configuration file (keywords BSTDIR and BIBDIR).  Recursive
searching is not possible, however.


-- finis

