|
Packit |
62fe53 |
Introduction
|
|
Packit |
62fe53 |
------------
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
Welcome to DejaGnu!
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
DejaGnu is a framework for testing other programs. Its purpose is to
|
|
Packit |
62fe53 |
provide a single front-end for all tests. Beyond this, DejaGnu offers
|
|
Packit |
62fe53 |
several advantages for testing:
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
* The flexibility and consistency of the DejaGnu framework make it
|
|
Packit |
62fe53 |
easy to write tests for any program.
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
* DejaGnu provides a layer of abstraction which makes all tests
|
|
Packit |
62fe53 |
portable to any host or target where a program must be tested.
|
|
Packit |
62fe53 |
For instance, a test for GDB can run (from any UNIX based host)
|
|
Packit |
62fe53 |
on any target architecture supported by DejaGnu. DejaGnu has
|
|
Packit |
62fe53 |
run tests on several single board computers, whose operating
|
|
Packit |
62fe53 |
software ranges from a boot monitor to a fully-fledged,
|
|
Packit |
62fe53 |
UNIX-like realtime OS.
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
* DejaGnu is written in Expect, which in turn uses Tcl (Tool
|
|
Packit |
62fe53 |
command language). The framework comprises two parts: the
|
|
Packit |
62fe53 |
testing framework and the testsuites themselves. Tests are
|
|
Packit |
62fe53 |
usually written in Tcl and distributed with the programs, not
|
|
Packit |
62fe53 |
with DejaGnu.
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
Installation
|
|
Packit |
62fe53 |
------------
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
For detailed instructions on installing DejaGnu, see the INSTALL file.
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
Reporting bugs
|
|
Packit |
62fe53 |
--------------
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
If you think you have found a bug in DejaGnu, then please send a bug
|
|
Packit |
62fe53 |
report. Guidelines for reporting bugs can be found at:
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
http://www.gnu.org/software/dejagnu/#bug
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
Documentation
|
|
Packit |
62fe53 |
-------------
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
The DejaGnu documentation is written in Docbook/XML. The Makefile
|
|
Packit |
62fe53 |
does not render the documentation into other formats by default, as
|
|
Packit |
62fe53 |
this requires a range of Docbook packages to be installed. The
|
|
Packit |
62fe53 |
intention is that this will be done by the maintainers when a release
|
|
Packit |
62fe53 |
is made. HTML, RTF, PostScript and PDF versions of the current user
|
|
Packit |
62fe53 |
manual are kept on the web at:
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
http://www.gnu.org/software/dejagnu/#documentation
|
|
Packit |
62fe53 |
|
|
Packit |
62fe53 |
Info documentation is installed on a system as part of the
|
|
Packit |
62fe53 |
installation process. You can read this by typing "info dejagnu".
|