util/src/TclTk/tcl8.6.12/pkgs/thread2.8.7/unix/README

   1
   2 I. Building the Tcl thread extension for Unix
   3 =============================================
   4
   5 Extension can be compiled on several Unix derivates including various
   6 distributions of Linux. Build process is pretty straightforward. I've
   7 checked some versions of Solaris, Linux and Darwin, but the extension
   8 should compile without problems on any Unix-like operating system
   9 with a proper pthreads library implementation.
  10
  11 To build on Unix-like operating systems, start with the CONFIG script
  12 and see if there is already a combination of the "configure" options
  13 which may satisfy your needs. If not, you can run the configure script
  14 located in the root of the distribution directory with a choice of
  15 supported options yourself.  If yes, you can uncomment corresponding
  16 lines from the CONFIG script and do:
  17
  18     % sh CONFIG
  19
  20 Either way, this will create a Makefile which you use to run "make" and
  21 "make install".
  22 You can use "make clean" to clean the directory from temporary compilation
  23 files and/or "make distclean" to additionaly remove local config files.
  24 You might want to do "make test" before doing the "make install" in order
  25 to run the regression tests on the package.
  26
  27 To explore other building options, look into the CONFIG file for more
  28 information.
  29
  30
  31 Note for NaviServer/AOLserver users
  32 ------------------------
  33
  34 The extension can be compiled as a loadable module for the
  35 NaviServer/AOLserver  version 4.0 or higher. In order to do this,
  36 use "--with-naviserver" configure option to specify the directory
  37 containing the NaviServer/AOLserver distribution. The CONFIG script
  38 has an example how to invoke configure in order to build the
  39 extension as NaviServer/AOLserver module. Note, however, that
  40 "make install" and "make test" targets are still not supported for
  41 NaviServer/AOLserver builds. This will be corrected in one of
  42 the future releases.
  43
  44 To fine-tune, you might also want to make the tsv::* commands replace
  45 the NaviServer/AOLserver built-in nsv_* family of commands, since
  46 they are API  compatible and provide richer command set plus advanced
  47 shared-object storage of shared data. Go to the generic/threadSvCmd.h
  48 file and look at the beginning of the file for the:
  49
  50 /* #define NSV_COMPAT 1 */
  51
  52 So, uncomment the line, recompile and there you go.
  53
  54
  55 II. Building optional support libraries
  56 =======================================
  57
  58 As of 2.6 release, this extension supports persistent shared variables.
  59 To use this functionality, you might need to download and compile some
  60 other supporting libraries. Currently, there is a simple implementation
  61 of shared variable persistency built atop of popular GNU Gdbm package.
  62 You can obtain the latest version of the Gdbm package from the GNU
  63 website at: http://www.gnu.org/software/gdbm/gdbm.html
  64 To compile with GNU Gdbm support you must configure with --with-gdbm
  65 switch. This option, if used, will try to locate the Gdbm library on
  66 your system at couple of standard locations. You might override this
  67 behaviour by giving --with-gdbm=/some/dir. Note that both library file
  68 and the include file must then reside in this directory.
  69
  70 -EOF-