source: BOOK/temp-tools/common/tcl.xml@ 663c5a6

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

r661@server (orig r659): manuel | 2005-11-08 13:24:20 -0800
Removing SBUs and DUs. Chapter temp-tools.

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