source: general/prog/tk.xml@ 78a2a23

10.0 10.1 11.0 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 ken/refactor-virt krejzi/svn lazarus nosym perl-modules qt5new systemd-11177 systemd-13485 trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since 78a2a23 was 78a2a23, checked in by Igor Živković <igor@…>, 17 years ago

Modified the test suite note in Tk instructions.

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

  • Property mode set to 100644
File size: 5.6 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7<!ENTITY tk-download-http "http://prdownloads.sourceforge.net/tcl/tk&tk-version;-src.tar.gz">
8<!ENTITY tk-download-ftp "ftp://ftp.us.xemacs.org/pub/tcl/tcl8_4/tk&tk-version;-src.tar.gz">
9<!ENTITY tk-md5sum "1b64258abaf258e9a86f331d8de17a71">
10<!ENTITY tk-size "3.2 MB">
11<!ENTITY tk-buildsize "23.3 MB">
12<!ENTITY tk-time "0.35 SBU">
13]>
14
15<sect1 id="tk" xreflabel="Tk-&tk-version;">
16<sect1info>
17<othername>$LastChangedBy$</othername>
18<date>$Date$</date>
19</sect1info>
20<?dbhtml filename="tk.html"?>
21<title>Tk-&tk-version;</title>
22<indexterm zone="tk">
23<primary sortas="a-Tk">Tk</primary></indexterm>
24
25<sect2>
26<title>Introduction to <application>Tk</application></title>
27
28<para>The <application>Tk</application> package contains a
29<acronym>TCL</acronym> <acronym>GUI</acronym> Toolkit.</para>
30
31<sect3><title>Package information</title>
32<itemizedlist spacing='compact'>
33<listitem><para>Download (HTTP): <ulink
34url="&tk-download-http;"/></para></listitem>
35<listitem><para>Download (FTP): <ulink
36url="&tk-download-ftp;"/></para></listitem>
37<listitem><para>Download MD5 sum: &tk-md5sum;</para></listitem>
38<listitem><para>Download size: &tk-size;</para></listitem>
39<listitem><para>Estimated disk space required:
40&tk-buildsize;</para></listitem>
41<listitem><para>Estimated build time:
42&tk-time;</para></listitem></itemizedlist>
43</sect3>
44
45<sect3><title><application>Tk</application> dependencies</title>
46<sect4><title>Required</title>
47<para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>) and
48<xref linkend="tcl"/></para></sect4>
49</sect3>
50
51</sect2>
52
53<sect2>
54<title>Installation of <application>Tk</application></title>
55
56<para>Install <application>Tk</application> by running the following
57commands:</para>
58
59<screen><userinput><command>export VERSION=&tk-version; &amp;&amp;
60export V=`echo $VERSION | cut -d "." -f 1,2` &amp;&amp;
61export DIR=$PWD &amp;&amp;
62cd unix &amp;&amp;
63./configure --prefix=/usr --enable-threads &amp;&amp;
64make &amp;&amp;
65sed -i "s:${DIR}/unix:/usr/lib:" tkConfig.sh &amp;&amp;
66sed -i "s:${DIR}:/usr/include/tk${V}:" tkConfig.sh</command></userinput></screen>
67
68<para>To test the results, issue: <command>make test</command>. Ensure
69you do it from an X Window display device with the
70<acronym>GLX</acronym> extensions loaded, else the tests will
71hang.</para>
72
73<para>Now, as the root user:</para>
74
75<screen><userinput role='root'><command>make install &amp;&amp;
76install -d /usr/include/tk${V}/unix &amp;&amp;
77install -m644 *.h /usr/include/tk${V}/unix/ &amp;&amp;
78install -d /usr/include/tk${V}/generic &amp;&amp;
79install -m644 ../generic/*.h /usr/include/tk${V}/generic/ &amp;&amp;
80rm -f /usr/include/tk${V}/generic/{tk,tkDecls,tkPlatDecls}.h &amp;&amp;
81ln -nsf ../../include/tk${V} /usr/lib/tk${V}/include &amp;&amp;
82ln -sf libtk${V}.so /usr/lib/libtk.so &amp;&amp;
83ln -sf wish${V} /usr/bin/wish</command></userinput></screen>
84
85<para>Clean up the unprivileged user's environment using the following
86commands:</para>
87
88<screen><userinput><command>unset VERSION &amp;&amp;
89unset V &amp;&amp;
90unset DIR</command></userinput></screen>
91
92<!--
93<caution><para>If you build the package as an ordinary user and then switch to
94root to install the package, ensure you set the environment variables
95<envar>V</envar> and <envar>VERSION</envar> before running the installation
96commands.</para></caution>
97-->
98
99</sect2>
100
101<sect2>
102<title>Command explanations</title>
103
104<para><parameter>--enable-threads</parameter>: This switch forces the package
105to build with thread support.</para>
106
107<para><command>sed -i ...</command>: The <application>Tk</application> package
108assumes that the source that is used to build <application>Tk</application> is
109always kept around for compiling packages that depend on
110<application>Tk</application>. These <command>sed</command>'s remove the
111reference to the build directory and replace them by saner system wide
112locations.</para>
113
114<para><command>install ...</command>: These commands install the internal
115headers into a system-wide location.</para>
116
117<para><command>ln -sf ...</command>: These commands create compatibility
118symbolic links.</para>
119
120</sect2>
121
122<sect2>
123<title>Contents</title>
124
125<segmentedlist>
126<segtitle>Installed Programs</segtitle>
127<segtitle>Installed Libraries</segtitle>
128<segtitle>Installed Directories</segtitle>
129
130<seglistitem>
131<seg>wish and wish8.4</seg>
132<seg>libtk.so and libtkstub8.4.a</seg>
133<seg>/usr/include/tk8.4 and /usr/lib/tk8.4</seg>
134</seglistitem>
135</segmentedlist>
136
137<variablelist>
138<bridgehead renderas="sect3">Short Descriptions</bridgehead>
139<?dbfo list-presentation="list"?>
140
141<varlistentry id="wish">
142<term><command>wish</command></term>
143<listitem><para> is a symlink to the <command>wish8.4</command> program.</para>
144<indexterm zone="tk wish">
145<primary sortas="b-wish">wish</primary></indexterm>
146</listitem>
147</varlistentry>
148
149<varlistentry id="wish8.4">
150<term><command>wish8.4</command></term>
151<listitem><para> is a simple shell containing the
152<application>Tk</application> toolkit that creates a main window and
153then processes <application>Tcl</application> commands.</para>
154<indexterm zone="tk wish8.4">
155<primary sortas="b-wish8.4">wish8.4</primary></indexterm>
156</listitem>
157</varlistentry>
158
159<varlistentry id="libtk">
160<term><filename role="library">libtk.so</filename></term>
161<listitem><para>contains the <acronym>API</acronym> functions required
162by <application>Tk</application>.</para>
163<indexterm zone="tk libtk">
164<primary sortas="c-libtk">libtk.so</primary></indexterm>
165</listitem>
166</varlistentry>
167</variablelist>
168
169</sect2>
170
171</sect1>
Note: See TracBrowser for help on using the repository browser.