--- a/doc/customizing.txt	Thu Mar 03 00:52:49 2005 +0000
+++ b/doc/customizing.txt	Thu Mar 03 02:18:02 2005 +0000
@@ -2,7 +2,7 @@
 Customising Roundup
 ===================
 
-:Version: $Revision: 1.172 $
+:Version: $Revision: 1.173 $
 
 .. This document borrows from the ZopeBook section on ZPT. The original is at:
    http://www.zope.org/Documentation/Books/ZopeBook/current/ZPT.stx
@@ -3246,6 +3246,12 @@
 Using an external password validation source
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+.. note:: You will need to either have an "admin" user in your external
+          password source *or* have one of your regular users have
+          the Admin Role assigned. If you need to assign the Role *after*
+          making the changes below, you may use the ``roundup-admin``
+          program to edit a user's details.
+
 We have a centrally-managed password changing system for our users. This
 results in a UN*X passwd-style file that we use for verification of
 users. Entries in the file consist of ``name:password`` where the
@@ -3262,6 +3268,7 @@
 following is added as ``externalpassword.py`` in the tracker ``extensions``
 directory::
 
+    import os, crypt
     from roundup.cgi.actions import LoginAction    
 
     class ExternalPasswordLoginAction(LoginAction):
@@ -3342,8 +3349,8 @@
 
 Next we read in the *passwd* file from the tracker home::
 
-    # read in the users
-    file = os.path.join(tracker_home, 'users.passwd')
+    # read in the users from the "passwd.txt" file
+    file = os.path.join(tracker_home, 'passwd.txt')
     users = [x.strip().split(':') for x in open(file).readlines()]
 
 Handle special users (those to ignore in the file, and those who don't