← Back to branch summary

~ubuntu-branches/ubuntu/warty/dejagnu/warty

« back to all changes in this revision

Viewing changes to doc/html/x1600.html

  • Committer: Bazaar Package Importer
  • Author(s): Daniel Jacobowitz
  • Date: 2004-02-09 15:07:58 UTC
  • Revision ID: james.westby@ubuntu.com-20040209150758-oaj7r5zrop60v8sb
Tags: upstream-1.4.4
Import upstream version 1.4.4

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/html/x1600.html
 
1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN">
 
2
<HTML
 
3
><HEAD
 
4
><TITLE
 
5
>Installation</TITLE
 
6
><META
 
7
NAME="GENERATOR"
 
8
CONTENT="Modular DocBook HTML Stylesheet Version 1.76b+
 
9
"><LINK
 
10
REL="HOME"
 
11
TITLE="DejaGnu"
 
12
HREF="book1.html"><LINK
 
13
REL="UP"
 
14
TITLE="Reference"
 
15
HREF="c1593.html"><LINK
 
16
REL="PREVIOUS"
 
17
TITLE="Reference"
 
18
HREF="c1593.html"><LINK
 
19
REL="NEXT"
 
20
TITLE="Builtin Procedures"
 
21
HREF="x1655.html"></HEAD
 
22
><BODY
 
23
CLASS="SECT1"
 
24
BGCOLOR="#FFFFFF"
 
25
TEXT="#000000"
 
26
LINK="#0000FF"
 
27
VLINK="#840084"
 
28
ALINK="#0000FF"
 
29
><DIV
 
30
CLASS="NAVHEADER"
 
31
><TABLE
 
32
SUMMARY="Header navigation table"
 
33
WIDTH="100%"
 
34
BORDER="0"
 
35
CELLPADDING="0"
 
36
CELLSPACING="0"
 
37
><TR
 
38
><TH
 
39
COLSPAN="3"
 
40
ALIGN="center"
 
41
>DejaGnu: The GNU Testing Framework</TH
 
42
></TR
 
43
><TR
 
44
><TD
 
45
WIDTH="10%"
 
46
ALIGN="left"
 
47
VALIGN="bottom"
 
48
><A
 
49
HREF="c1593.html"
 
50
ACCESSKEY="P"
 
51
>&#60;&#60;&#60; Previous</A
 
52
></TD
 
53
><TD
 
54
WIDTH="80%"
 
55
ALIGN="center"
 
56
VALIGN="bottom"
 
57
>Reference</TD
 
58
><TD
 
59
WIDTH="10%"
 
60
ALIGN="right"
 
61
VALIGN="bottom"
 
62
><A
 
63
HREF="x1655.html"
 
64
ACCESSKEY="N"
 
65
>Next &#62;&#62;&#62;</A
 
66
></TD
 
67
></TR
 
68
></TABLE
 
69
><HR
 
70
ALIGN="LEFT"
 
71
WIDTH="100%"></DIV
 
72
><DIV
 
73
CLASS="SECT1"
 
74
><H1
 
75
CLASS="SECT1"
 
76
><A
 
77
NAME="INSTALLATION"
 
78
></A
 
79
>Installation</H1
 
80
><P
 
81
>Once you have the DejaGnu source unpacked and available, you must
 
82
    first configure the software to specify where it is to run (and the
 
83
    associated defaults); then you can proceed to installing it.</P
 
84
><DIV
 
85
CLASS="SECT2"
 
86
><H2
 
87
CLASS="SECT2"
 
88
><A
 
89
NAME="CONFIGURING"
 
90
></A
 
91
>Configuring DejaGnu</H2
 
92
><P
 
93
>It is usually best to configure in a directory separate from the
 
94
      source tree, specifying where to find the source with the optional
 
95
      <I
 
96
CLASS="EMPHASIS"
 
97
>--srcdir</I
 
98
> option to
 
99
      <I
 
100
CLASS="EMPHASIS"
 
101
>configure</I
 
102
>. DejaGnu uses the GNU
 
103
      <I
 
104
CLASS="EMPHASIS"
 
105
>autoconf</I
 
