source: temp-tools/common/tcl.xml @ 1bc724c

Last change on this file since 1bc724c was 1bc724c, checked in by Jim Gifford <clfs@…>, 18 years ago

r884@server (orig r882): ken | 2005-12-11 06:21:27 -0800
Fix tcl configure with new bash

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