← Back to branch summary

~ubuntu-branches/ubuntu/quantal/ruby1.9.1/quantal

« back to all changes in this revision

Viewing changes to ext/tk/README.tcltklib

  • Committer: Bazaar Package Importer
  • Author(s): Lucas Nussbaum
  • Date: 2011-09-24 19:16:17 UTC
  • mfrom: (1.1.8 upstream) (13.1.7 experimental)
  • Revision ID: james.westby@ubuntu.com-20110924191617-o1qz4rcmqjot8zuy
Tags: 1.9.3~rc1-1
http://bugs.debian.org/639959
* New upstream release: 1.9.3 RC1.
  + Includes load.c fixes. Closes: #639959.
* Upload to unstable.

Show diffs side-by-side

added added

removed removed

Lines of Context:
ext/tk/README.tcltklib
1
 
To compile 'tcltklib', you must have Tcl/Tk libraries on your environment. 
 
1
To compile 'tcltklib', you must have Tcl/Tk libraries on your environment.
2
2
Although 'extconf.rb' script searches Tcl/Tk libraries and header files
3
3
(as default, searches tclConfig.sh/tkConfig.sh and use the defintions on
4
4
those; ActiveTcl has high priority on searching unless --without-ActiveTcl),
5
 
sometimes fails to find them. And then, 'tcltklib' cannot be compiled. If 
6
 
Tcl/Tk libraries or header files are installed but are not found, you can 
7
 
give the information by arguments of the 'configure' script. Please give 
8
 
some or all of the following options. 
 
5
sometimes fails to find them. And then, 'tcltklib' cannot be compiled. If
 
6
Tcl/Tk libraries or header files are installed but are not found, you can
 
7
give the information by arguments of the 'configure' script. Please give
 
8
some or all of the following options.
9
9
 
10
10
 --with-tk-old-extconf         use old "extconf.rb" (default: false).
11
11
                               If current extconf.rb doesn't work properly