106
> to configure itself. For more info on using
 
107
      autoconf, read the GNU autoconf manual. To configure, execute the
 
108
      <TT
 
109
CLASS="FILENAME"
 
110
>configure</TT
 
111
> program, no other options are
 
112
      required. For an example, to configure in a seperate tree for objects,
 
113
      execute the configure script from the source tree like this:</P
 
114
><TABLE
 
115
BORDER="0"
 
116
BGCOLOR="#E0E0E0"
 
117
WIDTH="100%"
 
118
><TR
 
119
><TD
 
120
><PRE
 
121
CLASS="SCREEN"
 
122
>        ../dejagnu-1.4.4/configure
 
123
      </PRE
 
124
></TD
 
125
></TR
 
126
></TABLE
 
127
><P
 
128
>DejaGnu doesn't care at config time if it's for testing a native
 
129
      system or a cross system. That is determined at runtime by using the
 
130
      config files.</P
 
131
><P
 
132
>You may also want to use the <B
 
133
CLASS="COMMAND"
 
134
>configure</B
 
135
> option
 
136
      <I
 
137
CLASS="EMPHASIS"
 
138
>--prefix</I
 
139
> to specify where you want DejaGnu and its
 
140
      supporting code installed.  By default, installation is in subdirectories
 
141
      of <TT
 
142
CLASS="FILENAME"
 
143
>/usr/local</TT
 
144
>, but you can select any alternate
 
145
      directory <SPAN
 
146
CLASS="SYMBOL"
 
147
>altdir</SPAN
 
148
> by including
 
149
      <TT
 
150
CLASS="OPTION"
 
151
>--prefix</TT
 
152
>{altdir}} on the
 
153
      <B
 
154
CLASS="COMMAND"
 
155
>configure</B
 
156
> command line. (This value is captured in
 
157
      the Makefile variables <I
 
158
CLASS="EMPHASIS"
 
159
>prefix</I
 
160
> and
 
161
      <I
 
162
CLASS="EMPHASIS"
 
163
>exec</I
 
164
>prefix}.)</P
 
165
><P
 
166
>Save for a small number of example tests, the DejaGnu distribution
 
167
      itself does not include any testsuites; these are available
 
168
      separately. Testsuites for the GNU development tools are included in
 
169
      those releases. After configuring the top-level DejaGnu directory, unpack
 
170
      and configure the test directories for the tools you want to test; then,
 
171
      in each test directory, run <I
 
172
CLASS="EMPHASIS"
 
173
>make check</I
 
174
> to build
 
175
      auxiliary programs required by some of the tests, and run the test
 
176
      suites.</P
 
177
></DIV
 
178
><DIV
 
179
CLASS="SECT2"
 
180
><H2
 
181
CLASS="SECT2"
 
182
><A
 
183
NAME="INSTALLING"
 
184
></A
 
185
>Installing DejaGnu</H2
 
186
><P
 
187
>To install DejaGnu in your filesystem (either in
 
188
      <TT
 
189
CLASS="FILENAME"
 
190
>/usr/local</TT
 
191
>, or as specified by your
 
192
      <I
 
193
CLASS="EMPHASIS"
 
194
>--prefix</I
 
195
> option to <I
 
196
CLASS="EMPHASIS"
 
197
>configure</I
 
198
>),
 
199
      execute.</P
 
200
><TABLE
 
201
BORDER="0"
 
202
BGCOLOR="#E0E0E0"
 
203
WIDTH="100%"
 
204
><TR
 
205
><TD
 
206
><PRE
 
207
CLASS="SCREEN"
 
208
>        eg$ make install
 
209
      </PRE
 
210
></TD
 
211
></TR
 
212
></TABLE
 
213
><P
 
214
><I
 
215
CLASS="EMPHASIS"
 
216
>make install</I
 
217
>does thes things for
 
218
      DejaGnu:</P
 
219
><P
 
220
></P
 
221
><UL
 
222
><LI
 
223
STYLE="list-style-type: disc"
 
224
><P
 
225
>Look in the path specified for executables
 
226
          <SPAN
 
227
CLASS="SYMBOL"
 
228
>$exec_prefix</SPAN
 
