A Step-by-Step Guide for Installing VFlib 3.6

To install VFlib 3, following libraries are (optionally) required: FreeType, T1Lib, kpathsea. Install them before you compile VFlib 3. These external libraries are optional and therefore VFlib 3 can be compiled not to use such libraries. But in such a case, you cannot use TrueType, Type1 fonts and searching TeX fonts is very limited. So, I strongly recommend to use such libraries.

1. Installation of Kpathsea

Obtain Web2c 7.2 package from the download page or CTAN.
Unpack the archive file. (The percent character % below is a prompt of a shell.)
```
  % gzip -cd < web2c-7.2.tar.gz | tar xvf - 
```
Go to the web2c directory.
```
  % cd web2c-7.2 
```
Run configure script.
```
  % ./configure
```
Run make to compile.
```
  % make 
```

Become a root user and install. (Or, ask a root user to do this stage.)

  % su 
  Password: XXXXXXX    (type the password for root user)
  # make install
  # exit
  %

Go to up directory.
```
  % cd .. 
```

2. Installation of FreeType

Obtain FreeType version 1.2 or lalter from the download page or freetype.org.

The procedure is quite similar to the previous one.

  % gzip -cd < freetype-1.2.tar.gz | tar xvf - 
  % cd freetype-1.2
  % ./configure
  % make
  % su 
  # make install
  # exit
  % cd ..

3. Installation of T1Lib

Obtain T1Lib 1.3 or later from the home page of T1Lib. (T1Lib 1.3 has been released recently.)

The procedure is quite similar to the previous one.

  % gzip -cd < t1lib-1.3.tar.gz | tar xvf - 
  % cd T1Lib-1.3
  % ./configure
  % make
  % su 
  # make install
  # exit
  % cd ..

Some make program may not handle the Makefile in T1Lib. In such a case, try GNU make (gmake) to compile.

Installation of VFlib 3

Obtain VFlib 3.6 from the download page
The procedure is quite similar to the previous one. But run configure-site script.
```
  % gzip -cd < VFlib3-3.6.14.tar.gz | tar xvf - 
  % cd VFlib3-3.6.14
  % ./configure-site
```
Note
By default, configure script configures VFlib3 not to use FreeType, Type1, and kpathsea. Thus, TrueType and Type 1 fonts cannot be used. To compile VFlib to use these features, run configure program with the following long options, for example. Probably, most users do the following.
```
   % ./configure --with-kpathsea \
                   --with-kpathsea-includedir=/usr/local/include \
                   --with-kpathsea-libdir=/usr/local/lib \
                 --with-freetype \
                    --with-freetype-includedir=/usr/local/include \
                    --with-freetype-libdir=/usr/local/lib \
                 --with-t1lib \
                    --with-t1lib-includedir=/usr/local/include \
                    --with-t1lib-libdir=/usr/local/lib    [RETURN]
```
But it is long to type; a script configure-site invokes configure with these options. If youd don't like settings in configure-site, modify it according to your system environment, or manually run configure with options.

Now, compile VFlib.

  % make
  % su 
  # make install
  # exit
  % cd ..

Optional: Installation of TeX-Guy

Obtain TeX-Guy 1.3 from the download page
The procedure is quite similar to the previous one. (If you want to use xgdvi, you must install GTK+ 1.2 and GNU gettext. Install them before you compile TeX-Guy.)
```
  % gzip -cd < TeX-Guy-1.3.1.tar.gz | tar xvf - 
  % cd TeX-Guy-1.3.1
  % ./configure-site
  % make
  % su 
  # make install
  # exit
  % cd ..
```

Now, you are done.