1Introduction
2------------
3
4Welcome to DejaGnu!
5
6DejaGnu is a framework for testing other programs. Its purpose is to
7provide a single front-end for all tests.  Beyond this, DejaGnu offers
8several advantages for testing:
9
10    * The flexibility and consistency of the DejaGnu framework make it
11      easy to write tests for any program.
12
13    * DejaGnu provides a layer of abstraction which makes all tests
14      portable to any host or target where a program must be tested.
15      For instance, a test for GDB can run (from any UNIX based host)
16      on any target architecture supported by DejaGnu.  DejaGnu has
17      run tests on several single board computers, whose operating
18      software ranges from a boot monitor to a fully-fledged,
19      UNIX-like realtime OS.
20
21    * DejaGnu is written in Expect, which in turn uses Tcl (Tool
22      command language).  The framework comprises two parts: the
23      testing framework and the testsuites themselves.  Tests are
24      usually written in Tcl and distributed with the programs, not
25      with DejaGnu.
26
27Installation
28------------
29
30For detailed instructions on installing DejaGnu, see the INSTALL file.
31
32Reporting bugs
33--------------
34
35If you think you have found a bug in DejaGnu, then please send a bug
36report.  Guidelines for reporting bugs can be found at:
37
38    http://www.gnu.org/software/dejagnu/#bug
39
40Documentation
41-------------
42
43The DejaGnu documentation is written in Texinfo. HTML and PDF versions
44of the current user manual are kept at:
45
46    http://www.gnu.org/software/dejagnu/#documentation
47
48GNU Info documentation is installed as part of the installation
49process.  You can read this by typing "info dejagnu".