


To test out YACL:

    0.  Change into the directory you want to install YACL in.
        For example:

              md c:\yacl
              c:
              cd \yacl

        or, under Unix:

              mkdir ~/yacl
              cd ~/yacl

    1.  Unzip the file YACL.ZIP, preserving directories. For example:

             unzip yacl.zip

    2.  Set the environment variable YACLPATH to point to the
        directory in which yacl was unzipped, e.g.,

             set YACLPATH=c:\yacl

        or, under Unix:

             export YACLPATH=$HOME/yacl

        Set the variable BCPATH to point to the root directory of your
        Borland C++ 3.1 system, e.g.,

             set BCPATH=c:\borlandc

    3.  If you are building the library under MS-Windows with Borland
        C++ 3.1, you need to do these additional steps:

            3a. Copy the file ctl3d.h from the lib\windows directory
                into the Borland include directory, e.g.,

                   copy c:\yacl\lib\windows\ctl3d.h c:\borlandc\include

            3b. Run implib to create ctl3d.lib, e.g.:

                   cd c:\yacl\lib\windows
                   implib ctl3d.lib ctl3d.dll
                   

    4.  If you are building the library under a Unix system, there are
        a few additional steps. You must have Motif installed if you
        want to build the UI library under Unix.

        4a. 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

         4b. Set the YACLPLATFORM variable in the control file
             $YACLPATH/gccmak.ctl. By default, it is set to linux; change
             it to whatever your platform is (pick your favorite name, if
             you wish).

         4c. Create a directory $YACLPATH/lib/<blah> where <blah> is
             the name you chose in step 4b.
             

    5.  Build the libraries.

        5a. To build for  MS Windows, you can use the Borland C++
            makefiles included. Type
        
                 make -fmakefile.bc -D__MS_WINDOWS__
         
         5b. To build for OS/2, type (in an OS/2 command window)
         
                 make -fmakefile.bc

             which assumes that you have Borland C++ for OS/2.
         
         5c. To build the Unix  version, you will need to use the make
             file makefile.gcc. Make sure you have gcc version 2.6.0
             or later, because the library will not compile under
             earlier versions. The typical command line is

                 make -f makefile.gcc
         

    6.  Poke around in the directory structure under basedemo and
        uidemo; build and try out the programs there using the make
        files provided. There are two makefiles, makefile.bc (for
        Borland C++) and makefile.gcc (for GNU C++) in the uidemo
        directory, which build all the UI demos.

Please report any bugs to the author. All comments and suggestions are
welcome. Hope you find this useful.

