source: general/prog/tk.xml@ f4002c5

10.0 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 f4002c5 was f4002c5, checked in by Bruce Dubbs <bdubbs@…>, 16 months ago

Archive expect, dejagnu, and tcl which are now included in LFS.

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

  • Property mode set to 100644
File size: 7.0 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 "602a47ad9ecac7bf655ada729d140a94">
10 <!ENTITY tk-size "4.2 MB">
11 <!ENTITY tk-buildsize "24 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 &lfs91_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 </para>
127
128 <para>
129 Now, as the <systemitem class="username">root</systemitem> user:
130 </para>
131
132<screen role="root"><userinput>make install &amp;&amp;
133make install-private-headers &amp;&amp;
134ln -v -sf wish&tk-ver; /usr/bin/wish &amp;&amp;
135chmod -v 755 /usr/lib/libtk&tk-ver;.so</userinput></screen>
136
137 </sect2>
138
139 <sect2 role="commands">
140 <title>Command Explanations</title>
141
142 <para>
143 <parameter>$([ $(uname -m) = x86_64 ] &amp;&amp; echo
144 --enable-64bit)</parameter>: This switch is used to enable 64 bit
145 support in <application>Tk</application> on 64 bit operating
146 systems.
147 </para>
148
149 <para>
150 <command>make install-private-headers</command>: This command is
151 used to install the <application>Tk</application> library interface
152 headers used by other packages if they link to the
153 <application>Tk</application> library.
154 </para>
155
156 <para>
157 <command>ln -v -sf wish&tk-ver; /usr/bin/wish</command>: This
158 command is used to create a compatibility symbolic link to the
159 <command>wish&tk-ver;</command> file as many packages expect a file
160 named <command>wish</command>.
161 </para>
162
163 <para>
164 <command>sed -e ... tkConfig.sh</command>: The
165 <application>Tk</application> package expects that its source tree is
166 preserved so that packages depending on it for their compilation
167 can utilize it. This <command>sed</command> removes the references to the
168 build directory and replaces them with saner system-wide locations.
169 </para>
170
171 </sect2>
172
173 <sect2 role="content">
174 <title>Contents</title>
175
176 <segmentedlist>
177 <segtitle>Installed Programs</segtitle>
178 <segtitle>Installed Libraries</segtitle>
179 <segtitle>Installed Directory</segtitle>
180
181 <seglistitem>
182 <seg>
183 wish and wish&tk-ver;
184 </seg>
185 <seg>
186 libtk&tk-ver;.so and libtkstub&tk-ver;.a
187 </seg>
188 <seg>
189 /usr/lib/tk&tk-ver;
190 </seg>
191 </seglistitem>
192 </segmentedlist>
193
194 <variablelist>
195 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
196 <?dbfo list-presentation="list"?>
197 <?dbhtml list-presentation="table"?>
198
199 <varlistentry id="wish">
200 <term><command>wish</command></term>
201 <listitem>
202 <para>
203 is a symlink to the <command>wish&tk-ver;</command> program.
204 </para>
205 <indexterm zone="tk wish">
206 <primary sortas="b-wish">wish</primary>
207 </indexterm>
208 </listitem>
209 </varlistentry>
210
211 <varlistentry id="wish-eight">
212 <term><command>wish&tk-ver;</command></term>
213 <listitem>
214 <para>
215 is a simple shell containing the
216 <application>Tk</application> toolkit that creates a main window and
217 then processes <application>Tcl</application> commands.
218 </para>
219 <indexterm zone="tk wish-eight">
220 <primary sortas="b-wish&tk-ver;">wish&tk-ver;</primary>
221 </indexterm>
222 </listitem>
223 </varlistentry>
224
225 <varlistentry id="libtk">
226 <term><filename class="libraryfile">libtk&tk-ver;.so</filename></term>
227 <listitem>
228 <para>
229 contains the API functions required
230 by <application>Tk</application>.
231 </para>
232 <indexterm zone="tk libtk">
233 <primary sortas="c-libtk">libtk&tk-ver;.so</primary>
234 </indexterm>
235 </listitem>
236 </varlistentry>
237
238 </variablelist>
239
240 </sect2>
241
242</sect1>
Note: See TracBrowser for help on using the repository browser.