source: testsuite-tools/common/tcl.xml@ 1264086

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
  <!ENTITY % general-entities SYSTEM "../../general.ent">
  %general-entities;
]>

<sect1 id="ch-testsuite-tools-tcl" role="wrap">
  <?dbhtml filename="tcl.html"?>

  <title>Tcl-&tcl-version;</title>

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

  <sect2 role="package">
    <title/>

    <para>The Tcl package contains the Tool Command Language.</para>

  </sect2>

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

    <para os="a">This package and the next two (Expect and DejaGNU) are installed
    to support running the test suites for GCC and Binutils. Installing
    three packages for testing purposes may seem excessive, but it is very
    reassuring, if not essential, to know that the most important tools are
    working properly.</para>

    <para os="c1">First, fix a syntax error in the configure script:</para>

<screen os="c2"><userinput>cd unix
sed -i "s/relid'/relid/" configure</userinput></screen>

    <para os="b">Prepare Tcl for compilation:</para>

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

    <para os="d">Build the package:</para>

<screen os="e"><userinput>make</userinput></screen>

    <para os="g">Install the package:</para>

<screen os="h"><userinput>make install</userinput></screen>

    <para os="i">Tcl's private headers files are needed for the next
    package, Expect. Install them into /tools:</para>

<screen os="j"><userinput>make install-private-headers</userinput></screen>

    <para os="k">Now make a necessary symbolic link:</para>

<screen os="l"><userinput>ln -sv tclsh8.4 /tools/bin/tclsh</userinput></screen>

  </sect2>

  <sect2 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) and tclsh8.4</seg>
        <seg>libtcl8.4.so</seg>
      </seglistitem>
    </segmentedlist>

    <variablelist>
      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
      <?dbfo list-presentation="list"?>
      <?dbhtml list-presentation="table"?>

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

      <varlistentry id="tclsh">
        <term><command>tclsh</command></term>
        <listitem>
          <para>A link to tclsh8.4</para>
          <indexterm zone="ch-testsuite-tools-tcl tclsh">
            <primary sortas="b-tclsh">tclsh</primary>
          </indexterm>
        </listitem>
      </varlistentry>

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

    </variablelist>

  </sect2>

</sect1>