source: BOOK/testsuite-tools/common/expect.xml @ 661d1a4

clfs-1.2clfs-2.1clfs-3.0.0-systemdclfs-3.0.0-sysvinitsystemdsysvinit
Last change on this file since 661d1a4 was 661d1a4, checked in by Jim Gifford <clfs@…>, 18 years ago

r3840@server (orig r1732): chris | 2006-06-05 22:54:28 -0700
Added -v switches to many more commands

  • Property mode set to 100644
File size: 4.0 KB
RevLine 
[3f8be484]1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3  "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4  <!ENTITY % general-entities SYSTEM "../../general.ent">
5  %general-entities;
6]>
7
[134ba96]8<sect1 id="ch-testsuite-tools-expect" role="wrap">
[3f8be484]9  <?dbhtml filename="expect.html"?>
10
11  <title>Expect-&expect-version;</title>
12
[134ba96]13  <indexterm zone="ch-testsuite-tools-expect">
[3f8be484]14    <primary sortas="a-Expect">Expect</primary>
15  </indexterm>
16
17  <sect2 role="package">
18    <title/>
19
20    <para>The Expect package contains a program for carrying out scripted
21    dialogues with other interactive programs.</para>
22
23  </sect2>
24
25  <sect2 role="installation">
26    <title>Installation of Expect</title>
27
28    <para os="a">First, fix a bug that can result in false failures during the GCC
29    test suite run:</para>
30
31<screen os="b"><userinput>patch -Np1 -i ../&expect-spawn-patch;</userinput></screen>
32
33    <para os="c">Now prepare Expect for compilation:</para>
34
[aa3ee8b]35<screen os="d"><userinput>./configure --prefix=/tools --with-tcl=/tools/lib \
[661d1a4]36    --with-tclinclude=/tools/include</userinput></screen>
[3f8be484]37
[aa3ee8b]38    <variablelist os="e">
[3f8be484]39      <title>The meaning of the configure options:</title>
40
[6bb43b3]41      <varlistentry os="e1">
[3f8be484]42        <term><parameter>--with-tcl=/tools/lib</parameter></term>
43        <listitem>
44          <para>This ensures that the configure script finds the Tcl
[134ba96]45          installation in the temporary testsuite-tools location.</para>
[3f8be484]46        </listitem>
47      </varlistentry>
48
[6bb43b3]49      <varlistentry os="e2">
[b15e6404]50        <term><parameter>--with-tclinclude=/tools/include</parameter></term>
[3f8be484]51        <listitem>
[b15e6404]52          <para>This explicitly tells Expect where to find Tcl's internal headers.
53           Using this option avoids conditions
[3f8be484]54          where <command>configure</command> fails because it cannot
55          automatically discover the location of the Tcl source directory.</para>
56        </listitem>
57      </varlistentry>
58
59    </variablelist>
60
[aa3ee8b]61    <para os="f">Build the package:</para>
[3f8be484]62
[aa3ee8b]63<screen os="g"><userinput>make</userinput></screen>
[3f8be484]64
[aa3ee8b]65    <para os="i">Install the package:</para>
[3f8be484]66
[aa3ee8b]67<screen os="j"><userinput>make SCRIPTS="" install</userinput></screen>
[3f8be484]68
[aa3ee8b]69    <variablelist os="k">
[3f8be484]70      <title>The meaning of the make parameter:</title>
71
72      <varlistentry>
73        <term><parameter>SCRIPTS=""</parameter></term>
74        <listitem>
75          <para>This prevents installation of the supplementary expect
76          scripts, which are not needed.</para>
77        </listitem>
78      </varlistentry>
79
80    </variablelist>
81
82  </sect2>
83
84  <sect2 id="contents-expect" role="content">
85    <title>Contents of Expect</title>
86
87    <segmentedlist>
88      <segtitle>Installed program</segtitle>
89      <segtitle>Installed library</segtitle>
90
91      <seglistitem>
92        <seg>expect</seg>
93        <seg>libexpect-&expect-lib-version;.a</seg>
94      </seglistitem>
95    </segmentedlist>
96
97    <variablelist>
98      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
99      <?dbfo list-presentation="list"?>
100      <?dbhtml list-presentation="table"?>
101
102      <varlistentry id="expect">
103        <term><command>expect</command></term>
104        <listitem>
105          <para>Communicates with other interactive programs according
106          to a script</para>
[134ba96]107          <indexterm zone="ch-testsuite-tools-expect expect">
[3f8be484]108            <primary sortas="b-expect">expect</primary>
109          </indexterm>
110        </listitem>
111      </varlistentry>
112
113      <varlistentry id="libexpect">
114        <term><filename class="libraryfile">libexpect-&expect-lib-version;.a</filename></term>
115        <listitem>
116          <para>Contains functions that allow Expect to be used as a Tcl
117          extension or to be used directly from C or C++ (without Tcl)</para>
[134ba96]118          <indexterm zone="ch-testsuite-tools-expect libexpect">
[3f8be484]119            <primary sortas="c-libexpect-&expect-lib-version;">libexpect-&expect-lib-version;</primary>
120          </indexterm>
121        </listitem>
122      </varlistentry>
123
124    </variablelist>
125
126  </sect2>
127
128</sect1>
Note: See TracBrowser for help on using the repository browser.