From: Ezra Peisach <epeisach@mit.edu>
Date: Fri, 8 Mar 1996 14:44:23 +0000 (+0000)
Subject: Add comments about the DejaGnu tests
X-Git-Tag: krb5-1.0-beta6~401
X-Git-Url: http://git.tremily.us/?a=commitdiff_plain;h=4aa5163a4439d1a841e578c8a5756178535c51dd;p=krb5.git

Add comments about the DejaGnu tests

git-svn-id: svn://anonsvn.mit.edu/krb5/trunk@7599 dc483132-0cff-0310-8789-dd5450dbe970
---

diff --git a/doc/ChangeLog b/doc/ChangeLog
index 59e47a1d0..6e571c38a 100644
--- a/doc/ChangeLog
+++ b/doc/ChangeLog
@@ -1,3 +1,7 @@
+Fri Mar  8 09:43:13 1996  Ezra Peisach  <epeisach@kangaroo.mit.edu>
+
+	* install.texi (The DejaGnu Tests): Describe the DejaGnu tests.
+
 Mon Oct 30 16:58:54 1995  Ezra Peisach  <epeisach@kangaroo.mit.edu>
 
 	* install.texi: Fix all path names, spelling check, convert tabs
diff --git a/doc/install.texi b/doc/install.texi
index b402154be..0f942d14d 100644
--- a/doc/install.texi
+++ b/doc/install.texi
@@ -158,6 +158,10 @@ Doing the Build
 * Building with Separate Build Directories::  
 * Building using lndir::        
 
+Testing the Build
+
+* The DejaGnu Tests::           
+
 Shared Library Support
 
 * Shared Library Theory::       
@@ -582,6 +586,37 @@ building Kerberos; see @ref{Doing the Build}.):
 % @b{make check}
 @end example
 
+@menu
+* The DejaGnu Tests::           
+@end menu
+
+@node The DejaGnu Tests,  , Testing the Build, Testing the Build
+@subsection The DejaGnu Tests 
+
+Some of the built-in regression tests are setup to use the DejaGnu
+framework for running tests. These tests tend to be more comprehensive
+than the normal built-in tests as they setup test servers and test
+client/server activities. 
+
+DejaGnu may be found wherever GNU software is archived. 
+
+Most of the tests are setup to run as a non-privledged user. There are
+two series of tests (rlogind and telnetd) which require the ability to
+@samp{rlogin} as root to the local machine. Admittedly, this does
+require the use of a @file{.rhosts} file or some other authenticated
+means. @footnote{If you are fortunate enough to have a previous version
+of Kerberos V5 or V4 installed, and the Kerberos rlogin is first in your
+path, you can setup @file{.k5login} or @file{.klogin} as appropriate to
+allow you access.}
+
+If you cannot obtain root access to your machine, all the other tests
+will still run. Note however, with DejaGnu 1.2, the "untested testcases"
+will cause the testsuite to exit with a non-zero exit status which
+@samp{make} will consider a failure of the testing process. Do not worry
+about this, as these tests are the last run when @samp{make check} is
+executed from the top level of the build tree.
+
+
 @node Options to Configure, osconf.h, Testing the Build, Building Kerberos
 @section Options to Configure