


To test out YACL:

    0.  Create and change into the directory you want to install YACL in.
        For example, under DOS or OS/2:

              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

        If you are using Borland C++, edit the file control/bcmak.ctl.
        In that file, set the variable BCPATH to point to the root
        directory of your Borland C++ system, e.g.,

             set BCPATH=c:\borlandc

        If you are using EMX under OS/2, edit the file
        control/emxmak.ctl. In that file, set the variable EMXPATH to
        point to the bin directory of the compiler. Its default
        setting in that file is e:\emx\bin.
        
    3.  If you are building the library under MS-Windows with Borland
        C++ 3.1, you need to do these additional steps (you don't
        need these if you have Borland C++ 4.0 or later):

            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).

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

        (a) MS-Windows, Borland C++:

              Type
                   make -fmakefile.bc -D__DOS__

              to build the DOS version, or

                   make -fmakefile.bc -D__MS_WINDOWS__

              to build the Windows version. The UI library is available
              under Windows but not plain DOS.

        (b) OS/2 with Borland C++:

              In an OS/2 command window, type 

                   make -fmakefile.bc


        (c) OS/2 with EMX (GNU) C++:  

              In an OS/2 command window, type 

                   make -f makefile.emx

        (d) Unix system with GNU C++: 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 three makefiles, makefile.bc (for
        Borland C++), makefile.emx (for EMX under OS/2) 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.

