--- loncom/homework/lonhomework.pm	2008/10/07 10:13:06	1.298
+++ loncom/homework/lonhomework.pm	2008/11/25 13:16:17	1.300
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # The LON-CAPA Homework handler
 #
-# $Id: lonhomework.pm,v 1.298 2008/10/07 10:13:06 foxr Exp $
+# $Id: lonhomework.pm,v 1.300 2008/11/25 13:16:17 jms Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -25,6 +25,25 @@
 #
 # http://www.lon-capa.org/
 
+=pod
+
+=head1 NAME
+
+Apache::lonhomework.pm
+
+=head1 SYNOPSIS
+
+handles requests for output, evaluation, and
+alteration of a homework resource
+
+This is part of the LearningOnline Network with CAPA project
+described at http://www.lon-capa.org.
+
+
+=head1 NOTABLE SUBROUTINES
+
+=cut
+
 
 package Apache::lonhomework;
 use strict;
@@ -85,14 +104,20 @@ sub set_bubble_lines {
     }
 }
 
-#
-# Decides what targets to render for.
-# Implicit inputs:
-#   Various session environment variables:
-#      request.state -  published  - is a /res/ resource
-#                       uploaded   - is a /uploaded/ resource
-#                       contruct   - is a /priv/ resource
-#      form.grade_target - a form parameter requesting a specific target
+=pod
+
+=item get_target()
+
+Decides what targets to render for.
+Implicit inputs:
+  Various session environment variables:
+     request.state -  published  - is a /res/ resource
+                      uploaded   - is a /uploaded/ resource
+                      contruct   - is a /priv/ resource
+     form.grade_target - a form parameter requesting a specific target
+
+=cut
+
 sub get_target {
     &Apache::lonxml::debug("request.state = $env{'request.state'}");
     if( defined($env{'form.grade_target'})) {
@@ -331,8 +356,16 @@ sub check_slot_access {
     return ($slotstatus,$datemsg,$slot_name,$returned_slot);
 }
 
-# JB, 9/24/2002: Any changes in this function may require a change
-# in lonnavmaps::resource::getDateStatus.
+
+=pod
+
+=item check_access()
+
+JB, 9/24/2002: Any changes in this function may require a change
+in lonnavmaps::resource::getDateStatus.
+
+=cut
+
 sub check_access {
     my ($id) = @_;
     my $date ='';
@@ -480,7 +513,16 @@ sub check_access {
 
     return ($status,$datemsg);
 }
-# this should work exactly like the copy in lonnavmaps.pm
+
+
+=pod 
+
+=item due_date()
+
+    this should work exactly like the copy in lonnavmaps.pm
+
+=cut
+
 sub due_date {
     my ($part_id,$symb,$udom,$uname)=@_;
     my $date;
@@ -938,9 +980,14 @@ sub editxmlmode {
     return '';
 }
 
-#
-#    Render the page in whatever target desired.
-#
+=pod
+
+=item renderpage()
+
+    Render the page in whatever target desired.
+
+=cut
+
 sub renderpage {
     my ($request,$file,$targets,$return_string) = @_;