pull up r18441 from trunk

 r18441@cathode-dark-space:  rra | 2006-08-15 18:27:17 -0400
 Ticket: new
 Subject: Document prerequisites for make check
 Component: krb5-doc
 Tags: pullup
 Version_Reported: 1.5
 Target_Version: 1.5.1
 
 Document the prerequisites for running make check, since some of them are
 a bit surprising.
 

ticket: 4499
version_fixed: 1.5.2

git-svn-id: svn://anonsvn.mit.edu/krb5/branches/krb5-1-5@18741 dc483132-0cff-0310-8789-dd5450dbe970

1 files changed, 23 insertions, 0 deletions

diff --git a/doc/build.texinfo b/doc/build.texinfo
index 8e7aed9..f92a4d2 100644
--- a/doc/build.texinfo
+++ b/doc/build.texinfo
@@ -387,6 +387,29 @@ building Kerberos; see @ref{Doing the Build}.):
 % make check
 @end example
 
+However, there are several prerequisites that must be satisfied first:
+
+@itemize @bullet
+@item
+Configure and build Kerberos with Tcl support.  Tcl is used to drive the
+test suite.  This often means passing @code{--with-tcl} to configure to
+tell it the location of the Tcl configuration script.  (See
+@xref{Options to Configure}.)
+
+@item
+You have to run @samp{make install} before running @samp{make check}, or
+the test suite will often pick up the installed version of Kerberos
+rather than the newly built one.  You can install into a prefix that
+isn't in the system library search path, though.  This theoretically
+could be fixed with the appropriate environment variable magic in the
+test suite, but hasn't been yet.
+
+@item
+In order to test the RPC layer, the local system has to be running the
+@command{portmap} daemon and it has to be listening to the regular
+network interface (not just localhost).
+@end itemize
+
 @menu
 * The DejaGnu Tests::           
 * The KADM5 Tests::