--- doc/homework/datastorage	2005/04/07 20:43:06	1.23
+++ doc/homework/datastorage	2007/03/30 20:09:31	1.26
@@ -1,5 +1,5 @@
 ----PARAMETERS-----
-
+<see also packages.tab>
 resource.partid.opendate   #unix time of when the local machine should let the
                     #student in
 
@@ -73,13 +73,21 @@ resource.partid.solved # if not set, pro
                 # excused == excused, problem no longer counts for student
                 # '' (empty) == not attempted
                 # ungraded_attempted == an ungraded answer has been
-                                          sumbitted and stored
+                                          submitted and stored
 resource.partid.tries  # positive integer of number of unsuccessful attempts
                 # made, malformed answers don't count if feedback is
                 # on
 
 resource.partid.awarded # float between 0 and 1, percentage of
-                 # resource.partid.weight that the student earned.
+                        # resource.partid.weight that the student earned.
+
+<only exists in the scantron grading case>
+resource.partid.resourceid.awarded
+                         # float between 0 and 1, percentage of
+                         # resource.partid.weight
+                         # that the student was assigned on a scantron sheet
+                         # all resource level .awarded s will be averaged
+                         # together for the final part .awarded
 
 resource.partid.award # final detailed award that was applied to the entire
                       # part of the question, check awarddetail below for
@@ -106,11 +114,19 @@ resource.partid.responseid.awarddetail
                      # NO_RESPONSE : student submitted no response
                      # MISSING_ANSWER : student submitted some but not
                      #                   all parts of a response
+	 	     # EXTRA_ANSWER : student submitted a vector of values
+                     #                  when a scalar was expected
                      # WANTED_NUMERIC : expected a numeric answer and
                      #                   didn't get one
 		     # SIG_FAIL : incorrect number of Significant Figures
                      # UNIT_FAIL : incorrect unit
                      # UNIT_NOTNEEDED : Submitted a unit when one shouldn't
+                     # UNIT_INVALID_INSTRUCTOR : the unit provided by the 
+                     #            author of the problem is unparasable
+                     # UNIT_INVALID_STUDENT : the unit provided by the 
+                     #            student is unparasable
+                     # UNIT_IRRECONCIBLE : the unit from the student and
+                     #                  the instructor are of different types
                      # NO_UNIT : needed a unit but none was submitted
 		     # BAD_FORMULA : syntax error in submitted formula
                      # INCORRECT : answer was wrong
@@ -128,6 +144,8 @@ resource.partid.responseid.awarddetail
                      # INVALID_FILETYPE : student tried to upload a file
                      #                    that was of an extension that was
                      #                    not specficy allowed 
+		     # COMMA_FAIL : answer requires the use of comma grouping
+                     #              and it wasn't provided or was incorrect
 
 resource.partid.responseid.message (optional) (not yet supported)
 		     # a message that should be shown to the student