First off, the documentation seems badly out of date (apparently stopped at version 1.4, 2006).
Second, it has problems with its formatting and contents. Specifically:
2.4, p. 4
XFAIL is not defined. The paragraph supposed to give the definition talks about PASS and XPASS instead.
p.5
“you must avoid the setupxfail} procedure”
3.1, p. 6, Example 1
The expected output shown has incorrect line breaks (and a line truncated):
dgt:~/dejagnu.test$ runtest
WARNING: Couldn’t find the global config file.
WARNING: No tool specified Test
Run By dgt on Sun Nov 25 17:07:03 2001 Native configuration is i586-pc-linux-gnu
=== tests ===
Schedule of variations: unix
Running target unix Using /usr/share/dejagnu/baseboards/unix.exp as board description file f
Using /usr/share/dejagnu/config/unix.exp as generic interface file for target.
ERROR: Couldn’t find tool config file for unix.
=== Summary ===
Should instead be:
dgt:~/dejagnu.test$ runtest
WARNING: Couldn’t find the global config file.
WARNING: No tool specified
Test Run By dgt on Sun Nov 25 17:07:03 2001
Native configuration is i586-pc-linux-gnu
=== tests ===
Schedule of variations:
unix
Running target unix
Using /usr/share/dejagnu/baseboards/unix.exp as board description file for target.
Using /usr/share/dejagnu/config/unix.exp as generic interface file for target.
ERROR: Couldn’t find tool config file for unix.
=== Summary ===
The actual output of the test is somewhat different, but that may be because the version si now 1.5-3.
3.1.2, p. 7
/usr/share/doc/dejagnu/examples does not exist. Neither are the git sources of any help. Where are the dejagnu examples?
Daniel U. Thibault, M.Sc.²
Informaticien scientifique, CME-PSC, Centre de recherches de Valcartier
Recherche et développement pour la défense Canada / Gouvernement du Canada
Computer Scientist, MCCS-SPC, Valcartier Research Centre
Defence Research and Development Canada / Government of Canada
DRDC is an agency of the Department of National Defence / RDDC est une agence du ministère de la Défense nationale