source: BOOK/temp-tools/common/tcl.xml @ 3f8be484

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since 3f8be484 was 3f8be484, checked in by Jim Gifford <clfs@…>, 18 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.