BOOK/chapter05/tcl.xml

   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 ]>
   6 <sect1 id="ch-tools-tcl" xreflabel="Tcl">
   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>
  11
  12 <para>The Tcl package contains the Tool Command Language.</para>
  13
  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>
  19
  20
  21
  22 <sect2>
  23 <title>Installation of Tcl</title>
  24
  25 <para>This package and the next two are only installed to support running the
  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,
  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
  31 chapter.</para>
  32
  33 <para>Prepare Tcl for compilation:</para>
  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
  42 <para>If you want to test the results, then issue:
  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
  50 will be given later on in <xref linkend="chapter-bootscripts"/>.</para>
  51
  52 <para>Install the package:</para>
  53
  54 <screen><userinput>make install</userinput></screen>
  55
  56
  57 <warning><para><emphasis>Do not remove</emphasis> the
  58 <filename>tcl&tcl-version;</filename> source directory yet, as the next package
  59 will need its internal headers.</para></warning>
  60
  61
  62 <para>Now make a necessary symbolic link:</para>
  63
  64 <screen><userinput>ln -s tclsh8.4 /tools/bin/tclsh</userinput></screen>
  65
  66 </sect2>
  67
  68
  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
  78
  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>