home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 18 REXX / 18-REXX.zip / rexxtk12.zip / INSTALL < prev    next >
Text File  |  2001-04-12  |  4KB  |  118 lines
  1.                              Rexx/Tk
  2.  
  3.                              Contents
  4.                              --------
  5.               1. Installation of Rexx/Tk on Unix
  6.               2. Installation of Rexx/Tk on OS/2 and Windows NT/9x/2k
  7.               3. Testing the installation
  8.  
  9. Please read ALL of these notes before building Rexx/Tk!
  10.  
  11.  
  12. 1. Installation of Rexx/Tk on Unix
  13. ==================================
  14. To install Rexx/Tk, unpack the archive (you have probably already done
  15. that), run the configure script supplying the necessary command line 
  16. parameters.  To see what parameters the configure script recognises,
  17. type ./configure --help
  18.  
  19. Because Rexx/Tk can be configured to run with different Rexx interpreters, 
  20. you must specify the Rexx interpreter you plan on using.
  21. To see the options available, run:
  22.  
  23. configure --help
  24.  
  25. If you are interested in building different versions of Rexx/Tk on 
  26. the one platform; like a Regina version and a REXX/imc version
  27. you can do something like this.
  28.  
  29. To build a version of Rexx/Tk with Regina:
  30.  
  31. mkdir regina
  32. cd regina
  33. ../configure --with-rexx=regina
  34. make
  35.  
  36. To build a version of Rexx/Tk with REXX/imc:
  37.  
  38. mkdir rexximc
  39. cd rexximc
  40. ../configure --with-rexx=rexximc
  41. make
  42.  
  43. The configure script looks in some common places for the Rexx libraries 
  44. and header files. These are defined in the configure script. Some of the
  45. common directories are $HOME/include, /usr/local/include for header files
  46. and $HOME/lib and /usr/local/lib for libraries.  There are several others;
  47. see configure for the full list.
  48.  
  49. If you have installed your Rexx interpreter in a location that the
  50. configure script cannot find, there are two ways in which you can tell
  51. the configure script where to look.
  52. 1) Set environment variables:
  53.    This is useful if you only ever build Rexx extensions with the one
  54.    Rexx interpreter and the interpreter is not in one of the common locations.
  55.    REXXINCDIR -> directory where the Rexx interpreter header files are
  56.    REXXLIBDIR -> directory where the Rexx interpreter library files are
  57. 2) Specify the directories on the configure command line
  58.    This is useful if you wnat to build with different interpreters.
  59.    and the interpreters are not in one of the common locations.
  60.    --with-rexxincdir=dir -> where dir is the location of the header files
  61.    --with-rexxlibdir=dir -> where dir is the location of the library files
  62.  
  63. The directory search order is as follows:
  64. - configure command line options
  65. - environment variables
  66. - builtin, common directories
  67.  
  68. Once you have Rexx/Tk built, it can then be installed.  By default, the
  69. Rexx/Tk executable will be installed into /usr/local/bin, while the 
  70. dynamically loadable external function package will be installed into 
  71. /usr/local/lib.  The base path "/usr/local" can be changed by adding the 
  72. --prefix=path (where path is the base path) to the configure command.
  73. eg. to install Rexx/Tk into /opt/bin and /opt/lib, 
  74. configure --prefix=/opt ...
  75.  
  76.  
  77. To install Rexx/Tk, run "make install"
  78.  
  79. If the platform you are installing Rexx/Tk on does not support dynamically
  80. loadable libraries, you may get some errors during the "make install";
  81. these can be ignored.
  82.  
  83. Where the platform does support dynamically loadable libraries, you may
  84. need to tell your operating system where these shared libraries are. The
  85. method of doing this varies between operating systems, but generally
  86. involves adding the installed directory to an environment variable such
  87. as LD_LIBRARY_PATH, LIBPATH, etc.
  88.  
  89.  
  90. 2. Installation of Rexx/Tk on OS/2 and Windows NT/9x/2k
  91. =======================================================
  92. (OS/2 is not supported yet)
  93. Unpack the archive. You've probably already done this.
  94. Copy all executables and DLLs into a directory already in the system
  95. PATH, or to a new directory, but remember to include this directory
  96. in the PATH. On Windows 95/98, you will need to reboot before the
  97. new PATH is effective.
  98.  
  99. 3. Testing the installation
  100. ===========================
  101. Once you have the Rexx/Tk executables and DLLs (or shared libraries)
  102. installed, run the demo program; testtk.rexx.
  103.  
  104. First run testtk.rexx with the supplied Rexx/Tk executable:
  105.  
  106. Unix>  ./rexxtk testtk.rexx
  107. OS/2>  rexxtk testtk.rexx
  108. Win32> rexxtk testtk.rexx
  109.  
  110. Next run testtk.rexx directly with your Rexx interpreter: (using Regina
  111. as the example)
  112.  
  113. Unix>  regina testtk.rexx
  114. OS/2>  regina testtk.rexx
  115. Win32> regina testtk.rexx
  116.  
  117.  
  118.