# How to use YACL with SUN C++

Last update: June 20th, 1997

This file provides directions on how to build YACL and its demo programs using Sun's native C++ compiler.

## Building YACL

Here are the steps:

0. Create and change into the directory in which you want to install YACL. For example:

  `mkdir ~/yacl`
  `cd ~/yacl`

1. Unzip the file yacl0160.zip, preserving directories. For example:

`unzip yacl0160.zip`

If you ftp'ed the .tar.Z version, uncompress and un-tar it:

  `uncompress yacl0160.tar.Z`
  `tar xvf yacl0160.tar`

2. Set the environment variable YACLPATH to point to the directory in which yacl was unzipped. For example (under bash or ksh):

`export YACLPATH=$HOME/yacl`

3. Edit the file control/cfr_sun.ctl and make sure that the path names specified there correspond to the paths of system components in your installation.

4. Build the libraries. CD into the directory you chose in step 0 and issue the make command

`make -f cfr_sun.mak`

5. Poke around in the directory structure under basedemo and uidemo; build and try out the programs there using the makefiles provided. Each demo program is in a separate directory with a Sun C++-specific makefile called cfr_sun.mak. I have provided makefiles for most of the base demos but not all because most, if not all, the base classes are heavily used in the UI classes.

You can also build a debug version of the library via the command

`make -f cfr_sun.mak DEBUG="-g -DDEBUG"`

## Known problems

This is a cfront-based compiler with lots of idiosyncracies about template instantiation. There's a lot of code surrounded by "`#ifdef __CFRONT__`" intended to appease this compiler. Thanks to Jody Hagins for the help on this.