source: chapter08/dejagnu.xml@ 24fe054

11.1 11.2 11.2-rc1 arm multilib s6-init trunk xry111/arm64 xry111/clfs-ng xry111/lfs-next xry111/pip3 xry111/queue-11.3 xry111/rust-wip-20221008
Last change on this file since 24fe054 was 24fe054, checked in by Xi Ruoyao <xry111@…>, 10 months ago

dejagnu: add description for "dejagnu" command

  • Property mode set to 100644
File size: 3.2 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../general.ent">
5 %general-entities;
6]>
7
8<sect1 id="ch-system-dejagnu" role="wrap">
9 <?dbhtml filename="dejagnu.html"?>
10
11 <sect1info condition="script">
12 <productname>dejagnu</productname>
13 <productnumber>&dejagnu-version;</productnumber>
14 <address>&dejagnu-url;</address>
15 </sect1info>
16
17 <title>DejaGNU-&dejagnu-version;</title>
18
19 <indexterm zone="ch-system-dejagnu">
20 <primary sortas="a-DejaGNU">DejaGNU</primary>
21 </indexterm>
22
23 <sect2 role="package">
24 <title/>
25
26 <para>The <application>DejaGnu</application> package contains a framework for running test
27 suites on GNU tools. It is written in <command>expect</command>, which itself
28 uses <application>Tcl</application> (Tool Command Language).</para>
29
30 <segmentedlist>
31 <segtitle>&buildtime;</segtitle>
32 <segtitle>&diskspace;</segtitle>
33
34 <seglistitem>
35 <seg>&dejagnu-tmp-sbu;</seg>
36 <seg>&dejagnu-tmp-du;</seg>
37 </seglistitem>
38 </segmentedlist>
39
40 </sect2>
41
42 <sect2 role="installation">
43 <title>Installation of DejaGNU</title>
44
45 <para>The upstream recommends building DejaGNU in a dedicated build
46 directory:</para>
47
48<screen><userinput remap="pre">mkdir -v build
49cd build</userinput></screen>
50
51 <para>Prepare DejaGNU for compilation:</para>
52
53<screen><userinput remap="configure">../configure --prefix=/usr
54makeinfo --html --no-split -o doc/dejagnu.html ../doc/dejagnu.texi
55makeinfo --plaintext -o doc/dejagnu.txt ../doc/dejagnu.texi</userinput></screen>
56
57 <para>Build and install the package:</para>
58
59<screen><userinput remap="install">make install
60install -v -dm755 /usr/share/doc/dejagnu-&dejagnu-version;
61install -v -m644 doc/dejagnu.{html,txt} /usr/share/doc/dejagnu-&dejagnu-version;</userinput></screen>
62
63 <para>To test the results, issue:</para>
64
65<screen><userinput remap="test">make check</userinput></screen>
66
67 </sect2>
68
69
70 <sect2 id="contents-dejagnu" role="content">
71 <title>Contents of DejaGNU</title>
72
73 <segmentedlist>
74 <segtitle>Installed program</segtitle>
75
76 <seglistitem>
77 <seg>dejagnu and runtest</seg>
78 </seglistitem>
79 </segmentedlist>
80
81 <variablelist>
82 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
83 <?dbfo list-presentation="list"?>
84 <?dbhtml list-presentation="table"?>
85
86 <varlistentry id="dejagnu">
87 <term><command>dejagnu</command></term>
88 <listitem>
89 <para>DejaGNU auxiliary command launcher</para>
90 <indexterm zone="ch-system-dejagnu dejagnu">
91 <primary sortas="b-dejagnu">dejagnu</primary>
92 </indexterm>
93 </listitem>
94 </varlistentry>
95
96 <varlistentry id="runtest">
97 <term><command>runtest</command></term>
98 <listitem>
99 <para>A wrapper script that locates the proper
100 <command>expect</command> shell and then runs DejaGNU</para>
101 <indexterm zone="ch-system-dejagnu runtest">
102 <primary sortas="b-runtest">runtest</primary>
103 </indexterm>
104 </listitem>
105 </varlistentry>
106
107 </variablelist>
108
109 </sect2>
110
111</sect1>
Note: See TracBrowser for help on using the repository browser.