--- admin.txt	2001/03/27 10:54:02	1.3
+++ admin.txt	2001/06/20 12:11:25	1.4
@@ -42,10 +42,11 @@
    It is important that new directory index file begins with dot -- that
    ensures that files won't be visible from Directory Manager interface.
 
-6. Go to you web server and check if you got autorization request. If you
-   did, you also have .htusers in same directory in which is .index.php
+6. (if you don't want to users in SQL database) Go to you web server and
+   check if you got autorization request. If you did, you also have
+   .htusers in same directory in which is .index.php
 
-7. edit .htusers file to add users. You can do that by calling adduser.pl
+   edit .htusers file to add users. You can do that by calling adduser.pl
    script. If you press just enter for password or enter auth_pop3
    docman will user e-mail address to connect to pop3 server and check
    password on it. For that e-mail address must be in following form:
@@ -56,6 +57,34 @@
    to enter invalid e-mail address it that's valid pop3 account. But, that
    WILL change, so you are warned!
 
+7. (alternative to 6 if your users are in SQL database) change $gblUsers
+   in .docman.conf to $gblUsers = "htusers_sql";
+
+   Download php-dbi class from http://pil.dk/downloads/dbi.tar.gz and
+   untar it in docman's directory
+
+	cd /home/html/docman
+	tar xvfz dbi.tar.gz
+
+   Construct SQL query which returns login, full name, password and
+   email from your tables(s). If you don't have some of that data, replace
+   them with literal strings.
+   
+   	e.g. if your table is called my_users with columns who in which
+	     is login and column pw in which is plain text password you
+	     can use following query to get requested format:
+		select who,'Auth user',pw,'nobody@com' from my_users
+
+   Enter that SQL query under $dbi_sql in .docman.conf
+
+   Construct $dbi in .docman.conf in following format:
+
+	$dbi = "driver:database:user:password"
+
+   driver can be: pgsql, mysql, oracle or odbc (as supported by php-dbi),
+   database is name of database in which are your users and user/password
+   is credentials for user which connects to database
+
 8. (optional) You can create file named .info.inc in /home/httpd/html
    directory for some kind of motd file. You can use html markup in it
    also!
@@ -76,20 +105,35 @@
 Breakout of files in /home/httpd/docman/:
 
 docman.php	- main docman php file (to be installed as DirectoryIndex)
+
+docman.conf	- configuration file which will be copied in document
+		  root of site
+
 auth_pop3.php	- authorization module ($gblIncDir in docman.php must point
 			to location of this file)
 
+htusers_file.php - module for access to users in .htusers files
+htusers_sql.php	- module for access to users which are in SQL database
+
 adduser.pl	- perl script for adding of users (you can also add users
 			manually by editing .htusers file)
 
 docman.txt	- user documentation
 admin.txt	- administrator's documentation
 
-Breakout of files in /home/httpd/html/:
+contrib/	- directory with optional usefull scripts
+
+dbi/		- optional directory for dbi classes is users are stored
+		  in SQL database, it will be created after unpacking of
+		  http://pil.dk/downloads/dbi.tar.gz
+
+Breakout of files in /home/httpd/html/ (root directory of site under docman
+management):
 
 .changelog	- changes of files under docman management
 .htusers	- file with users
 .info.inc	- file with MOTD which is included in interface
+.docman.conf	- configuration file for this site
 
 Files in each directory under docman management (some of them may be missing,
 they will be created automatically):