--- loncom/homework/imageresponse.pm	2008/03/12 02:46:53	1.93
+++ loncom/homework/imageresponse.pm	2008/11/12 20:01:21	1.95
@@ -2,7 +2,7 @@
 # The LearningOnline Network with CAPA
 # image click response style
 #
-# $Id: imageresponse.pm,v 1.93 2008/03/12 02:46:53 raeburn Exp $
+# $Id: imageresponse.pm,v 1.95 2008/11/12 20:01:21 jms Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -29,6 +29,152 @@
 #FIXME LATER assumes multiple possible submissions but only one is possible 
 #currently
 
+
+=head1 NAME
+
+Apache::imageresponse
+
+=head1 SYNOPSIS
+
+Coordinates the response to clicking an image.
+
+This is part of the LearningOnline Network with CAPA project
+described at http://www.lon-capa.org.
+
+=head1 HANDLER SUBROUTINE
+
+
+
+=head1 OTHER SUBROUTINES
+
+=over
+
+=item *
+
+start_imageresponse()
+
+=item *
+
+end_imageresponse()
+
+=item *
+
+start_foilgroup()
+
+=item *
+
+getfoilcounts()
+
+=item *
+
+whichfoils()
+
+=item *
+
+prep_image()
+
+=item *
+
+draw_image()
+
+=item *
+
+displayfoils()
+
+=item *
+
+format_prior_response()
+
+=item *
+
+display_answers()
+
+=item *
+
+clean_up_image()
+
+=item *
+
+gradefoils()
+
+=item *
+
+stringify_submission()
+
+=item *
+
+get_submission()
+
+=item *
+
+end_foilgroup()
+
+=item *
+
+start_conceptgroup()
+
+=item *
+
+end_conceptgroup()
+
+=item *
+
+insert_foil()
+
+=item *
+
+start_foil()
+
+=item *
+
+end_foil()
+
+=item *
+
+start_text()
+
+=item *
+
+end_text()
+
+=item *
+
+start_image()
+
+
+=item *
+
+end_image()
+
+=item *
+
+start_rectangle()
+
+=item *
+
+grade_rectangle()
+
+=item *
+
+end_rectangle()
+
+=item *
+
+start_polygon()
+
+=item *
+
+grade_polygon()
+
+=item *
+
+end_polygon()
+
+=back
+
+=cut
+
+
 package Apache::imageresponse;
 use strict;
 use Image::Magick();
@@ -367,7 +513,7 @@ sub gradefoils {
 		} elsif ($1 eq 'polygon') {
 		    $grade=&grade_polygon($area,$x,$y);
 		} else {
-		    &Apache::lonxml::error("Unknown area style $area");
+		    &Apache::lonxml::error(&mt('Unknown area style [_1]',$area));
 		}
 		&Apache::lonxml::debug("Area said $grade");
 		if ($grade eq 'APPROX_ANS') { last; }
@@ -494,11 +640,12 @@ sub start_foil {
 	$target eq 'analyze' || $target eq 'answer') {
 	my $name = &Apache::lonxml::get_param('name',$parstack,$safeeval);
 	if ($name eq "") {
-	    &Apache::lonxml::warning("Foils without names exist. This can cause problems to malfunction.");
+	    &Apache::lonxml::warning(&mt('Foils without names exist. This can cause problems to malfunction.'));
 	    $name=$Apache::lonxml::curdepth;
 	}
 	if (defined($Apache::response::foilnames{$name})) {
-	    &Apache::lonxml::error(&mt("Foil name <b><tt>[_1]</tt></b> appears more than once. Foil names need to be unique.",$name));
+	    &Apache::lonxml::error(&mt("Foil name [_1] appears more than once. Foil names need to be unique."
+                                      ,'<b><tt>'.$name.'</tt></b>'));
 	}
 	$Apache::response::foilnames{$name}++;
 	if ( $Apache::imageresponse::conceptgroup