--- loncom/publisher/lonupload.pm	2001/12/04 18:13:06	1.9
+++ loncom/publisher/lonupload.pm	2001/12/17 00:57:59	1.10
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # Handler to upload files into construction space
 #
-# $Id: lonupload.pm,v 1.9 2001/12/04 18:13:06 matthew Exp $
+# $Id: lonupload.pm,v 1.10 2001/12/17 00:57:59 harris41 Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -31,9 +31,11 @@
 # 
 # (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)
 #
@@ -41,6 +43,9 @@
 #
 # 04/05,04/09,05/25,06/23,06/24,08/22 Gerd Kortemeyer
 # 11/29 Matthew Hall
+# 12/16 Scott Harrison
+#
+###
 
 package Apache::lonupload;
 
@@ -49,7 +54,7 @@ use Apache::File;
 use File::Copy;
 use Apache::Constants qw(:common :http :methods);
 use Apache::loncacc;
-use Apache::lonnet;
+use Apache::loncommon();
 
 sub upfile_store {
     my $r=shift;
@@ -92,7 +97,7 @@ sub phaseone {
  '<input type=submit value="Store"></form>');
       # Check for bad extension and warn user
       if ($fn=~/\.(\w+)$/ && 
-	  (&Apache::lonnet::fileembstyle($1) eq 'hdn')) {
+	  (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {
 	  $r->print(
  '<font color=red>'.
  'The extension on this file, "'.$1.
@@ -100,7 +105,7 @@ sub phaseone {
  'Please change the extension.'.
  '</font>');
       } elsif($fn=~/\.(\w+)$/ && 
-	      !defined(&Apache::lonnet::fileembstyle($1))) {
+	      !defined(&Apache::loncommon::fileembstyle($1))) {
 	  $r->print(
  '<font color=red>'.
  'The extension on this file, "'.$1.
@@ -137,14 +142,14 @@ sub phasetwo {
 	                             '/tmp/'.$datatoken.'.tmp';
            # Check for bad extension and disallow upload
 	   if ($fn=~/\.(\w+)$/ && 
-	       (&Apache::lonnet::fileembstyle($1) eq 'hdn')) {
+	       (&Apache::loncommon::fileembstyle($1) eq 'hdn')) {
 	       $r->print(
  'File <tt>'.$fn.'</tt> could not be copied.<br />'.
  '<font color=red>'.
  'The extension on this file is reserved internally by LON-CAPA.'.
  '</font>');
 	   } elsif ($fn=~/\.(\w+)$/ && 
-		    !defined(&Apache::lonnet::fileembstyle($1))) {
+		    !defined(&Apache::loncommon::fileembstyle($1))) {
 	       $r->print(
  'File <tt>'.$fn.'</tt> could not be copied.<br />'.
  '<font color=red>'.
@@ -170,6 +175,7 @@ sub phasetwo {
   }
 }
 
+# ---------------------------------------------------------------- Main Handler
 sub handler {
 
   my $r=shift;
@@ -231,3 +237,76 @@ sub handler {
 
 1;
 __END__
+
+=head1 NAME
+
+Apache::lonupload - upload files into construction space
+
+=head1 SYNOPSIS
+
+Invoked by /etc/httpd/conf/srm.conf:
+
+ <Location /adm/upload>
+ PerlAccessHandler       Apache::lonacc
+ SetHandler perl-script
+ PerlHandler Apache::lonupload
+ ErrorDocument     403 /adm/login
+ ErrorDocument     404 /adm/notfound.html
+ ErrorDocument     406 /adm/unauthorized.html
+ ErrorDocument	  500 /adm/errorhandler
+ </Location>
+
+=head1 INTRODUCTION
+
+This module uploads a file sitting on a client computer into 
+library server construction space.
+
+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 *
+
+Initialize variables
+
+=item *
+
+Start page output
+
+=item *
+
+output relevant interface phase (phaseone or phasetwo)
+
+=item *
+
+(phase one is to specify upload file; phase two is to handle conditions
+subsequent to specification--like overwriting an existing file)
+
+=back
+
+=head1 OTHER SUBROUTINES
+
+=over 4
+
+=item *
+
+phaseone() : Interface for specifying file to upload.
+
+=item *
+
+phasetwo() : Interface for handling post-conditions about uploading (such
+as overwriting an existing file).
+
+=item *
+
+upfile_store() : Store contents of uploaded file into temporary space.  Invoked
+by phaseone subroutine.
+
+=back
+
+=cut