diff options
author | yugui <yugui@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2008-08-25 15:02:05 +0000 |
---|---|---|
committer | yugui <yugui@b2dd03c8-39d4-4d8f-98ff-823fe69b080e> | 2008-08-25 15:02:05 +0000 |
commit | 0dc342de848a642ecce8db697b8fecd83a63e117 (patch) | |
tree | 2b7ed4724aff1f86073e4740134bda9c4aac1a39 /trunk/ext/tk/README.tcltklib | |
parent | ef70cf7138ab8034b5b806f466e4b484b24f0f88 (diff) |
added tag v1_9_0_4
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/tags/v1_9_0_4@18845 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
Diffstat (limited to 'trunk/ext/tk/README.tcltklib')
-rw-r--r-- | trunk/ext/tk/README.tcltklib | 85 |
1 files changed, 85 insertions, 0 deletions
diff --git a/trunk/ext/tk/README.tcltklib b/trunk/ext/tk/README.tcltklib new file mode 100644 index 0000000000..8c6dd5178f --- /dev/null +++ b/trunk/ext/tk/README.tcltklib @@ -0,0 +1,85 @@ +To compile 'tcltklib', you must have Tcl/Tk libraries on your environment. +Although 'extconf.rb' script searches Tcl/Tk libraries and header files, +sometimes fails to find them. And then, 'tcltklib' cannot be compiled. If +Tcl/Tk libraries or header files are installed but are not found, you can +give the information by arguments of the 'configure' script. Please give +some or all of the following options. + + --with-tcltkversion=<version> + force version of Tcl/Tk libaray + (e.g. libtcl8.4g.so ==> --with-tcltkversion=8.4g) + + --with-tcllib=<libname> (e.g. libtcl8.4.so ==> --with-tcllib=tcl8.4) + --with-tklib=<libname> (e.g. libtk8.4.so ==> --with-tklib=tk8.4) + + --enable-tcltk-stubs (if you force to enable stubs) + + --with-tcl-dir=<path> + equal to "--with-tcl-include=<path>/include --with-tcl-lib=<path>/lib" + + --with-tk-dir=<path> + equal to "--with-tk-include=<path>/include --with-tk-lib=<path>/lib" + + --with-tcl-include=<dir> the directry contains 'tcl.h' + --with-tk-include=<dir> the directry contains 'tk.h' + + --with-tcl-lib=<dir> the directry contains 'libtcl<version>.so' + --with-tk-lib=<dir> the directry contains 'libtk<version>.so' + + --enable-mac-tcltk-framework (MacOS X) use Tcl/Tk framework + (Obsolete. Please use '--enable-tcltk-framework'.) + + --enable-tcltk-framework use Tcl/Tk framework + + --with-tcltk-framework=<dir> the directory contains Tcl/Tk framework; + "<dir>/Tcl.framework" and "<dir>/Tk.framework". + When this option is given, it is assumed that + --enable-tcltk-framework option is given also. + + --with-tcl-framework-header=<dir> + Tcl framework headers directory + (e.g. "/Library/Frameworks/Tcl.framework/Headers") + + --with-tk-framework-header=<dir> + Tk framework headers directory + (e.g. "/Library/Frameworks/Tk.framework/Headers") + + + --with-X11 / --without-X11 use / not use the X Window System + + --with-X11-dir=<path> + equal to "--with-X11-include=<path>/include --with-X11-lib=<path>/lib" + + --with-X11-include=<dir> the directry contais X11 header files + --with-X11-lib=<dir> the directry contais X11 libraries + + +If you forgot to give the options when do 'configure' on toplevel +directry of Ruby sources, please try something like as the followings. + + $ cd ext/tcltklib + $ rm Makefile + $ CONFIGURE_ARGS='--with-tcl-include=/usr/local/include/tcl8.4/ --with-tcllib=tcl8.4 --with-tklib=tk8.4' ruby extconf.rb + + + *** ATTENTION *** +When your Tcl/Tk libraries are compiled with "pthread support", +Ruby/Tk may cause "Hang-up" or "Segmentation Fault" frequently. +If you have such a trouble, please try to use the '--enable-pthread' +option of the 'configure' command and re-compile Ruby sources. +It may help you to avoid this trouble. The following configure +options may be useful. + + --enable-tcl-thread/--disable-tcl-thread + --with-tclConfig-file=<path of 'tclConfig.sh'> + +It is not need that 'tclConfig.sh' is a normal Tcl/Tk's tclConfig.sh. +But the file is expected to include the line "TCL_THREADS=0" or "...=1". +When no "TCL_THREADS=?" line, if Tcl version is 7.x or 8.0 which is +given by "TCL_MAJOR_VERSION=?" line and "TCL_MINOR_VERSION=?" line, +then --disable-tcl-thread is expected. Else, ignore the 'tclConfig.sh'. +If --enable-tcl-thread or --disable-tcl-thread option is given, then +--with-tclConfig-file option is ignored. + +========================================================== + Hidetoshi NAGAI (nagai@ai.kyutech.ac.jp) |