--- doc/krb_note.txt	2001/10/09 19:27:54	1.2
+++ doc/krb_note.txt	2002/07/28 04:29:51	1.3
@@ -1,24 +1,30 @@
+-------------------------------------------------------
 "Kerberos and LON-CAPA, The Way it Should Be Done"
-==================================================
+  contributed by Scott, sharrison@users.sourceforge.net
+  loncapa/doc/krb_note.txt
+-------------------------------------------------------
+
+This document should be read by those with experience
+administering RedHat Linux systems.
+
+NOTE: Most people will just use the LON-CAPA-krb4
+rpm (available from http://install.lon-capa.org/).
+You probably only would want to look at this document
+if you NEED kerberos (it is not necessary for many
+institutions)AND if you are installing on a NON-REDHAT
+operating system.
+
+Software dependencies:
+
+* You will likely need 'devel' rpms
+
+  RedHat 7.* note:
+  Need several devel rpms to compile kerberos...
+    db3-devel
+    db2-devel
+    libtermcap-devel
 
-produced by Penguin Dementia Publications (aka Scott)
-
-RedHat 7.1 note:
-Need several devel rpms to compile kerberos...
-   db3-devel
-   db2-devel
-   libtermcap-devel
-
-Ok, this is originally saved as doc/krb_note.txt in the
-CVS repository.
-
-Here is the build process, carved into stone
-(we've done this multiple ways in the past, including
-a crazily customized perl-kerberos-module Makefile_krb
-that is different than what is generated by
-"perl Makefile.PL").
-
-I'm trying to do this "the right way".  So here are the steps:
+Here are the steps:
 
 * Get the perl kerberos module from CPAN (http://www.cpan.org/)
   The module version I got was
@@ -27,13 +33,20 @@ I'm trying to do this "the right way".
 * Get athena-kerberos-version-4
   The tarball looks like this:
   krb4-0.10.1.tar
+  IT IS IMPORTANT THAT THIS IS THE SWEDISH VERSION, NOT THE MIT
+  VERSION.
+  NOTE THAT KERBEROS VERSION 4 IS A VERY DIFFERENT THING
+  THAN KERBEROS VERSION 5.  (Although newer versions of
+  Kerberos version 5 claim to be backwards compatible with
+  Kerberos version 4...we have not tested this yet.)
   
-On the world-wide web, an example URL to get this is
+  On the world-wide web, an example URL to get this is
   http://sunsite.ualberta.ca/pub/Mirror/kth-krb/src/
   Suffice it to say the tarball will likely be maintained/retained
   for sometime in the sunsite-->metalab-->ibiblio repository system
-  There are several more recent releases since Sept 1999, but
-  I'm not trying to change-everything-at-once right now.
+
+  There are several more recent releases since Sept 1999, perhaps
+  we should try to use them in the future.
 
 * Install athena-kerberos-version-4 by
   altering configure.in to read
@@ -43,32 +56,29 @@ On the world-wide web, an example URL to
 ---
 > AC_PREFIX_DEFAULT(/usr/athena)
      
-    /usr/local/krb4 is what you want on this line!!!!
+  In other words, /usr/local/krb4 is what you want on this line!!!!
 
-* generate new configure file by typing this command
+* Generate new configure file by typing this command:
  
    autoconf configure.in > configure
 
-* then of course 
+* Then, of course:
    ./configure
-* then
+* Then compile:
   make
-* then
+* Then install:
   make install
 
-The file listing of this will be in doc/otherfiles on the
-CVS repository (installed binaries).
-
-* the perl module will now install correctly
-  (before it hiccupped, coughed, was severely upset
-   due to kerberos being in /usr/athena as opposed to /usr/local/krb4)
+* The perl module will now install correctly
+  (otherwise it would have been severely upset
+   due to kerberos being in /usr/athena as opposed to /usr/local/krb4).
 
-* perl module installation is as usual
+* Perl module installation is as usual:
   perl Makefile.PL; make; make test; make install
 
-* go get a cup of coffee so you don't see all the weird warning
-  messages that flash at you
+* Go get a cup of coffee so you don't see all the weird warning
+  messages that flash at you.
 
-* it really works
+* It really works.