source: general/prog/tk.xml@ bc38b45

10.1 11.0 ken/refactor-virt lazarus qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since bc38b45 was bc38b45, checked in by Pierre Labastie <pieere@…>, 11 months ago

tk-8.6.11.1
mesa-20.3.3
gptfdisk-1.0.6
cmake-3.19.3
Mako-1.1.4 (python module)
elogind-249.6.2

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@24115 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 7.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY tk-download-http "&sourceforge-dl;/tcl/tk&tk-version;-src.tar.gz">
8 <!ENTITY tk-download-ftp " ">
9 <!ENTITY tk-md5sum "964d69b6307f86bb7e51f7c189666880">
10 <!ENTITY tk-size "4.3 MB">
11 <!ENTITY tk-buildsize "31 MB">
12 <!ENTITY tk-time "0.3 SBU (add 2.0 SBU for tests)">
13
14 <!-- Ensure this is updated when Tk moves from the 8.6.x branch -->
15 <!ENTITY tk-ver "8.6">
16]>
17
18<sect1 id="tk" xreflabel="Tk-&tk-version;">
19 <?dbhtml filename="tk.html"?>
20
21 <sect1info>
22 <othername>$LastChangedBy$</othername>
23 <date>$Date$</date>
24 </sect1info>
25
26 <title>Tk-&tk-version;</title>
27
28 <indexterm zone="tk">
29 <primary sortas="a-Tk">Tk</primary>
30 </indexterm>
31
32 <sect2 role="package">
33 <title>Introduction to Tk</title>
34
35 <para>
36 The <application>Tk</application> package contains a
37 TCL GUI Toolkit.
38 </para>
39
40 &lfs10_checked;
41
42 <bridgehead renderas="sect3">Package Information</bridgehead>
43 <itemizedlist spacing="compact">
44 <listitem>
45 <para>
46 Download (HTTP): <ulink url="&tk-download-http;"/>
47 </para>
48 </listitem>
49 <listitem>
50 <para>
51 Download (FTP): <ulink url="&tk-download-ftp;"/>
52 </para>
53 </listitem>
54 <listitem>
55 <para>
56 Download MD5 sum: &tk-md5sum;
57 </para>
58 </listitem>
59 <listitem>
60 <para>
61 Download size: &tk-size;
62 </para>
63 </listitem>
64 <listitem>
65 <para>
66 Estimated disk space required: &tk-buildsize;
67 </para>
68 </listitem>
69 <listitem>
70 <para>
71 Estimated build time: &tk-time;
72 </para>
73 </listitem>
74 </itemizedlist>
75
76 <bridgehead renderas="sect3">Tk Dependencies</bridgehead>
77
78 <bridgehead renderas="sect4">Required</bridgehead>
79 <para role="required">
80 <!-- <xref linkend="tcl"/> and -->
81 <xref linkend="xorg7-lib"/>
82 </para>
83
84 <para condition="html" role="usernotes">User Notes:
85 <ulink url="&blfs-wiki;/tk"/>
86 </para>
87 </sect2>
88
89 <sect2 role="installation">
90 <title>Installation of Tk</title>
91
92 <para>
93 Install <application>Tk</application> by running the following
94 commands:
95 </para>
96
97<screen><userinput>cd unix &amp;&amp;
98./configure --prefix=/usr \
99 --mandir=/usr/share/man \
100 $([ $(uname -m) = x86_64 ] &amp;&amp; echo --enable-64bit) &amp;&amp;
101
102make &amp;&amp;
103
104sed -e "s@^\(TK_SRC_DIR='\).*@\1/usr/include'@" \
105 -e "/TK_B/s@='\(-L\)\?.*unix@='\1/usr/lib@" \
106 -i tkConfig.sh</userinput></screen>
107
108 <para>
109 Running the tests is not recommended. Failures will be reported during the
110 tests, depending on the screen resolution/capabilities, fonts installed
111 and other X related parameters, but the end report can show 0 failures.
112 Some tests will steal focus and some might crash your X Server. To test
113 the results anyway, issue: <command>make test</command>. Ensure you run
114 it from an X Window display device with the GLX extensions loaded, but
115 even so, tests might hang.
116 <!-- Test Statistics (tk8.6.9 - renodr):
117 Total: 466
118 Passed: 447
119 Skipped: 17
120 Failed: 2
121 The two tests that fail have to do with ttk.test
122
123 tk8.6.10 - bdubbs 11/25/2019
124 Total 480 Passed 463 Skipped 17 Failed 0
125
126 tk8.6.11.1 - pierre 01/16/2021 There are two summary lines apparently:
127 Total 9650 Passed 8847 Skipped 708 Failed 95
128 Total 488 Passed 470 Skipped 17 Failed 1
129 -->
130 </para>
131
132 <para>
133 Now, as the <systemitem class="username">root</systemitem> user:
134 </para>
135
136<screen role="root"><userinput>make install &amp;&amp;
137make install-private-headers &amp;&amp;
138ln -v -sf wish&tk-ver; /usr/bin/wish &amp;&amp;
139chmod -v 755 /usr/lib/libtk&tk-ver;.so</userinput></screen>
140
141 </sect2>
142
143 <sect2 role="commands">
144 <title>Command Explanations</title>
145
146 <para>
147 <parameter>$([ $(uname -m) = x86_64 ] &amp;&amp; echo
148 --enable-64bit)</parameter>: This switch is used to enable 64 bit
149 support in <application>Tk</application> on 64 bit operating
150 systems.
151 </para>
152
153 <para>
154 <command>make install-private-headers</command>: This command is
155 used to install the <application>Tk</application> library interface
156 headers used by other packages if they link to the
157 <application>Tk</application> library.
158 </para>
159
160 <para>
161 <command>ln -v -sf wish&tk-ver; /usr/bin/wish</command>: This
162 command is used to create a compatibility symbolic link to the
163 <command>wish&tk-ver;</command> file as many packages expect a file
164 named <command>wish</command>.
165 </para>
166
167 <para>
168 <command>sed -e ... tkConfig.sh</command>: The
169 <application>Tk</application> package expects that its source tree is
170 preserved so that packages depending on it for their compilation
171 can utilize it. This <command>sed</command> removes the references to the
172 build directory and replaces them with saner system-wide locations.
173 </para>
174
175 </sect2>
176
177 <sect2 role="content">
178 <title>Contents</title>
179
180 <segmentedlist>
181 <segtitle>Installed Programs</segtitle>
182 <segtitle>Installed Libraries</segtitle>
183 <segtitle>Installed Directory</segtitle>
184
185 <seglistitem>
186 <seg>
187 wish and wish&tk-ver;
188 </seg>
189 <seg>
190 libtk&tk-ver;.so and libtkstub&tk-ver;.a
191 </seg>
192 <seg>
193 /usr/lib/tk&tk-ver;
194 </seg>
195 </seglistitem>
196 </segmentedlist>
197
198 <variablelist>
199 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
200 <?dbfo list-presentation="list"?>
201 <?dbhtml list-presentation="table"?>
202
203 <varlistentry id="wish">
204 <term><command>wish</command></term>
205 <listitem>
206 <para>
207 is a symlink to the <command>wish&tk-ver;</command> program.
208 </para>
209 <indexterm zone="tk wish">
210 <primary sortas="b-wish">wish</primary>
211 </indexterm>
212 </listitem>
213 </varlistentry>
214
215 <varlistentry id="wish-eight">
216 <term><command>wish&tk-ver;</command></term>
217 <listitem>
218 <para>
219 is a simple shell containing the
220 <application>Tk</application> toolkit that creates a main window and
221 then processes <application>Tcl</application> commands.
222 </para>
223 <indexterm zone="tk wish-eight">
224 <primary sortas="b-wish&tk-ver;">wish&tk-ver;</primary>
225 </indexterm>
226 </listitem>
227 </varlistentry>
228
229 <varlistentry id="libtk">
230 <term><filename class="libraryfile">libtk&tk-ver;.so</filename></term>
231 <listitem>
232 <para>
233 contains the API functions required
234 by <application>Tk</application>.
235 </para>
236 <indexterm zone="tk libtk">
237 <primary sortas="c-libtk">libtk&tk-ver;.so</primary>
238 </indexterm>
239 </listitem>
240 </varlistentry>
241
242 </variablelist>
243
244 </sect2>
245
246</sect1>
Note: See TracBrowser for help on using the repository browser.