

                         YACL   HOWTO.TXT
                         
                      How to use YACL with SUN C++
                         
                     Last update: October 19th, 1996
                         


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


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.  [This step is probably not necessary any more, because YACL now comes
        with CR's stripped.] You must remove the carriage-return characters
        at the ends of lines in all files. There are two scripts provided to
        help with this. To use them, simply invoke removecr after changing
        permissions:

                  cd  $YACLPATH
                  chmod 0755 tools/stripcr tools/removecr
                  ./tools/removecr


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

                   make -f cfr_sun.mak
         

    6.  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"



----------------------------- END OF CFR_SUN.TXT  ----------------------
