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".