Changeset b28fd35 for chapter05/tcl.xml


Ignore:
Timestamp:
01/22/2006 01:13:52 PM (18 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.0-rc1, 10.1, 10.1-rc1, 11.0, 11.0-rc1, 11.0-rc2, 11.0-rc3, 11.1, 11.1-rc1, 11.2, 11.2-rc1, 11.3, 11.3-rc1, 12.0, 12.0-rc1, 12.1, 12.1-rc1, 6.3, 6.4, 6.5, 6.6, 6.7, 6.8, 7.0, 7.1, 7.2, 7.3, 7.4, 7.5, 7.5-systemd, 7.6, 7.6-systemd, 7.7, 7.7-systemd, 7.8, 7.8-systemd, 7.9, 7.9-systemd, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, arm, bdubbs/gcc13, ml-11.0, multilib, renodr/libudev-from-systemd, s6-init, trunk, xry111/arm64, xry111/arm64-12.0, xry111/clfs-ng, xry111/lfs-next, xry111/loongarch, xry111/loongarch-12.0, xry111/loongarch-12.1, xry111/mips64el, xry111/pip3, xry111/rust-wip-20221008, xry111/update-glibc
Children:
41ddb3b
Parents:
7b82580
Message:

Finished chapter 05 indentation.

git-svn-id: ​http://svn.linuxfromscratch.org/LFS/trunk/BOOK@7292 4aa44e1e-78dd-0310-a6d2-fbcd4c07a689

File:
1 edited

Legend:

Unmodified
Added
Removed

  • chapter05/tcl.xml

    r7b82580 rb28fd35  
    11<?xml version="1.0" encoding="ISO-8859-1"?>
    2 <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
     2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    34  <!ENTITY % general-entities SYSTEM "../general.ent">
    45  %general-entities;
    56]>
     7
    68<sect1 id="ch-tools-tcl" role="wrap">
    7 <title>Tcl-&tcl-version;</title>
    8 <?dbhtml filename="tcl.html"?>
     9  <?dbhtml filename="tcl.html"?>
    910
    10 <indexterm zone="ch-tools-tcl"><primary sortas="a-Tcl">Tcl</primary></indexterm>
     11  <title>Tcl-&tcl-version;</title>
    1112
    12 <sect2 role="package"><title/>
    13 <para>The Tcl package contains the Tool Command Language.</para>
     13  <indexterm zone="ch-tools-tcl">
     14    <primary sortas="a-Tcl">Tcl</primary>
     15  </indexterm>
    1416
    15 <segmentedlist>
    16 <segtitle>&buildtime;</segtitle>
    17 <segtitle>&diskspace;</segtitle>
    18 <seglistitem><seg>0.9 SBU</seg><seg>23.3 MB</seg></seglistitem>
    19 </segmentedlist>
     17  <sect2 role="package">
     18    <title/>
    2019
    21 <segmentedlist>
    22 <segtitle>&dependencies;</segtitle>
    23 <seglistitem><seg>Bash, Binutils, Coreutils, Diffutils,
    24 GCC, Glibc, Grep, Make, and Sed</seg></seglistitem>
    25 </segmentedlist>
     20    <para>The Tcl package contains the Tool Command Language.</para>
    2621
    27 </sect2>
     22    <segmentedlist>
     23      <segtitle>&buildtime;</segtitle>
     24      <segtitle>&diskspace;</segtitle>
    2825
    29 <sect2 role="installation">
    30 <title>Installation of Tcl</title>
     26      <seglistitem>
     27        <seg>0.9 SBU</seg>
     28        <seg>23.3 MB</seg>
     29      </seglistitem>
     30    </segmentedlist>
    3131
    32 <para>This package and the next two (Expect and DejaGNU) are
    33 installed to support running the test suites for GCC and Binutils.
    34 Installing three packages for testing purposes may seem excessive, but
    35 it is very reassuring, if not essential, to know that the most
    36 important tools are working properly. Even if the test suites are not
    37 run in this chapter (they are not mandatory), these packages
    38 are required to run the test suites in <xref
    39 linkend="chapter-building-system"/>.</para>
     32    <segmentedlist>
     33      <segtitle>&dependencies;</segtitle>
    4034
    41 <para>Tcl's configure script has a syntax error:</para>
     35      <seglistitem>
     36        <seg>Bash, Binutils, Coreutils, Diffutils, GCC, Glibc, Grep,
     37        Make, and Sed</seg>
     38      </seglistitem>
     39    </segmentedlist>
     40
     41  </sect2>
     42
     43  <sect2 role="installation">
     44    <title>Installation of Tcl</title>
     45
     46    <para>This package and the next two (Expect and DejaGNU) are installed
     47    to support running the test suites for GCC and Binutils. Installing
     48    three packages for testing purposes may seem excessive, but it is very
     49    reassuring, if not essential, to know that the most important tools are
     50    working properly. Even if the test suites are not run in this chapter
     51    (they are not mandatory), these packages are required to run the test
     52    suites in <xref linkend="chapter-building-system"/>.</para>
     53
     54    <para>Tcl's configure script has a syntax error:</para>
     55
    4256<screen><userinput>cd unix
    4357cp -v configure{,.orig}
    4458sed "s/relid'/relid/" configure.orig &gt; configure</userinput></screen>
    4559
    46 <para>Prepare Tcl for compilation:</para>
     60    <para>Prepare Tcl for compilation:</para>
    4761
    4862<screen><userinput>./configure --prefix=/tools</userinput></screen>
    4963
    50 <para>Build the package:</para>
     64    <para>Build the package:</para>
    5165
    5266<screen><userinput>make</userinput></screen>
    5367
    54 <para>To test the results, issue: <userinput>TZ=UTC make test</userinput>.
    55 The Tcl test suite is known to experience failures
    56 under certain host conditions that are not fully understood.
    57 Therefore, test suite failures here are not surprising, and are not
    58 considered critical. The <parameter>TZ=UTC</parameter> parameter sets
    59 the time zone to Coordinated Universal Time (UTC), also known as
    60 Greenwich Mean Time (GMT), but only for the duration of the test suite
    61 run. This ensures that the clock tests are exercised correctly.
    62 Details on the <envar>TZ</envar> environment variable are provided in
    63 <xref linkend="chapter-bootscripts"/>.</para>
     68    <para>To test the results, issue: <userinput>TZ=UTC make test</userinput>.
     69    The Tcl test suite is known to experience failures under certain host
     70    conditions that are not fully understood. Therefore, test suite failures
     71    here are not surprising, and are not considered critical. The
     72    <parameter>TZ=UTC</parameter> parameter sets the time zone to Coordinated
     73    Universal Time (UTC), also known as Greenwich Mean Time (GMT), but only
     74    for the duration of the test suite run. This ensures that the clock tests
     75    are exercised correctly. Details on the <envar>TZ</envar> environment
     76    variable are provided in <xref linkend="chapter-bootscripts"/>.</para>
    6477
    65 <para>Install the package:</para>
     78    <para>Install the package:</para>
    6679
    6780<screen><userinput>make install</userinput></screen>
    6881
    69 <para>Install Tcl's headers. The next package, Expect, requires them to build.</para>
     82    <para>Install Tcl's headers. The next package, Expect, requires them
     83    to build.</para>
    7084
    7185<screen><userinput>make install-private-headers</userinput></screen>
    7286
    73 <para>Now make a necessary symbolic link:</para>
     87    <para>Now make a necessary symbolic link:</para>
    7488
    7589<screen><userinput>ln -sv tclsh8.4 /tools/bin/tclsh</userinput></screen>
    7690
    77 </sect2>
     91  </sect2>
    7892
    79 <sect2 id="contents-tcl" role="content"><title>Contents of Tcl</title>
     93  <sect2 id="contents-tcl" role="content">
     94    <title>Contents of Tcl</title>
    8095
    81 <segmentedlist>
    82 <segtitle>Installed programs</segtitle>
    83 <segtitle>Installed library</segtitle>
    84 <seglistitem><seg>tclsh (link to tclsh8.4) and tclsh8.4</seg><seg>libtcl8.4.so</seg></seglistitem>
    85 </segmentedlist>
     96    <segmentedlist>
     97      <segtitle>Installed programs</segtitle>
     98      <segtitle>Installed library</segtitle>
    8699
    87 <variablelist><bridgehead renderas="sect3">Short Descriptions</bridgehead>
    88 <?dbfo list-presentation="list"?>
    89 <?dbhtml list-presentation="table"?>
     100      <seglistitem>
     101        <seg>tclsh (link to tclsh8.4) and tclsh8.4</seg>
     102        <seg>libtcl8.4.so</seg>
     103      </seglistitem>
     104    </segmentedlist>
    90105
    91 <varlistentry id="tclsh8.4">
    92 <term><command>tclsh8.4</command></term>
    93 <listitem>
    94 <para>The Tcl command shell</para>
    95 <indexterm zone="ch-tools-tcl tclsh8.4"><primary sortas="b-tclsh8.4">tclsh8.4</primary></indexterm>
    96 </listitem>
    97 </varlistentry>
     106    <variablelist>
     107      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     108      <?dbfo list-presentation="list"?>
     109      <?dbhtml list-presentation="table"?>
    98110
    99 <varlistentry id="tclsh">
    100 <term><command>tclsh</command></term>
    101 <listitem>
    102 <para>A link to tclsh8.4</para>
    103 <indexterm zone="ch-tools-tcl tclsh"><primary sortas="b-tclsh">tclsh</primary></indexterm>
    104 </listitem>
    105 </varlistentry>
     111      <varlistentry id="tclsh8.4">
     112        <term><command>tclsh8.4</command></term>
     113        <listitem>
     114          <para>The Tcl command shell</para>
     115          <indexterm zone="ch-tools-tcl tclsh8.4">
     116            <primary sortas="b-tclsh8.4">tclsh8.4</primary>
     117          </indexterm>
     118        </listitem>
     119      </varlistentry>
    106120
    107 <varlistentry id="libtcl8.4.so">
    108 <term><filename class="libraryfile">libtcl8.4.so</filename></term>
    109 <listitem>
    110 <para>The Tcl library</para>
    111 <indexterm zone="ch-tools-tcl libtcl8.4.so"><primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary></indexterm>
    112 </listitem>
    113 </varlistentry>
    114 </variablelist>
     121      <varlistentry id="tclsh">
     122        <term><command>tclsh</command></term>
     123        <listitem>
     124          <para>A link to tclsh8.4</para>
     125          <indexterm zone="ch-tools-tcl tclsh">
     126            <primary sortas="b-tclsh">tclsh</primary>
     127          </indexterm>
     128        </listitem>
     129      </varlistentry>
    115130
    116 </sect2>
     131      <varlistentry id="libtcl8.4.so">
     132        <term><filename class="libraryfile">libtcl8.4.so</filename></term>
     133        <listitem>
     134          <para>The Tcl library</para>
     135          <indexterm zone="ch-tools-tcl libtcl8.4.so">
     136            <primary sortas="c-libtcl8.4.so">libtcl8.4.so</primary>
     137          </indexterm>
     138        </listitem>
     139      </varlistentry>
     140
     141    </variablelist>
     142
     143  </sect2>
    117144
    118145</sect1>
    119 
Note: See TracChangeset for help on using the changeset viewer.