2011-05-22 05:26:02 -04:00
|
|
|
To compile 'tcltklib', you must have Tcl/Tk libraries on your environment.
|
2009-07-12 19:08:32 -04:00
|
|
|
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),
|
2011-05-22 05:26:02 -04:00
|
|
|
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.
|
2003-10-17 03:59:32 -04:00
|
|
|
|
2009-07-12 19:08:32 -04:00
|
|
|
--with-tk-old-extconf use old "extconf.rb" (default: false).
|
|
|
|
If current extconf.rb doesn't work properly
|
2011-05-22 05:26:02 -04:00
|
|
|
(or your install process is based on old
|
2009-07-12 19:08:32 -04:00
|
|
|
documant about Ruby/Tk install), please try
|
|
|
|
this option.
|
|
|
|
|
|
|
|
--with-ActiveTcl / --without-ActiveTcl
|
|
|
|
--with-ActiveTcl=<dir> search ActiveTcl libraries (default: true).
|
2011-05-22 05:26:02 -04:00
|
|
|
When true, try to find installed ActiveTcl.
|
2009-07-12 19:08:32 -04:00
|
|
|
When <dir> is given, use it as the ActiveTcl's
|
|
|
|
top directory (use <dir>/lib, and so on).
|
|
|
|
Old "extconf.rb" doesn't support this option.
|
|
|
|
|
|
|
|
--with-tk-shlib-search-path=<paths>
|
2011-05-22 05:26:02 -04:00
|
|
|
teach the paths for loading shared-libraries
|
2009-07-12 19:08:32 -04:00
|
|
|
to linker.
|
2011-05-22 05:26:02 -04:00
|
|
|
<paths> is a path list with the same format
|
2009-07-12 19:08:32 -04:00
|
|
|
as PATH environment variable.
|
|
|
|
This option may be experimental.
|
|
|
|
Old "extconf.rb" doesn't support this option.
|
|
|
|
|
2011-05-22 05:26:02 -04:00
|
|
|
--with-tcltkversion=<version>
|
2011-05-23 18:37:44 -04:00
|
|
|
--with-tcltkversion=<tclversion>,<tkversion>
|
2014-02-11 03:02:01 -05:00
|
|
|
force version of Tcl/Tk library
|
2011-05-23 18:37:44 -04:00
|
|
|
(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=<dir>
|
|
|
|
--with-tk-build-dir=<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=<file>/--without-tclConfig-file
|
|
|
|
--with-tkConfig-file=<file>/--without-tkConfig-file
|
2013-05-18 23:11:09 -04:00
|
|
|
file path of tclConfig.sh/tkConfig.sh, or don't
|
2011-05-23 18:37:44 -04:00
|
|
|
refer those.
|
|
|
|
If you want use non-standard filenames of config
|
|
|
|
files (e.g. tclConfig-static.sh), you must use
|
|
|
|
these options.
|
* ext/tk/tcltklib.c: SEGV when tcltk-stubs is enabled.
* ext/tk/tcltklib.c: avoid error on a shared object.
* ext/tk/extconf.rb: support --with-tcltkversion
* ext/tk/README.tcltklib: add document about --with-tcltkversion
* ext/tk/lib/tk.rb, ext/tk/lib/multi-tk.rb, ext/tk/lib/remote-tk.rb:
not work on $SAFE==4
* ext/tk/lib/multi-tk.rb: Object#methods returns Symbols on Ruby1.9.
* ext/tk/lib/tk/timer.rb: add TkTimer#at_end(proc) to register the
procedure which called at end of the timer.
* ext/tk/lib/tk.rb, ext/tk/lib/tk/itemfont.rb, ext/tk/lib/font.rb:
support __IGNORE_UNKNOWN_CONFIGURE_OPTION__ about font options.
* ext/tk/lib/*: treat __IGNORE_UNKNOWN_CONFIGURE_OPTION__
* ext/tk/lib/tkextlib/iwidgets/scrolledcanvas.rb,
ext/tk/lib/tkextlib/iwidgets/scrolledlistbox.rb,
ext/tk/lib/tkextlib/iwidgets/scrolledtext.rb: bug fix.
* ext/tk/lib/tk/text.rb: typo. call a wrong method.
* ext/tk/lib/tk/itemconfig.rb: ditto.
* ext/tk/lib/tk.rb, ext/tk/lib/tk/itemconfig.rb,
ext/tk/lib/tk/canvas.rb: support alias names of option keys.
* ext/tk/lib/tk/grid.rb: lack of module-method definitions.
* ext/tk/lib/tk/pack.rb, ext/tk/lib/tk/grid.rb: increase supported
parameter patterns of configure method.
* ext/tk/lib/tk.rb: add TkWindow#grid_anchor, grid_column, grid_row.
* ext/tk/lib/tk/wm.rb: methods of Tk::Wm_for_General module cannot
pass the given block to methods of Tk::Wm module.
* ext/tk/lib/tk/wm.rb: Wm#overrideredirect overwrites arguemnt to
an invalid value.
* ext/tk/lib/tk.rb: fix memory (object) leak bug.
* ext/tk/tcltklib.c, ext/tk/tkutil/tkutil.c: fix memory leak.
* ext/tk/sample/demos-jp/aniwave.rb, ext/tk/sample/demos-en/aniwave.rb:
bug fix.
* ext/tk/lib/tkextlib/blt/component.rb,
ext/tk/lib/tkextlib/tile/tentry.rb,
ext/tk/lib/tkextlib/tile/treeview.rb: ditto.
* ext/tk/lib/tkextlib/tile/tpaned.rb: improve TPaned#add.
* ext/tk/sample/demos-jp/widget, ext/tk/sample/demos-en/widget,
ext/tk/sample/demos-jp/style.rb, ext/tk/sample/demos-en/style.rb,
ext/tk/sample/demos-jp/bind.rb, ext/tk/sample/demos-en/bind.rb:
bug fix.
* ext/tk/sample/ttk_wrapper.rb: ditto.
* ext/tk/sample/ttk_wrapper.rb: support "if __FILE__ == $0" idiom.
* ext/tk/sample/tktextio.rb: add binding for 'Ctrl-u' at console mode.
* ext/tk/lib/tkextlib/tile.rb, ext/tk/lib/tkextlib/tile/style.rb,
ext/tk/sample/ttk_wrapper.rb: improve treating and control themes.
add Tk::Tile.themes and Tk::Tile.set_theme(theme).
* ext/tk/lib/tkextlib/tile.rb: lack of autoload definitions.
* ext/tk/lib/tkextlib/tile/tnotebook.rb: cannot use kanji (not UTF-8)
characters for headings.
* ext/tk/lib/tkextlib/tkDND/shape.rb: wrong package name.
* ext/tk/tkutil/tkutil.c: improve handling callback-subst-keys.
Now, support longnam-keys (e.g. '%CTT' on tkdnd-2.0; however, still
not support tkdnd-2.0 on tkextlib), and symbols of parameters (e.g.
:widget=>'%W', :keycode=>'%k', '%x'=>:x, '%X'=>:root_x, and so on;
those are attributes of event object). It means that Ruby/Tk accepts
not only "widget.bind(ev, '%W', '%k', ...){|w, k, ...| ... }", but
also "widget.bind(ev, :widget, :keycode, ...){|w, k, ...| ... }".
It is potentially incompatible, when user passes symbols to the
arguments of the callback block (the block receives the symbols as
strings). I think that is very rare case (probably, used by Ruby/Tk
experts only). When causes such trouble, please give strings instead
of such symbol parameters (e.g. call Symbol#to_s method).
* ext/tk/lib/tk/event.rb, ext/tk/lib/tk/validation.rb,
ext/tk/lib/tkextlib/blt/treeview.rb,
ext/tk/lib/tkextlib/winico/winico.rb: ditto.
* ext/tk/tkutil/tkutil.c: strings are available on subst_tables on
TkUtil::CallbackSubst class (it is useful on Ruby 1.9).
* ext/tk/lib/tk/spinbox.rb, ext/tk/lib/tkextlib/iwidgets/hierarchy.rb,
ext/tk/lib/tkextlib/iwidgets/spinner.rb,
ext/tk/lib/tkextlib/iwidgets/entryfield.rb,
ext/tk/lib/tkextlib/iwidgets/calendar.rb,
ext/tk/lib/tkextlib/blt/dragdrop.rb,
ext/tk/lib/tkextlib/tkDND/tkdnd.rb,
ext/tk/lib/tkextlib/treectrl/tktreectrl.rb,
ext/tk/lib/tkextlib/tktable/tktable.rb: disable code piece became
unnecessary by reason of the changes of ext/tk/tkutil/tkutil.c.
* ext/tk/lib/tk.rb, ext/tk/lib/multi-tk.rb: change strategy to define
the constant WITH_ENCODING.
* ext/tk/lib/tk.rb: fix bug on Tk::Encoding.tk_encoding_names.
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@17083 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2008-06-10 16:59:10 -04:00
|
|
|
|
2011-05-22 05:26:02 -04:00
|
|
|
--with-tclConfig-dir=<dir>
|
|
|
|
--with-tkConfig-dir=<dir> the directory contains 'tclConfig.sh' and
|
|
|
|
'tkConfig.sh'.
|
|
|
|
Current "extconf.rb" uses the information
|
2009-07-12 19:08:32 -04:00
|
|
|
on tclConfig.sh/tkConfig.rb, if possible.
|
|
|
|
Old "extconf.rb" doesn't support this option.
|
|
|
|
|
2004-09-02 13:17:20 -04:00
|
|
|
--with-tcllib=<libname> (e.g. libtcl8.4.so ==> --with-tcllib=tcl8.4)
|
|
|
|
--with-tklib=<libname> (e.g. libtk8.4.so ==> --with-tklib=tk8.4)
|
2003-10-17 03:59:32 -04:00
|
|
|
|
* ext/tk/tcltklib.c: SEGV when tcltk-stubs is enabled.
* ext/tk/tcltklib.c: avoid error on a shared object.
* ext/tk/extconf.rb: support --with-tcltkversion
* ext/tk/README.tcltklib: add document about --with-tcltkversion
* ext/tk/lib/tk.rb, ext/tk/lib/multi-tk.rb, ext/tk/lib/remote-tk.rb:
not work on $SAFE==4
* ext/tk/lib/multi-tk.rb: Object#methods returns Symbols on Ruby1.9.
* ext/tk/lib/tk/timer.rb: add TkTimer#at_end(proc) to register the
procedure which called at end of the timer.
* ext/tk/lib/tk.rb, ext/tk/lib/tk/itemfont.rb, ext/tk/lib/font.rb:
support __IGNORE_UNKNOWN_CONFIGURE_OPTION__ about font options.
* ext/tk/lib/*: treat __IGNORE_UNKNOWN_CONFIGURE_OPTION__
* ext/tk/lib/tkextlib/iwidgets/scrolledcanvas.rb,
ext/tk/lib/tkextlib/iwidgets/scrolledlistbox.rb,
ext/tk/lib/tkextlib/iwidgets/scrolledtext.rb: bug fix.
* ext/tk/lib/tk/text.rb: typo. call a wrong method.
* ext/tk/lib/tk/itemconfig.rb: ditto.
* ext/tk/lib/tk.rb, ext/tk/lib/tk/itemconfig.rb,
ext/tk/lib/tk/canvas.rb: support alias names of option keys.
* ext/tk/lib/tk/grid.rb: lack of module-method definitions.
* ext/tk/lib/tk/pack.rb, ext/tk/lib/tk/grid.rb: increase supported
parameter patterns of configure method.
* ext/tk/lib/tk.rb: add TkWindow#grid_anchor, grid_column, grid_row.
* ext/tk/lib/tk/wm.rb: methods of Tk::Wm_for_General module cannot
pass the given block to methods of Tk::Wm module.
* ext/tk/lib/tk/wm.rb: Wm#overrideredirect overwrites arguemnt to
an invalid value.
* ext/tk/lib/tk.rb: fix memory (object) leak bug.
* ext/tk/tcltklib.c, ext/tk/tkutil/tkutil.c: fix memory leak.
* ext/tk/sample/demos-jp/aniwave.rb, ext/tk/sample/demos-en/aniwave.rb:
bug fix.
* ext/tk/lib/tkextlib/blt/component.rb,
ext/tk/lib/tkextlib/tile/tentry.rb,
ext/tk/lib/tkextlib/tile/treeview.rb: ditto.
* ext/tk/lib/tkextlib/tile/tpaned.rb: improve TPaned#add.
* ext/tk/sample/demos-jp/widget, ext/tk/sample/demos-en/widget,
ext/tk/sample/demos-jp/style.rb, ext/tk/sample/demos-en/style.rb,
ext/tk/sample/demos-jp/bind.rb, ext/tk/sample/demos-en/bind.rb:
bug fix.
* ext/tk/sample/ttk_wrapper.rb: ditto.
* ext/tk/sample/ttk_wrapper.rb: support "if __FILE__ == $0" idiom.
* ext/tk/sample/tktextio.rb: add binding for 'Ctrl-u' at console mode.
* ext/tk/lib/tkextlib/tile.rb, ext/tk/lib/tkextlib/tile/style.rb,
ext/tk/sample/ttk_wrapper.rb: improve treating and control themes.
add Tk::Tile.themes and Tk::Tile.set_theme(theme).
* ext/tk/lib/tkextlib/tile.rb: lack of autoload definitions.
* ext/tk/lib/tkextlib/tile/tnotebook.rb: cannot use kanji (not UTF-8)
characters for headings.
* ext/tk/lib/tkextlib/tkDND/shape.rb: wrong package name.
* ext/tk/tkutil/tkutil.c: improve handling callback-subst-keys.
Now, support longnam-keys (e.g. '%CTT' on tkdnd-2.0; however, still
not support tkdnd-2.0 on tkextlib), and symbols of parameters (e.g.
:widget=>'%W', :keycode=>'%k', '%x'=>:x, '%X'=>:root_x, and so on;
those are attributes of event object). It means that Ruby/Tk accepts
not only "widget.bind(ev, '%W', '%k', ...){|w, k, ...| ... }", but
also "widget.bind(ev, :widget, :keycode, ...){|w, k, ...| ... }".
It is potentially incompatible, when user passes symbols to the
arguments of the callback block (the block receives the symbols as
strings). I think that is very rare case (probably, used by Ruby/Tk
experts only). When causes such trouble, please give strings instead
of such symbol parameters (e.g. call Symbol#to_s method).
* ext/tk/lib/tk/event.rb, ext/tk/lib/tk/validation.rb,
ext/tk/lib/tkextlib/blt/treeview.rb,
ext/tk/lib/tkextlib/winico/winico.rb: ditto.
* ext/tk/tkutil/tkutil.c: strings are available on subst_tables on
TkUtil::CallbackSubst class (it is useful on Ruby 1.9).
* ext/tk/lib/tk/spinbox.rb, ext/tk/lib/tkextlib/iwidgets/hierarchy.rb,
ext/tk/lib/tkextlib/iwidgets/spinner.rb,
ext/tk/lib/tkextlib/iwidgets/entryfield.rb,
ext/tk/lib/tkextlib/iwidgets/calendar.rb,
ext/tk/lib/tkextlib/blt/dragdrop.rb,
ext/tk/lib/tkextlib/tkDND/tkdnd.rb,
ext/tk/lib/tkextlib/treectrl/tktreectrl.rb,
ext/tk/lib/tkextlib/tktable/tktable.rb: disable code piece became
unnecessary by reason of the changes of ext/tk/tkutil/tkutil.c.
* ext/tk/lib/tk.rb, ext/tk/lib/multi-tk.rb: change strategy to define
the constant WITH_ENCODING.
* ext/tk/lib/tk.rb: fix bug on Tk::Encoding.tk_encoding_names.
git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@17083 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
2008-06-10 16:59:10 -04:00
|
|
|
--enable-tcltk-stubs (if you force to enable stubs)
|
2009-07-12 19:08:32 -04:00
|
|
|
On old "extconf.rb", default is false.
|
2011-05-22 05:26:02 -04:00
|
|
|
On current "extconf.rb", default is true when
|
2009-07-12 19:08:32 -04:00
|
|
|
tclConfig.sh/tkConfig.sh have TCL_STUB_LIB_SPEC
|
|
|
|
/TK_STUB_LIB_SPEC, else default is false.
|
2003-10-17 03:59:32 -04:00
|
|
|
|
2011-05-22 05:26:02 -04:00
|
|
|
--with-tcl-dir=<path>
|
2003-10-17 03:59:32 -04:00
|
|
|
equal to "--with-tcl-include=<path>/include --with-tcl-lib=<path>/lib"
|
|
|
|
|
2011-05-22 05:26:02 -04:00
|
|
|
--with-tk-dir=<path>
|
2003-10-17 03:59:32 -04:00
|
|
|
equal to "--with-tk-include=<path>/include --with-tk-lib=<path>/lib"
|
|
|
|
|
2013-05-18 23:10:21 -04:00
|
|
|
--with-tcl-include=<dir> the directory contains 'tcl.h'
|
|
|
|
--with-tk-include=<dir> the directory contains 'tk.h'
|
2003-10-17 03:59:32 -04:00
|
|
|
|
2013-05-18 23:10:21 -04:00
|
|
|
--with-tcl-lib=<dir> the directory contains 'libtcl<version>.so'
|
|
|
|
--with-tk-lib=<dir> the directory contains 'libtk<version>.so'
|
2004-09-02 13:17:20 -04:00
|
|
|
|
2005-05-23 03:27:08 -04:00
|
|
|
--enable-mac-tcltk-framework (MacOS X) use Tcl/Tk framework
|
|
|
|
(Obsolete. Please use '--enable-tcltk-framework'.)
|
|
|
|
|
|
|
|
--enable-tcltk-framework use Tcl/Tk framework
|
|
|
|
|
2011-05-22 05:26:02 -04:00
|
|
|
--with-tcltk-framework=<dir> the directory contains Tcl/Tk framework;
|
2005-05-23 03:27:08 -04:00
|
|
|
"<dir>/Tcl.framework" and "<dir>/Tk.framework".
|
2011-05-22 05:26:02 -04:00
|
|
|
When this option is given, it is assumed that
|
2005-05-23 03:27:08 -04:00
|
|
|
--enable-tcltk-framework option is given also.
|
|
|
|
|
2009-07-12 19:08:32 -04:00
|
|
|
--with-tcl-framework-dir=<dir>
|
|
|
|
Tcl framework directory (e.g. "/Library/Frameworks/Tcl.framework")
|
|
|
|
|
|
|
|
--with-tk-framework-dir=<dir>
|
|
|
|
Tk framework directory (e.g. "/Library/Frameworks/Tk.framework")
|
|
|
|
|
2005-05-23 03:27:08 -04:00
|
|
|
--with-tcl-framework-header=<dir>
|
2011-05-22 05:26:02 -04:00
|
|
|
Tcl framework headers directory
|
2005-05-23 03:27:08 -04:00
|
|
|
(e.g. "/Library/Frameworks/Tcl.framework/Headers")
|
|
|
|
|
|
|
|
--with-tk-framework-header=<dir>
|
2011-05-22 05:26:02 -04:00
|
|
|
Tk framework headers directory
|
2005-05-23 03:27:08 -04:00
|
|
|
(e.g. "/Library/Frameworks/Tk.framework/Headers")
|
|
|
|
|
2003-10-17 03:59:32 -04:00
|
|
|
|
2006-11-22 02:06:11 -05:00
|
|
|
--with-X11 / --without-X11 use / not use the X Window System
|
|
|
|
|
2011-05-22 05:26:02 -04:00
|
|
|
--with-X11-dir=<path>
|
2006-11-22 02:06:11 -05:00
|
|
|
equal to "--with-X11-include=<path>/include --with-X11-lib=<path>/lib"
|
|
|
|
|
2013-05-18 23:10:21 -04:00
|
|
|
--with-X11-include=<dir> the directory contais X11 header files
|
|
|
|
--with-X11-lib=<dir> the directory contais X11 libraries
|
2006-11-22 02:06:11 -05:00
|
|
|
|
|
|
|
|
2003-10-17 03:59:32 -04:00
|
|
|
If you forgot to give the options when do 'configure' on toplevel
|
2013-05-18 23:10:21 -04:00
|
|
|
directory of Ruby sources, please try something like as the followings.
|
2003-10-17 03:59:32 -04:00
|
|
|
|
|
|
|
$ cd ext/tcltklib
|
|
|
|
$ rm Makefile
|
2004-09-02 13:17:20 -04:00
|
|
|
$ CONFIGURE_ARGS='--with-tcl-include=/usr/local/include/tcl8.4/ --with-tcllib=tcl8.4 --with-tklib=tk8.4' ruby extconf.rb
|
2003-10-17 03:59:32 -04:00
|
|
|
|
2003-11-05 09:00:11 -05:00
|
|
|
|
|
|
|
*** ATTENTION ***
|
2011-05-22 05:26:02 -04:00
|
|
|
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
|
2004-05-24 04:33:45 -04:00
|
|
|
options may be useful.
|
|
|
|
|
|
|
|
--enable-tcl-thread/--disable-tcl-thread
|
|
|
|
--with-tclConfig-file=<path of 'tclConfig.sh'>
|
2009-07-27 15:40:43 -04:00
|
|
|
--with-tkConfig-file=<path of 'tkConfig.sh'>
|
2004-05-24 04:33:45 -04:00
|
|
|
|
2011-05-22 05:26:02 -04:00
|
|
|
It is not need that 'tclConfig.sh' is a normal Tcl/Tk's tclConfig.sh.
|
2004-05-24 04:33:45 -04:00
|
|
|
But the file is expected to include the line "TCL_THREADS=0" or "...=1".
|
2011-05-22 05:26:02 -04:00
|
|
|
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,
|
2004-05-24 04:33:45 -04:00
|
|
|
then --disable-tcl-thread is expected. Else, ignore the 'tclConfig.sh'.
|
2011-05-22 05:26:02 -04:00
|
|
|
If --enable-tcl-thread or --disable-tcl-thread option is given, then
|
|
|
|
--with-tclConfig-file option is ignored.
|
2003-11-05 09:00:11 -05:00
|
|
|
|
2003-10-17 03:59:32 -04:00
|
|
|
==========================================================
|
|
|
|
Hidetoshi NAGAI (nagai@ai.kyutech.ac.jp)
|