12
 
                               (or your install process is based on old 
 
12
                               (or your install process is based on old
13
13
                               documant about Ruby/Tk install), please try
14
14
                               this option.
15
15
 
16
16
 --with-ActiveTcl / --without-ActiveTcl
17
17
 --with-ActiveTcl=<dir>        search ActiveTcl libraries (default: true).
18
 
                               When true, try to find installed ActiveTcl. 
 
18
                               When true, try to find installed ActiveTcl.
19
19
                               When <dir> is given, use it as the ActiveTcl's
20
20
                               top directory (use <dir>/lib, and so on).
21
21
                               Old "extconf.rb" doesn't support this option.
22
22
 
23
23
 --with-tk-shlib-search-path=<paths>
24
 
                               teach the paths for loading shared-libraries 
 
24
                               teach the paths for loading shared-libraries
25
25
                               to linker.
26
 
                               <paths> is a path list with the same format 
 
26
                               <paths> is a path list with the same format
27
27
                               as PATH environment variable.
28
28
                               This option may be experimental.
29
29
                               Old "extconf.rb" doesn't support this option.
30
30
 
31
 
 --with-tcltkversion=<version> 
 
31
 --with-tcltkversion=<version>
 
32
 --with-tcltkversion=<tclversion>,<tkversion>
32
33
      force version of Tcl/Tk libaray
33
 
      (e.g. libtcl8.4g.so ==> --with-tcltkversion=8.4g)
34
 
 
35
 
 --without-tcl-config / --without-tk-config
36
 
 --with-tclConfig-dir=<dir>       
37
 
 --with-tkConfig-dir=<dir>     the directory contains 'tclConfig.sh' and 
38
 
                               'tkConfig.sh'. 
39
 
                               Current "extconf.rb" uses the information 
 
34
      (e.g. libtcl8.4g.so & libtk8.4g.so ==> --with-tcltkversion=8.4g
 
35
            libtcl8.4.so  & libtk8.4g.so ==> --with-tcltkversion=8.4,8.4g)
 
36
 
 
37
 --enable-tcl-h-ver-check/--disable-tcl-h-ver-check
 
38
 --enable-tk-h-ver-check/--disable-tk-h-ver-check
 
39
                               enable or disable for checking MAJOR_VERSION and
 
40
                               MINOR_VERSION on tcl.h/tk.h whether match with
 
41
                               Tcl/Tk libraries' version or not.
 
42
 
 
43
 --with-tcl-build-dir=<dir>
 
44
 --with-tk-build-dir=<dir>     If you want to compile with libraries on Tcl/Tk
 
45
                               build dir (still NOT installed), you must use
 
46
                               these options.
 
47
                               (e.g. --with-tcl-build-dir=./build/tcl8.5.9/unix)
 
48
                               When use these options, --with-tclConfig-dir and
 
49
                               --with-tkConfig-dir options are ignored (however,
 
50
                               --with-tclConfig-file and --with-tkConfig-file
 
51
                               options are still available).
 
52
 
 
53
 --with-tclConfig-file=<file>/--without-tclConfig-file
 
54
 --with-tkConfig-file=<file>/--without-tkConfig-file
 
55
                               file path of tclConfig.sh/tkConfig.sh, or don't 
 
56
                               refer those.
 
57
                               If you want use non-standard filenames of config
 
58
                               files (e.g. tclConfig-static.sh), you must use
 
59
                               these options.
 
60
 
 
61
 --with-tclConfig-dir=<dir>
 
62
 --with-tkConfig-dir=<dir>     the directory contains 'tclConfig.sh' and
 
63
                               'tkConfig.sh'.
 
64
                               Current "extconf.rb" uses the information
40
65
                               on tclConfig.sh/tkConfig.rb, if possible.
41
66
                               Old "extconf.rb" doesn't support this option.
42
67
 
45
70
 
46
71
 --enable-tcltk-stubs          (if you force to enable stubs)
47
72
                               On old "extconf.rb", default is false.
48
 
                               On current "extconf.rb", default is true when 
 
73
                               On current "extconf.rb", default is true when
49
74
                               tclConfig.sh/tkConfig.sh have TCL_STUB_LIB_SPEC
50
75
                               /TK_STUB_LIB_SPEC, else default is false.
51
76
 
52
 
 --with-tcl-dir=<path> 
 
77
 --with-tcl-dir=<path>
53
78
      equal to "--with-tcl-include=<path>/include --with-tcl-lib=<path>/lib"
54
79
 
55
 
 --with-tk-dir=<path> 
 
80
 --with-tk-dir=<path>
56
81
      equal to "--with-tk-include=<path>/include --with-tk-lib=<path>/lib"
57
82
 
58
83
 --with-tcl-include=<dir>      the directry contains 'tcl.h'
66
91
 
67
92
 --enable-tcltk-framework      use Tcl/Tk framework
68
93
 
69
 
 --with-tcltk-framework=<dir>  the directory contains Tcl/Tk framework; 
 
94
 --with-tcltk-framework=<dir>  the directory contains Tcl/Tk framework;
70
95
                               "<dir>/Tcl.framework" and "<dir>/Tk.framework".
71
 
                               When this option is given, it is assumed that 
 
96
                               When this option is given, it is assumed that
72
97
                               --enable-tcltk-framework option is given also.
73
98
 
74
99
 --with-tcl-framework-dir=<dir>
78
103
      Tk framework directory (e.g. "/Library/Frameworks/Tk.framework")
79
104
 
80
105
 --with-tcl-framework-header=<dir>
81
 
      Tcl framework headers directory 
 
106
      Tcl framework headers directory
82
107
      (e.g. "/Library/Frameworks/Tcl.framework/Headers")
83
108
 
84
109
 --with-tk-framework-header=<dir>
85
 
      Tk framework headers directory 
 
110
      Tk framework headers directory
86
111
      (e.g. "/Library/Frameworks/Tk.framework/Headers")
87
112
 
88
113
 
89
114
 --with-X11 / --without-X11    use / not use the X Window System
90
115
 
91
 
 --with-X11-dir=<path> 
 
116
 --with-X11-dir=<path>
92
117
      equal to "--with-X11-include=<path>/include --with-X11-lib=<path>/lib"
93
118
 
94
119
 --with-X11-include=<dir>      the directry contais X11 header files
104
129
 
105
130
 
106
131
 *** ATTENTION ***
107
 
When your Tcl/Tk libraries are compiled with "pthread support", 
108
 
Ruby/Tk may cause "Hang-up" or "Segmentation Fault" frequently. 
109
 
If you have such a trouble, please try to use the '--enable-pthread' 
110
 
option of the 'configure' command and re-compile Ruby sources. 
111
 
It may help you to avoid this trouble. The following configure 
 
132
When your Tcl/Tk libraries are compiled with "pthread support",
 
133
Ruby/Tk may cause "Hang-up" or "Segmentation Fault" frequently.
 
134
If you have such a trouble, please try to use the '--enable-pthread'
 
135
option of the 'configure' command and re-compile Ruby sources.
 
136
It may help you to avoid this trouble. The following configure
112
137
options may be useful.
113
138
 
114
139
  --enable-tcl-thread/--disable-tcl-thread
115
140
  --with-tclConfig-file=<path of 'tclConfig.sh'>
116
141
  --with-tkConfig-file=<path of 'tkConfig.sh'>
117
142
 
118
 
It is not need that 'tclConfig.sh' is a normal Tcl/Tk's tclConfig.sh. 
 
143
It is not need that 'tclConfig.sh' is a normal Tcl/Tk's tclConfig.sh.
119
144
But the file is expected to include the line "TCL_THREADS=0" or "...=1".
120
 
When no "TCL_THREADS=?" line, if Tcl version is 7.x or 8.0 which is 
121
 
given by "TCL_MAJOR_VERSION=?" line and "TCL_MINOR_VERSION=?" line, 
 
145
When no "TCL_THREADS=?" line, if Tcl version is 7.x or 8.0 which is
 
146
given by "TCL_MAJOR_VERSION=?" line and "TCL_MINOR_VERSION=?" line,
122
147
then --disable-tcl-thread is expected. Else, ignore the 'tclConfig.sh'.
123
 
If --enable-tcl-thread or --disable-tcl-thread option is given, then 
124
 
--with-tclConfig-file option is ignored. 
 
148
If --enable-tcl-thread or --disable-tcl-thread option is given, then
 
149
--with-tclConfig-file option is ignored.
125
150
 
126
151
==========================================================
127
152
                Hidetoshi NAGAI (nagai@ai.kyutech.ac.jp)