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 59e47a1d0b99bbfcd692c66cff986c757242fd71..6e571c38af3ddd45b757945258bba701ddb7f784 100644 (file)
--- 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 b402154bee2d930186483d76321f69bd298d1946..0f942d14dd3a5b878e4a0fce41bc55ffb9805547 100644 (file)
--- 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