source: chapter05/tcl.xml@ 1375d26

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE section [
  <!ENTITY % general-entities SYSTEM "../general.ent">
  %general-entities;
]>
<section xmlns="http://docbook.org/docbook-ng"
         xml:id="ch-tools-tcl" xreflabel="Tcl" role="wrap">
<title>Tcl-&tcl-version;</title>
<?dbhtml filename="tcl.html"?>

<indexterm zone="ch-tools-tcl"><primary sortas="a-Tcl">Tcl</primary></indexterm>

<section role="package"><title/>
<para>The Tcl package contains the Tool Command Language.</para>

<segmentedlist>
<segtitle>&buildtime;</segtitle>
<segtitle>&diskspace;</segtitle>
<seglistitem><seg>0.9 SBU</seg><seg>23 MB</seg></seglistitem>
</segmentedlist>

<segmentedlist>
<segtitle>Tcl installation depends on</segtitle>
<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
GCC, Glibc, Grep, Make, Sed</seg></seglistitem>
</segmentedlist>

</section>

<section role="installation">
<title>Installation of Tcl</title>

<para>This package and the next two are only installed to support running the
test suites for GCC and Binutils. Installing three packages just for testing
purposes may seem like overkill, but it is very reassuring, if not essential,
to know that our most important tools are working properly. Even if the
the test suites are not run in this chapter (we recommend not running them),
these packages are still required to run the test suites in the next
chapter.</para>

<para>Prepare Tcl for compilation:</para>

<screen><userinput>cd unix
./configure --prefix=/tools</userinput></screen>

<para>Build the package:</para>

<screen><userinput>make</userinput></screen>

<para>If you want to test the results, then issue:
<userinput>TZ=UTC make test</userinput>. However, the Tcl test suite is known
to experience failures under certain host conditions that are not fully
understood. Therefore, test suite failures here are not surprising, and are not
considered critical. The <parameter>TZ=UTC</parameter> parameter sets the time
zone to Coordinated Universal Time (UTC) also known as Greenwich Mean Time
(GMT), but only for the duration of the test suite run. This ensures the clock
tests are exercised correctly. More information on the TZ environment variable
will be given later on in <xref linkend="chapter-bootscripts"/>.</para>

<para>Install the package:</para>

<screen><userinput>make install</userinput></screen>

<warning><para><emphasis>Do not remove</emphasis> the
<filename class="directory">tcl&tcl-version;</filename> source directory yet, as the next package
will need its internal headers.</para></warning>

<para>Now make a necessary symbolic link:</para>

<screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen>

</section>

<section xml:id="contents-tcl" role="content"><title>Contents of Tcl</title>

<segmentedlist>
<segtitle>Installed programs</segtitle>
<segtitle>Installed library</segtitle>
<seglistitem><seg>tclsh (link to tclsh8.4), tclsh8.4</seg><seg>libtcl8.4.so</seg></seglistitem>
</segmentedlist>

<variablelist><title>Short descriptions</title>

<varlistentry xml:id="tclsh8.4">
<term><command>tclsh8.4</command></term>
<listitem>
<indexterm zone="ch-tools-tcl tclsh8.4"><primary sortas="b-tclsh8.4">tclsh8.4</primary></indexterm>
<para>is the Tcl command shell.</para>
</listitem>
</varlistentry>

<varlistentry xml:id="libtcl8.4.so">
<term><filename class="libraryfile">libtcl8.4.so</filename></term>
<listitem>
<indexterm zone="ch-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm>
<para>is the Tcl library.</para>
</listitem>
</varlistentry>
</variablelist>

</section>

</section>