diff options
Diffstat (limited to 'chapter05/tcl.xml')
| -rw-r--r-- | chapter05/tcl.xml | 194 |
1 files changed, 110 insertions, 84 deletions
diff --git a/chapter05/tcl.xml b/chapter05/tcl.xml index 3787a3d95..5e57053ab 100644 --- a/chapter05/tcl.xml +++ b/chapter05/tcl.xml @@ -1,119 +1,145 @@ <?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" [ +<!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-tools-tcl" role="wrap"> -<title>Tcl-&tcl-version;</title> -<?dbhtml filename="tcl.html"?> + <?dbhtml filename="tcl.html"?> + + <title>Tcl-&tcl-version;</title> + + <indexterm zone="ch-tools-tcl"> + <primary sortas="a-Tcl">Tcl</primary> + </indexterm> + + <sect2 role="package"> + <title/> -<indexterm zone="ch-tools-tcl"><primary sortas="a-Tcl">Tcl</primary></indexterm> + <para>The Tcl package contains the Tool Command Language.</para> -<sect2 role="package"><title/> -<para>The Tcl package contains the Tool Command Language.</para> + <segmentedlist> + <segtitle>&buildtime;</segtitle> + <segtitle>&diskspace;</segtitle> -<segmentedlist> -<segtitle>&buildtime;</segtitle> -<segtitle>&diskspace;</segtitle> -<seglistitem><seg>0.9 SBU</seg><seg>23.3 MB</seg></seglistitem> -</segmentedlist> + <seglistitem> + <seg>0.9 SBU</seg> + <seg>23.3 MB</seg> + </seglistitem> + </segmentedlist> -<segmentedlist> -<segtitle>&dependencies;</segtitle> -<seglistitem><seg>Bash, Binutils, Coreutils, Diffutils, -GCC, Glibc, Grep, Make, and Sed</seg></seglistitem> -</segmentedlist> + <segmentedlist> + <segtitle>&dependencies;</segtitle> -</sect2> + <seglistitem> + <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep, + Make, and Sed</seg> + </seglistitem> + </segmentedlist> -<sect2 role="installation"> -<title>Installation of Tcl</title> + </sect2> -<para>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. Even if the test suites are not -run in this chapter (they are not mandatory), these packages -are required to run the test suites in <xref -linkend="chapter-building-system"/>.</para> + <sect2 role="installation"> + <title>Installation of Tcl</title> + + <para>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. Even if the test suites are not run in this chapter + (they are not mandatory), these packages are required to run the test + suites in <xref linkend="chapter-building-system"/>.</para> + + <para>Tcl's configure script has a syntax error:</para> -<para>Tcl's configure script has a syntax error:</para> <screen><userinput>cd unix cp -v configure{,.orig} sed "s/relid'/relid/" configure.orig > configure</userinput></screen> -<para>Prepare Tcl for compilation:</para> + <para>Prepare Tcl for compilation:</para> <screen><userinput>./configure --prefix=/tools</userinput></screen> -<para>Build the package:</para> + <para>Build the package:</para> <screen><userinput>make</userinput></screen> -<para>To test the results, issue: <userinput>TZ=UTC make test</userinput>. -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 that the clock tests are exercised correctly. -Details on the <envar>TZ</envar> environment variable are provided in -<xref linkend="chapter-bootscripts"/>.</para> + <para>To test the results, issue: <userinput>TZ=UTC make test</userinput>. + 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 that the clock tests + are exercised correctly. Details on the <envar>TZ</envar> environment + variable are provided in <xref linkend="chapter-bootscripts"/>.</para> -<para>Install the package:</para> + <para>Install the package:</para> <screen><userinput>make install</userinput></screen> -<para>Install Tcl's headers. The next package, Expect, requires them to build.</para> + <para>Install Tcl's headers. The next package, Expect, requires them + to build.</para> <screen><userinput>make install-private-headers</userinput></screen> -<para>Now make a necessary symbolic link:</para> + <para>Now make a necessary symbolic link:</para> <screen><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-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-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-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm> -</listitem> -</varlistentry> -</variablelist> - -</sect2> + </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-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-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-tools-tcl libtcl8.4.so"> + <primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary> + </indexterm> + </listitem> + </varlistentry> + + </variablelist> + + </sect2> </sect1> - |