229
>) for directories called
 
230
          <TT
 
231
CLASS="FILENAME"
 
232
>lib</TT
 
233
> and <TT
 
234
CLASS="FILENAME"
 
235
>bin</TT
 
236
>. If these
 
237
          directories do not exist, <I
 
238
CLASS="EMPHASIS"
 
239
>make install</I
 
240
> creates
 
241
          them.</P
 
242
></LI
 
243
><LI
 
244
STYLE="list-style-type: disc"
 
245
><P
 
246
>Create another directory in the
 
247
        <TT
 
248
CLASS="FILENAME"
 
249
>share</TT
 
250
> directory, called
 
251
        <TT
 
252
CLASS="FILENAME"
 
253
>dejagnu</TT
 
254
>, and copy all the library files into
 
255
        it.</P
 
256
></LI
 
257
><LI
 
258
STYLE="list-style-type: disc"
 
259
><P
 
260
>Create a directory in the
 
261
        <TT
 
262
CLASS="FILENAME"
 
263
>dejagnu/share</TT
 
264
> directory, called
 
265
        <TT
 
266
CLASS="FILENAME"
 
267
>config</TT
 
268
>, and copy all the configuration files into
 
269
        it.</P
 
270
></LI
 
271
><LI
 
272
STYLE="list-style-type: disc"
 
273
><P
 
274
>Copy the <I
 
275
CLASS="EMPHASIS"
 
276
>runtest</I
 
277
> shell script into
 
278
        <TT
 
279
CLASS="FILENAME"
 
280
>$exec_prefix/bin</TT
 
281
>.</P
 
282
></LI
 
283
><LI
 
284
STYLE="list-style-type: disc"
 
285
><P
 
286
>Copy <TT
 
287
CLASS="FILENAME"
 
288
>runtest.exp</TT
 
289
> into
 
290
        <TT
 
291
CLASS="FILENAME"
 
292
>$exec_prefix/lib/dejagnu</TT
 
293
>. This is the main Tcl
 
294
        code implementing DejaGnu.</P
 
295
></LI
 
296
></UL
 
297
></DIV
 
298
></DIV
 
299
><DIV
 
300
CLASS="NAVFOOTER"
 
301
><HR
 
302
ALIGN="LEFT"
 
303
WIDTH="100%"><TABLE
 
304
SUMMARY="Footer navigation table"
 
305
WIDTH="100%"
 
306
BORDER="0"
 
307
CELLPADDING="0"
 
308
CELLSPACING="0"
 
309
><TR
 
310
><TD
 
311
WIDTH="33%"
 
312
ALIGN="left"
 
313
VALIGN="top"
 
314
><A
 
315
HREF="c1593.html"
 
316
ACCESSKEY="P"
 
317
>&#60;&#60;&#60; Previous</A
 
318
></TD
 
319
><TD
 
320
WIDTH="34%"
 
321
ALIGN="center"
 
322
VALIGN="top"
 
323
><A
 
324
HREF="book1.html"
 
325
ACCESSKEY="H"
 
326
>Home</A
 
327
></TD
 
328
><TD
 
329
WIDTH="33%"
 
330
ALIGN="right"
 
331
VALIGN="top"
 
332
><A
 
333
HREF="x1655.html"
 
334
ACCESSKEY="N"
 
335
>Next &#62;&#62;&#62;</A
 
336
></TD
 
337
></TR
 
338
><TR
 
339
><TD
 
340
WIDTH="33%"
 
341
ALIGN="left"
 
342
VALIGN="top"
 
343
>Reference</TD
 
344
><TD
 
345
WIDTH="34%"
 
346
ALIGN="center"
 
347
VALIGN="top"
 
348
><A
 
349
HREF="c1593.html"
 
350
ACCESSKEY="U"
 
351
>Up</A
 
352
></TD
 
353
><TD
 
354
WIDTH="33%"
 
355
ALIGN="right"
 
356
VALIGN="top"
 
357
>Builtin Procedures</TD
 
358
></TR
 
359
></TABLE
 
360
></DIV
 
361
></BODY
 
362
></HTML
 
363
>
 
 
b'\\ No newline at end of file'