home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / yacl-012.zip / howto.txt < prev    next >
Text File  |  1995-04-05  |  4KB  |  121 lines
  1.  
  2.  
  3.  
  4. To test out YACL:
  5.  
  6.     0.  Create and change into the directory you want to install YACL in.
  7.         For example, under DOS or OS/2:
  8.  
  9.               md c:\yacl
  10.               c:
  11.               cd \yacl
  12.  
  13.         or, under Unix:
  14.  
  15.               mkdir ~/yacl
  16.               cd ~/yacl
  17.  
  18.     1.  Unzip the file YACL.ZIP, preserving directories. For example:
  19.  
  20.              unzip yacl.zip
  21.  
  22.     2.  Set the environment variable YACLPATH to point to the
  23.         directory in which yacl was unzipped, e.g.,
  24.  
  25.              set YACLPATH=c:\yacl
  26.  
  27.         or, under Unix:
  28.  
  29.              export YACLPATH=$HOME/yacl
  30.  
  31.         If you are using Borland C++, edit the file control/bcmak.ctl.
  32.         In that file, set the variable BCPATH to point to the root
  33.         directory of your Borland C++ system, e.g.,
  34.  
  35.              set BCPATH=c:\borlandc
  36.  
  37.         If you are using EMX under OS/2, edit the file
  38.         control/emxmak.ctl. In that file, set the variable EMXPATH to
  39.         point to the bin directory of the compiler. Its default
  40.         setting in that file is e:\emx\bin.
  41.         
  42.     3.  If you are building the library under MS-Windows with Borland
  43.         C++ 3.1, you need to do these additional steps (you don't
  44.         need these if you have Borland C++ 4.0 or later):
  45.  
  46.             3a. Copy the file ctl3d.h from the lib\windows directory
  47.                 into the Borland include directory, e.g.,
  48.  
  49.                    copy c:\yacl\lib\windows\ctl3d.h c:\borlandc\include
  50.  
  51.             3b. Run implib to create ctl3d.lib, e.g.:
  52.  
  53.                    cd c:\yacl\lib\windows
  54.                    implib ctl3d.lib ctl3d.dll
  55.                    
  56.  
  57.     4.  If you are building the library under a Unix system, there are
  58.         a few additional steps. You must have Motif installed if you
  59.         want to build the UI library under Unix.
  60.  
  61.         4a. You must remove the carriage-return characters at the ends
  62.             of lines in all files. There are two scripts provided to
  63.             help with this. To use them, simply invoke removecr after
  64.             changing permissions:
  65.  
  66.                   cd  $YACLPATH
  67.                   chmod 0755 tools/stripcr tools/removecr
  68.                   ./tools/removecr
  69.  
  70.          4b. Set the YACLPLATFORM variable in the control file
  71.              $YACLPATH/gccmak.ctl. By default, it is set to linux; change
  72.              it to whatever your platform is (pick your favorite name, if
  73.              you wish).
  74.  
  75.     5.  Build the libraries. CD into the directory you chose in step 0
  76.         and issue the make command as below:
  77.  
  78.         (a) MS-Windows, Borland C++:
  79.  
  80.               Type
  81.                    make -fmakefile.bc -D__DOS__
  82.  
  83.               to build the DOS version, or
  84.  
  85.                    make -fmakefile.bc -D__MS_WINDOWS__
  86.  
  87.               to build the Windows version. The UI library is available
  88.               under Windows but not plain DOS.
  89.  
  90.         (b) OS/2 with Borland C++:
  91.  
  92.               In an OS/2 command window, type 
  93.  
  94.                    make -fmakefile.bc
  95.  
  96.  
  97.         (c) OS/2 with EMX (GNU) C++:  
  98.  
  99.               In an OS/2 command window, type 
  100.  
  101.                    make -f makefile.emx
  102.  
  103.         (d) Unix system with GNU C++: You will need to use the make file
  104.             makefile.gcc. Make sure you have gcc version 2.6.0 or later,
  105.             because the library will not compile under earlier versions.
  106.             The typical command line is
  107.  
  108.                    make -f makefile.gcc
  109.          
  110.  
  111.     6.  Poke around in the directory structure under basedemo and
  112.         uidemo; build and try out the programs there using the make
  113.         files provided. There are three makefiles, makefile.bc (for
  114.         Borland C++), makefile.emx (for EMX under OS/2) and
  115.         makefile.gcc (for GNU C++) in the uidemo directory, which
  116.         build all the UI demos.
  117.  
  118. Please report any bugs to the author. All comments and suggestions are
  119. welcome. Hope you find this useful.
  120.  
  121.