ruby--ruby/ext/tk
nagai 4f8df7dcc4 * ext/tk/lib/tk.rb (TkWindow.initialize): accept 'without_creating'
option without 'widgetname' option to allow creating a widget object
  which is used as an argument of Tcl/Tk's widget allocation commands.
* ext/tk/lib/tk/image.rb (TkImage.initialize): accept 'imagename'
  option to create a image object by the given name.


git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@8237 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2005-04-01 17:22:02 +00:00
..
lib * ext/tk/lib/tk.rb (TkWindow.initialize): accept 'without_creating' 2005-04-01 17:22:02 +00:00
sample * ext/tk/lib/tk.rb (TkWindow.initialize): accept 'without_creating' 2005-04-01 17:22:02 +00:00
tkutil * ext/tk/tkutil/tkutil.c (ary2list): give wrong arguments to hash2kv() 2005-03-15 07:41:09 +00:00
.cvsignore * ext/tk: merge tcltklib for Ruby/Tk installation control 2005-01-25 14:31:45 +00:00
ChangeLog.tkextlib * ext/tk/lib/tk.rb (TkWindow.initialize): accept 'without_creating' 2005-04-01 17:22:02 +00:00
MANUAL_tcltklib.eng * ext/tk/tcltklib.c: enforce thread-check and exception-handling to 2005-03-02 07:06:52 +00:00
MANUAL_tcltklib.eucj * ext/tk/tcltklib.c: enforce thread-check and exception-handling to 2005-03-02 07:06:52 +00:00
README.1st * ext/tk: merge tcltklib for Ruby/Tk installation control 2005-01-25 14:31:45 +00:00
README.ActiveTcl * ext/tk: merge tcltklib for Ruby/Tk installation control 2005-01-25 14:31:45 +00:00
README.fork * ext/tk/lib/tk.rb: add Tk.appsend_deny and improve Tk.rb_appsend 2004-05-21 20:45:27 +00:00
README.tcltklib * ext/tk: merge tcltklib for Ruby/Tk installation control 2005-01-25 14:31:45 +00:00
depend * ext/tk/extconf.rb: add tkutil configuration step (remove old schema) 2005-01-31 04:17:23 +00:00
extconf.rb * ext/extmk.rb (extract_makefile): extract previously collected 2005-02-06 14:51:44 +00:00
old-README.tcltklib.eucj * ext/tk: merge tcltklib for Ruby/Tk installation control 2005-01-25 14:31:45 +00:00
stubs.c * ext/tk: merge tcltklib for Ruby/Tk installation control 2005-01-25 14:31:45 +00:00
tcltklib.c * ext/tk/tcltklib.c: add TclTkIp#_create_console() method to create 2005-03-30 08:44:19 +00:00

README.tcltklib

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-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 containts 'tcl.h'
 --with-tk-include=<dir>       the directry containts 'tk.h'

 --with-tcl-lib=<dir>          the directry containts 'libtcl<version>.so'
 --with-tk-lib=<dir>           the directry containts 'libtk<version>.so'

 --enable-mac-tcltk-framework  (Mac OSX only) use Tcl/Tk framework

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)