--- loncom/publisher/lonpubdir.pm	2001/12/04 15:34:57	1.16
+++ loncom/publisher/lonpubdir.pm	2001/12/15 20:48:47	1.17
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # (Publication Handler
 #
-# $Id: lonpubdir.pm,v 1.16 2001/12/04 15:34:57 albertel Exp $
+# $Id: lonpubdir.pm,v 1.17 2001/12/15 20:48:47 harris41 Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -28,13 +28,17 @@
 # 
 # (TeX Content Handler
 #
+# YEAR=2000
 # 05/29/00,05/30,10/11 Gerd Kortemeyer)
 #
 # 11/28,11/29,11/30,12/01,12/02,12/04,12/23 Gerd Kortemeyer
+# YEAR=2001
 # 03/23 Guy Albertelli
 # 03/24,03/29 Gerd Kortemeyer)
-#
 # 03/31,04/03,05/09,06/23,08/18,08/20 Gerd Kortemeyer
+# 12/15 Scott Harrison
+#
+###
 
 package Apache::lonpubdir;
 
@@ -43,8 +47,7 @@ use Apache::File;
 use File::Copy;
 use Apache::Constants qw(:common :http :methods);
 use Apache::loncacc;
-use Apache::lonnet;
-
+use Apache::loncommon();
 
 sub handler {
 
@@ -137,7 +140,7 @@ sub handler {
  '</a></td><td>'.localtime($cmtime).'</td><td>&nbsp;</td><td>&nbsp;</td></tr>'
            );
          }
-     } elsif (&Apache::lonnet::fileembstyle($extension) ne 'hdn') {
+     } elsif (&Apache::loncommon::fileembstyle($extension) ne 'hdn') {
          my $status='Unpublished';
          my $bgcol='#FFBBBB';
          if (-e $resdir.'/'.$filename) {
@@ -152,7 +155,7 @@ sub handler {
                 $status='Modified';
                 $bgcol='#FFFFBB';
                 if 
-            (&Apache::lonnet::fileembstyle(($filename=~/\.(\w+)$/)) eq 'ssi') {
+         (&Apache::loncommon::fileembstyle(($filename=~/\.(\w+)$/)) eq 'ssi') {
                    $status.='<br><a href="/adm/diff?filename=/~'.$uname.
                                          $thisdisfn.'/'.$filename.
 		       '&versionone=priv" target=cat>Diffs</a>';
@@ -179,3 +182,67 @@ sub handler {
 
 1;
 __END__
+
+=head1 NAME
+
+Apache::lonpubdir - Publication Handler for Directories
+
+=head1 SYNOPSIS
+
+Invoked (for various locations) by /etc/httpd/conf/srm.conf:
+
+<LocationMatch "^/\~.*/$">
+PerlAccessHandler       Apache::loncacc
+SetHandler perl-script
+PerlHandler Apache::lonpubdir
+ErrorDocument     403 /adm/login
+ErrorDocument     404 /adm/notfound.html
+ErrorDocument     406 /adm/unauthorized.html
+ErrorDocument	  500 /adm/errorhandler
+</LocationMatch>
+
+<Location /adm/pubdir>
+PerlAccessHandler       Apache::lonacc
+SetHandler perl-script
+PerlHandler Apache::lonpubdir
+ErrorDocument     403 /adm/login
+ErrorDocument     404 /adm/notfound.html
+ErrorDocument     406 /adm/unauthorized.html
+ErrorDocument	  500 /adm/errorhandler
+</Location>
+
+=head1 INTRODUCTION
+
+This module enables cookie based authentication and is used
+to control access for many different LON-CAPA URIs.
+
+Whenever the client sends the cookie back to the server, 
+this cookie is handled by either lonacc.pm or loncacc.pm
+(see srm.conf for what is invoked when).  If
+the cookie is missing or invalid, the user is re-challenged
+for login information.
+
+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 *
+
+read in information
+
+=item *
+
+start page output
+
+=item *
+
+run through list of files and attempt to publish unhidden files
+
+=back
+
+=cut