Beta test distribution READ-ME file.
-----------------------------------

NOTE:  This software is NOT yet production-quality code.
THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.

Now, with that out of the way, let me point you to a few things:

The file TREE-GRAPH is a graphical representation of the source
directory tree you should receive with this distribution.

The file SOURCE-TREE describes what's in each directory.

The file BUGS is a short list of the known problems/restrictions of the
code in this distribution.

The file HOW-TO-HELP has some hints on how you can make the alpha test
beneficial for both MIT and your site.

You probably want to start by looking at the stuff in src/config/; pay
particular attention to Project.tmpl, site.def, and *.cf.  Much of the
configuration was blatantly stolen from the X11R4 distribution; if you
are familiar with that, you shouldn't have much trouble figuring out
things here.

We occasionally use FSF's C compiler, gcc, at Project Athena.  If you
have it as well, you can benefit from the use of function prototypes &
such.  HOWEVER, the configurations we used required that we create
function prototypes for essentially all of libc; we cannot redistribute
those prototypes as they are derived from the sources which are
encumbered by AT&T/BSD licenses.  If you wish to make your own
prototypes, I suggest you start with the source for the C lint library
and go from there.  Without the prototype you'll get lots of warnings like:
	warning: implicit declaration of function `foo'

The ANSI-ness of the code itself should be reasonable, but the header
file environment may be a bit strange, due to the lack of a true ANSI
environment here (stdarg, stdlib, etc).  If you have trouble, just
revert to a non-ANSI environment for a while, and let us know what you
encountered which wasn't properly ANSIfied.

We'd especially appreciate comments/insight from those porting to
non-BSD or non-Unix platforms, to see how well we separated the system
interface from the library code.  I suspect the hardest problems for
those ports will be dealing with the ASN.1 stuff.

We used the ISODE release 6.8 ASN.1 compiler for the code we have run
and tested here at MIT; the file tools/pepsy-diffs contains some patches
to the PEPSY compiler to eliminate some bugs in the generated code which
have caused us problems.

>>									     <<
>> Please report any problems/bugs/comments to 'krb5-bugs@athena.mit.edu'    <<
>>									     <<

Appreciation Time!!!!  Thanks to the members of the Kerberos V5
development team: Jay Berkenbilt, John Carr, Don Davis, Barry Jaspan,
John Kohl, Cliff Neuman, Jon Rochlis, Jeff Schiller, Ted Ts'o.  Thanks
to Dan Bernstein, for providing the replay cache code.  Thanks to Paul
Borman from Cray for writing the Kerberos v4 to v5 glue layer and the
Kerberos v5 subroutines for telnet.  Thanks to Bill Sommerfeld from HP
for commenting on early Kerberos interface drafts, suggesting
improvements in later coding interfaces, and finding and fixing many
bugs.  And finally, thanks to all of our Alpha testers for being brave
enough to try wading through green code.  :-)


Note:

Project Athena, Athena, Athena MUSE, Discuss, Hesiod, Kerberos, Moira, and 
Zephyr are trademarks of the Massachusetts Institute of Technology (MIT).  No 
commercial use of these trademarks may be made without prior written 
permission of MIT.
	
FYI, "commercial use" means use of a name in a product or other for-profit 
manner.  It does NOT prevent a commercial firm from referring to the MIT
trademarks in order to convey information (although in doing so, recognition
of their trademark status should be given).
