--- loncom/auth/lonracc.pm	2001/11/29 19:12:44	1.3
+++ loncom/auth/lonracc.pm	2002/01/17 19:25:31	1.4
@@ -1,7 +1,7 @@
 # The LearningOnline Network
 # Access Handler for File Transfers
 #
-# $Id: lonracc.pm,v 1.3 2001/11/29 19:12:44 www Exp $
+# $Id: lonracc.pm,v 1.4 2002/01/17 19:25:31 harris41 Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -73,6 +73,50 @@ sub handler {
 1;
 __END__
 
+=head1 NAME
+
+Apache::lonracc - Access Handler for File Transfers
+
+=head1 SYNOPSIS
+
+Invoked by /etc/httpd/conf/loncapa.conf:
+
+ <LocationMatch "^/raw.*">
+ PerlAccessHandler Apache::lonracc
+ </LocationMatch>
+
+=head1 INTRODUCTION
+
+This module enables authentication for file transfers and works
+against the /res tree.
+
+Only lond invokes the /raw namespace through its subscribe function.
+
+This is part of the LearningOnline Network with CAPA project
+described at http://www.lon-capa.org.
+
+=head1 HANDLER SUBROUTINE
+
+This routine is called by Apache and mod_perl.
+
+=over 4
+
+=item *
+
+Determine requesting host
+
+=item *
+
+See whether or not the requesting host is subscribed.
+
+=item *
+
+Respond with status of request and make log entry in case of unallowed
+access.
+
+=back
+
+=cut