source: BOOK/temp-tools/common/tcl.xml@ 9f696aca

clfs-1.2 clfs-2.1 clfs-3.0.0-systemd clfs-3.0.0-sysvinit systemd sysvinit
Last change on this file since 9f696aca was 3f8be484, checked in by Jim Gifford <clfs@…>, 19 years ago

r627@server (orig r625): jim | 2005-10-31 12:59:34 -0800
Import of Cross-LFS Book

  • Property mode set to 100644
File size: 4.8 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 <!ENTITY % patches-entities SYSTEM "../../patches.ent">
6 %general-entities;
7 %patches-entities;
8]>
9
10<sect1 id="ch-temp-tools-tcl" role="wrap">
11 <?dbhtml filename="tcl.html"?>
12
13 <title>Tcl-&tcl-version;</title>
14
15 <indexterm zone="ch-temp-tools-tcl">
16 <primary sortas="a-Tcl">Tcl</primary>
17 </indexterm>
18
19 <sect2 role="package">
20 <title/>
21
22 <para>The Tcl package contains the Tool Command Language.</para>
23
24 <segmentedlist>
25 <segtitle>&buildtime;</segtitle>
26 <segtitle>&diskspace;</segtitle>
27
28 <seglistitem>
29 <seg>Not checked yet</seg>
30 <seg>Not checked yet</seg>
31 </seglistitem>
32 </segmentedlist>
33
34 <segmentedlist>
35 <segtitle>&dependencies;</segtitle>
36
37 <seglistitem>
38 <seg>Bash, Binutils, Coreutils, Diffutils,
39 GCC, Glibc, Grep, Make, and Sed</seg>
40 </seglistitem>
41 </segmentedlist>
42
43 </sect2>
44
45 <sect2 role="installation">
46 <title>Installation of Tcl</title>
47
48 <para os="a">This package and the next two (Expect and DejaGNU) are installed
49 to support running the test suites for GCC and Binutils. Installing
50 three packages for testing purposes may seem excessive, but it is very
51 reassuring, if not essential, to know that the most important tools are
52 working properly. Even if the test suites are not run in this chapter
53 (they are not mandatory), these packages are required to run the test
54 suites in <xref linkend="chapter-building-system"/>.</para>
55
56 <para os="b">Prepare Tcl for compilation:</para>
57
58<screen><userinput>cd unix
59./configure --prefix=/tools</userinput></screen>
60
61 <para os="c">Build the package:</para>
62
63<screen os="d"><userinput>make</userinput></screen>
64
65 <para os="e">To test the results, issue: <userinput>TZ=UTC make
66 test</userinput>. The Tcl test suite is known to experience failures
67 under certain host conditions that are not fully understood.
68 Therefore, test suite failures here are not surprising, and are not
69 considered critical. The <parameter>TZ=UTC</parameter> parameter sets
70 the time zone to Coordinated Universal Time (UTC), also known as
71 Greenwich Mean Time (GMT), but only for the duration of the test suite
72 run. This ensures that the clock tests are exercised correctly.
73 Details on the <envar>TZ</envar> environment variable are provided in
74 <xref linkend="chapter-bootscripts"/>.</para>
75
76 <para os="f">Install the package:</para>
77
78<screen os="g"><userinput>make install</userinput></screen>
79
80 <warning os="h">
81 <para><emphasis>Do not</emphasis> remove the <filename
82 class="directory">tcl&tcl-version;</filename> source directory yet,
83 as the next package will need its internal headers.</para>
84 </warning>
85
86 <para os="i">Set a variable containing the full path of the current directory.
87 The next package, Expect, will use this variable to find Tcl's headers.</para>
88
89<screen os="j"><userinput>cd ..
90export TCLPATH=`pwd`</userinput></screen>
91
92 <para os="k">Now make a necessary symbolic link:</para>
93
94<screen os="l"><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen>
95
96 </sect2>
97
98 <sect2 id="contents-tcl" role="content">
99 <title>Contents of Tcl</title>
100
101 <segmentedlist>
102 <segtitle>Installed programs</segtitle>
103 <segtitle>Installed library</segtitle>
104
105 <seglistitem>
106 <seg>tclsh (link to tclsh8.4) and tclsh8.4</seg>
107 <seg>libtcl8.4.so</seg>
108 </seglistitem>
109 </segmentedlist>
110
111 <variablelist>
112 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
113 <?dbfo list-presentation="list"?>
114 <?dbhtml list-presentation="table"?>
115
116 <varlistentry id="tclsh8.4">
117 <term><command>tclsh8.4</command></term>
118 <listitem>
119 <para>The Tcl command shell</para>
120 <indexterm zone="ch-temp-tools-tcl tclsh8.4">
121 <primary sortas="b-tclsh8.4">tclsh8.4</primary>
122 </indexterm>
123 </listitem>
124 </varlistentry>
125
126 <varlistentry id="tclsh">
127 <term><command>tclsh</command></term>
128 <listitem>
129 <para>A link to tclsh8.4</para>
130 <indexterm zone="ch-temp-tools-tcl tclsh">
131 <primary sortas="b-tclsh">tclsh</primary>
132 </indexterm>
133 </listitem>
134 </varlistentry>
135
136 <varlistentry id="libtcl8.4.so">
137 <term><filename class="libraryfile">libtcl8.4.so</filename></term>
138 <listitem>
139 <para>The Tcl library</para>
140 <indexterm zone="ch-temp-tools-tcl libtcl8.4.so">
141 <primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary>
142 </indexterm>
143 </listitem>
144 </varlistentry>
145
146 </variablelist>
147
148 </sect2>
149
150</sect1>
Note: See TracBrowser for help on using the repository browser.