[673b0d8] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN" "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
---|
| 3 | <!ENTITY % general-entities SYSTEM "../general.ent">
|
---|
| 4 | %general-entities;
|
---|
| 5 | ]>
|
---|
[3be4d97] | 6 | <sect1 id="ch-tools-tcl" xreflabel="Tcl">
|
---|
[673b0d8] | 7 | <title>Tcl-&tcl-version;</title>
|
---|
| 8 | <?dbhtml filename="tcl.html"?>
|
---|
| 9 |
|
---|
| 10 | <indexterm zone="ch-tools-tcl"><primary sortas="a-Tcl">Tcl</primary></indexterm>
|
---|
[bc82645e] | 11 |
|
---|
[5888299] | 12 | <para>The Tcl package contains the Tool Command Language.</para>
|
---|
| 13 |
|
---|
[673b0d8] | 14 | <screen>&buildtime; 0.9 SBU
|
---|
| 15 | &diskspace; 23 MB</screen>
|
---|
| 16 |
|
---|
| 17 | <para>Tcl installation depends on: Bash, Binutils, Coreutils, Diffutils,
|
---|
| 18 | GCC, Glibc, Grep, Make, Sed.</para>
|
---|
[bc82645e] | 19 |
|
---|
[73aedd1d] | 20 |
|
---|
| 21 |
|
---|
| 22 | <sect2>
|
---|
| 23 | <title>Installation of Tcl</title>
|
---|
| 24 |
|
---|
[673b0d8] | 25 | <para>This package and the next two are only installed to support running the
|
---|
[ede9b9b] | 26 | test suites for GCC and Binutils. Installing three packages just for testing
|
---|
| 27 | purposes may seem like overkill, but it is very reassuring, if not essential,
|
---|
[673b0d8] | 28 | to know that our most important tools are working properly. Even if the
|
---|
| 29 | the test suites are not run in this chapter (we recommend not running them),
|
---|
| 30 | these packages are still required to run the test suites in the next
|
---|
[443cace] | 31 | chapter.</para>
|
---|
[73aedd1d] | 32 |
|
---|
[d27a27b] | 33 | <para>Prepare Tcl for compilation:</para>
|
---|
[73aedd1d] | 34 |
|
---|
| 35 | <screen><userinput>cd unix
|
---|
| 36 | ./configure --prefix=/tools</userinput></screen>
|
---|
| 37 |
|
---|
| 38 | <para>Build the package:</para>
|
---|
| 39 |
|
---|
| 40 | <screen><userinput>make</userinput></screen>
|
---|
| 41 |
|
---|
[673b0d8] | 42 | <para>If you want to test the results, then issue:
|
---|
[c91dd5b] | 43 | <userinput>TZ=UTC make test</userinput>. However, the Tcl test suite is known
|
---|
| 44 | to experience failures under certain host conditions that are not fully
|
---|
| 45 | understood. Therefore, test suite failures here are not surprising, and are not
|
---|
| 46 | considered critical. The <emphasis>TZ=UTC</emphasis> parameter sets the time
|
---|
| 47 | zone to Coordinated Universal Time (UTC) also known as Greenwich Mean Time
|
---|
| 48 | (GMT), but only for the duration of the test suite run. This ensures the clock
|
---|
| 49 | tests are exercised correctly. More information on the TZ environment variable
|
---|
[673b0d8] | 50 | will be given later on in <xref linkend="chapter-bootscripts"/>.</para>
|
---|
[73aedd1d] | 51 |
|
---|
| 52 | <para>Install the package:</para>
|
---|
| 53 |
|
---|
| 54 | <screen><userinput>make install</userinput></screen>
|
---|
| 55 |
|
---|
[f4993cf] | 56 |
|
---|
| 57 | <warning><para><emphasis>Do not remove</emphasis> the
|
---|
[73aedd1d] | 58 | <filename>tcl&tcl-version;</filename> source directory yet, as the next package
|
---|
[f4993cf] | 59 | will need its internal headers.</para></warning>
|
---|
| 60 |
|
---|
[73aedd1d] | 61 |
|
---|
[673b0d8] | 62 | <para>Now make a necessary symbolic link:</para>
|
---|
[73aedd1d] | 63 |
|
---|
| 64 | <screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen>
|
---|
| 65 |
|
---|
| 66 | </sect2>
|
---|
[bc82645e] | 67 |
|
---|
[5888299] | 68 |
|
---|
[673b0d8] | 69 | <sect2 id="contents-tcl"><title>Contents of Tcl</title>
|
---|
| 70 |
|
---|
| 71 | <para><emphasis>Installed programs</emphasis>: tclsh (link to tclsh8.4),
|
---|
| 72 | tclsh8.4</para>
|
---|
| 73 |
|
---|
| 74 | <para><emphasis>Installed library</emphasis>: libtcl8.4.so</para>
|
---|
| 75 |
|
---|
| 76 | </sect2>
|
---|
| 77 |
|
---|
[bc82645e] | 78 |
|
---|
[673b0d8] | 79 | <sect2><title>Short descriptions</title>
|
---|
| 80 |
|
---|
| 81 | <indexterm zone="ch-tools-tcl tclsh8.4"><primary sortas="b-tclsh8.4">tclsh8.4</primary></indexterm>
|
---|
| 82 | <para id="tclsh8.4"><command>tclsh8.4</command> is the Tcl command shell.</para>
|
---|
| 83 |
|
---|
| 84 | <indexterm zone="ch-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm>
|
---|
| 85 | <para id="libtcl8.4.so"><command>libtcl8.4.so</command> is the Tcl library.</para>
|
---|
| 86 |
|
---|
| 87 | </sect2>
|
---|
| 88 |
|
---|
| 89 |
|
---|
| 90 | </sect1>
|
---|