From 4116b8b0f5e04347782dfbce5b1ee35134e2a31a Mon Sep 17 00:00:00 2001 From: nagai Date: Tue, 25 Jan 2005 14:31:45 +0000 Subject: * ext/tk: merge tcltklib for Ruby/Tk installation control * ext/tcltklib: remove git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@7826 b2dd03c8-39d4-4d8f-98ff-823fe69b080e --- ext/tk/README.ActiveTcl | 49 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 ext/tk/README.ActiveTcl (limited to 'ext/tk/README.ActiveTcl') diff --git a/ext/tk/README.ActiveTcl b/ext/tk/README.ActiveTcl new file mode 100644 index 0000000000..3afb3f4cf6 --- /dev/null +++ b/ext/tk/README.ActiveTcl @@ -0,0 +1,49 @@ +ActiveTcl is ActiveState's quality-assured distribution of Tcl. + +# see +# + +If you want to use ActiveTcl binary package as the Tcl/Tk libraries, +please use the following configure options. + + --with-tcl-dir= + --with-tk-dir= + +And use the followings if you need. + + --with-tcllib= + --with-tklib= + --enable-tcltk-stubs + +For example, when you install ActiveTcl-8.4.x to '/usr/local/ActiveTcl', + + configure --with-tcl-dir=/usr/local/ActiveTcl/ \ + --with-tk-dir=/usr/local/ActiveTcl/ \ + --with-tcllib=tclstub8.4 \ + --with-tklib=tkstub8.4 \ + --enable-tcltk-stubs + +It depends on your environment that you have to add the directory of +ActiveTcl's libraries to your library path when execute Ruby/Tk. +One of the way is to add entries to TCLLIBPATH environment variable, +and one of the others add to LD_LIBRARY_PATH environment variable + +Probably, using TCLLIBPATH is better. The value is appended at the +head of Tcl's 'auto_path' variable. You can see the value of the +variable by using 'Tk::AUTO_PATH.value' or 'Tk::AUTO_PATH.list'. + +For example, on Linux, one of the ways is to use LD_LIBRARY_PATH +environment variable. +------------------------------------------------------------------------- + [bash]$ LD_LIBRARY_PATH=/usr/local/ActiveTcl/lib:$LD_LIBRARY_PATH \ + ruby your-Ruby/Tk-script + + [bash]$ LD_LIBRARY_PATH=/usr/local/ActiveTcl/lib:$LD_LIBRARY_PATH irb +------------------------------------------------------------------------- +Based on it, the Tcl interpreter changes auto_path variable's value. + +Then, you'll be able to use Tcl/Tk extension libraries included in the +ActiveTcl package (e.g. call TkPackage.require('BWidget'), and then, +use functions/widgets of BWidget extention). + + Hidetoshi NAGAI (nagai@ai.kyutech.ac.jp) -- cgit v1.2.3