From fcbf63e62c627deae76c1b8cb8c0876c536ed811 Mon Sep 17 00:00:00 2001 From: Jari Vetoniemi Date: Mon, 16 Mar 2020 18:49:26 +0900 Subject: Fresh start --- jni/ruby/ext/tk/README.tcltklib | 152 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 152 insertions(+) create mode 100644 jni/ruby/ext/tk/README.tcltklib (limited to 'jni/ruby/ext/tk/README.tcltklib') diff --git a/jni/ruby/ext/tk/README.tcltklib b/jni/ruby/ext/tk/README.tcltklib new file mode 100644 index 0000000..da343a4 --- /dev/null +++ b/jni/ruby/ext/tk/README.tcltklib @@ -0,0 +1,152 @@ +To compile 'tcltklib', you must have Tcl/Tk libraries on your environment. +Although 'extconf.rb' script searches Tcl/Tk libraries and header files +(as default, searches tclConfig.sh/tkConfig.sh and use the defintions on +those; ActiveTcl has high priority on searching unless --without-ActiveTcl), +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-tk-old-extconf use old "extconf.rb" (default: false). + If current extconf.rb doesn't work properly + (or your install process is based on old + documant about Ruby/Tk install), please try + this option. + + --with-ActiveTcl / --without-ActiveTcl + --with-ActiveTcl= search ActiveTcl libraries (default: true). + When true, try to find installed ActiveTcl. + When is given, use it as the ActiveTcl's + top directory (use /lib, and so on). + Old "extconf.rb" doesn't support this option. + + --with-tk-shlib-search-path= + teach the paths for loading shared-libraries + to linker. + is a path list with the same format + as PATH environment variable. + This option may be experimental. + Old "extconf.rb" doesn't support this option. + + --with-tcltkversion= + --with-tcltkversion=, + force version of Tcl/Tk library + (e.g. libtcl8.4g.so & libtk8.4g.so ==> --with-tcltkversion=8.4g + libtcl8.4.so & libtk8.4g.so ==> --with-tcltkversion=8.4,8.4g) + + --enable-tcl-h-ver-check/--disable-tcl-h-ver-check + --enable-tk-h-ver-check/--disable-tk-h-ver-check + enable or disable for checking MAJOR_VERSION and + MINOR_VERSION on tcl.h/tk.h whether match with + Tcl/Tk libraries' version or not. + + --with-tcl-build-dir= + --with-tk-build-dir= If you want to compile with libraries on Tcl/Tk + build dir (still NOT installed), you must use + these options. + (e.g. --with-tcl-build-dir=./build/tcl8.5.9/unix) + When use these options, --with-tclConfig-dir and + --with-tkConfig-dir options are ignored (however, + --with-tclConfig-file and --with-tkConfig-file + options are still available). + + --with-tclConfig-file=/--without-tclConfig-file + --with-tkConfig-file=/--without-tkConfig-file + file path of tclConfig.sh/tkConfig.sh, or don't + refer those. + If you want use non-standard filenames of config + files (e.g. tclConfig-static.sh), you must use + these options. + + --with-tclConfig-dir= + --with-tkConfig-dir= the directory contains 'tclConfig.sh' and + 'tkConfig.sh'. + Current "extconf.rb" uses the information + on tclConfig.sh/tkConfig.rb, if possible. + Old "extconf.rb" doesn't support this option. + + --with-tcllib= (e.g. libtcl8.4.so ==> --with-tcllib=tcl8.4) + --with-tklib= (e.g. libtk8.4.so ==> --with-tklib=tk8.4) + + --enable-tcltk-stubs (if you force to enable stubs) + On old "extconf.rb", default is false. + On current "extconf.rb", default is true when + tclConfig.sh/tkConfig.sh have TCL_STUB_LIB_SPEC + /TK_STUB_LIB_SPEC, else default is false. + + --with-tcl-dir= + equal to "--with-tcl-include=/include --with-tcl-lib=/lib" + + --with-tk-dir= + equal to "--with-tk-include=/include --with-tk-lib=/lib" + + --with-tcl-include= the directory contains 'tcl.h' + --with-tk-include= the directory contains 'tk.h' + + --with-tcl-lib= the directory contains 'libtcl.so' + --with-tk-lib= the directory contains 'libtk.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= the directory contains Tcl/Tk framework; + "/Tcl.framework" and "/Tk.framework". + When this option is given, it is assumed that + --enable-tcltk-framework option is given also. + + --with-tcl-framework-dir= + Tcl framework directory (e.g. "/Library/Frameworks/Tcl.framework") + + --with-tk-framework-dir= + Tk framework directory (e.g. "/Library/Frameworks/Tk.framework") + + --with-tcl-framework-header= + Tcl framework headers directory + (e.g. "/Library/Frameworks/Tcl.framework/Headers") + + --with-tk-framework-header= + 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= + equal to "--with-X11-include=/include --with-X11-lib=/lib" + + --with-X11-include= the directory contais X11 header files + --with-X11-lib= the directory contais X11 libraries + + +If you forgot to give the options when do 'configure' on toplevel +directory 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= + --with-tkConfig-file= + +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) -- cgit v1.2.3