--- admin.txt	2001/09/26 21:33:09	1.5
+++ admin.txt	2002/07/03 08:23:47	1.6
@@ -1,14 +1,14 @@
 Document Manager Administration manual
 
 
-INSTALATION INSTRUCTIONS
-------------------------
+INSTALLATION INSTRUCTIONS
+-------------------------
 
 1. get latest version of Document Manager from
 	http://www.rot13.org/~dpavlin/docman.html
 
 2. go to installation directory (which doesn't have to be under your web
-   server) and untar distribution
+   server) and un-tar distribution
 
 	cd /home/httpd/docman
 	tar xvfz docman-*.tar.gz
@@ -17,7 +17,7 @@
    $gblIncDir to that directory in docman.php!
 
 3. go to directory which you want to have under Document Manager control
-   (this directory needs to be accessable from your web server tree)
+   (this directory needs to be accessible from your web server tree)
 
 	cd /home/httpd/html
 
@@ -43,7 +43,7 @@
    ensures that files won't be visible from Directory Manager interface.
 
 6a. (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
+   check if you got authorization request. If you did, you also have
    .htusers in same directory in which is .index.php
 
    edit .htusers file to add users. You can do that by calling adduser.pl
@@ -86,7 +86,7 @@
    is credentials for user which connects to database
 
 6c. (alternative to 6b you want to authorize users based on IP numbers,
-   client DNS names of HTTP Referarer header (URL from which they accessed
+   client DNS names of HTTP Referrer header (URI from which they accessed
    docman site). Put $gblUsers = "htusers_header"; in .docman.conf use
    following form in your .htusers file:
 
@@ -103,7 +103,7 @@
    you want to use and in which order
 
 7. (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
+   directory for some kind of motd file. You can use html mark-up in it
    also!
 
 8. (optional) Copy docman.conf into /home/httpd/html/.docman.conf and
@@ -119,7 +119,7 @@
 DIRECTORY AND FILE STRUCTURE
 ----------------------------
 
-Breakout of files in /home/httpd/docman/:
+Break-out of files in /home/httpd/docman/:
 
 docman.php	- main docman php file (to be installed as DirectoryIndex)
 
@@ -138,13 +138,13 @@
 docman.txt	- user documentation
 admin.txt	- administrator's documentation
 
-contrib/	- directory with optional usefull scripts
+contrib/	- directory with optional useful 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
+Break-out of files in /home/httpd/html/ (root directory of site under docman
 management):
 
 .changelog	- changes of files under docman management
@@ -158,7 +158,7 @@
 .bak/		- directory for backup copies of files
 .del/		- directory with deleted files
 .lock/		- directory with lock informations
-.log/		- directory with changelogs for each file
+.log/		- directory with change-logs for each file
 .note/		- directory with notes for files
 
 
@@ -168,3 +168,23 @@
 You can use document manager behind secure http server (https) simply by
 installing it. For information take a look at http://www.modssl.org
 
+
+HTUSERS FILE FORMAT
+-------------------
+
+.htusers file used by docman doesn't have same format as .htusers file used
+by web server. That's because docman's file have more information about
+user (include full name and e-mail address). Format of file is:
+
+# comment
+login:Full Name:password:email@domain.com
+
+for password, I use md5 sum of login and password appended together. So, If
+you want to create password and your login is 'foo' and password 'bar' you
+have following entry:
+
+foo:Foo Bar:3858f62230ac3c915f300c664312c63f:foo@bar.com
+
+Different htuser_* and auth_* modules can (and they actually do) re-use
+login, password and e-mail fields for it's own purpose.
+