.\"
.\"	aegis - project change supervisor
.\"	Copyright (C) 1999, 2001 Peter Miller;
.\"	All rights reserved.
.\"
.\"	This program is free software; you can redistribute it and/or modify
.\"	it under the terms of the GNU General Public License as published by
.\"	the Free Software Foundation; either version 2 of the License, or
.\"	(at your option) any later version.
.\"
.\"	This program is distributed in the hope that it will be useful,
.\"	but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"	GNU General Public License for more details.
.\"
.\"	You should have received a copy of the GNU General Public License
.\"	along with this program; if not, write to the Free Software
.\"	Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
.\"
.\" MANIFEST: document describing lib/en/user-guide/c11.0s
.\"
.bp
.if t .2C
.nh 1 "Testing"
.LP
This chapter discusses testing, and using Aegis to manage your tests
and testing.
.so c11.1.so
.so c11.2.so
.\"
.\" Sam Liddicott <sam.liddicott@ananova.com>, Wed, 24 Jan 2001 12:15:03 -0000
.\" o> it would be nice to have a way to specify a timeout for aegis tests.
.\" > If a single test does not finish within this time, it should be
.\" > aborted and considered `No Result'.  Then aet should continue with the
.\" > next test (as appropriate if --perservere was given).
.\"
.\" You could implement this in the tests themselves.
.\"
.\" A shell function to do this:
.\"
.\" killme() {
.\"   timeout="$1"
.\"     parent="$$"
.\"
.\"       ( sleep $timeout ; kill $parent; sleep 2; kill -9 $parent; )
.\"         echo $!
.\" 	}
.\"
.\"
.\" 	to use it
.\"
.\" 	killer=`killme 600` # 10 minutes
.\"
.\" Jerry Pendergraft <jerry@endocardial.com>
.\" Fri, 26 Jan 2001 08:52:58 -0600
.\"
.\" test_command = \
.\" "PATH=${Add_Path_Suffix /${arch}/bin ${search_path_executable}}:${$}PATH \
.\"  ${sh} ${file_name}";
.\"  Then when a test (.sh) file calls the program it is testing
.\"  > it is called
.\"  > by name only and is found in the path. It works to any level
.\"  > of branches
.\"  > and we have had as many as 5 so far.