--- doc/homework/datastorage	2000/11/09 16:23:00	1.1
+++ doc/homework/datastorage	2003/01/19 08:19:40	1.17
@@ -1,51 +1,104 @@
 <Provided by &EXT() and set external to the resource, required>
-resource.opendate   #unix time of when the local machine should let the
+resource.partid.opendate   #unix time of when the local machine should let the
                     #student in
 
-resource.duedate    #unix time of when the local machine should stop
+resource.partid.duedate    #unix time of when the local machine should stop
                     #accepting answers
 
-resource.answerdate #unix time of when the local machine should
+resource.partid.answerdate #unix time of when the local machine should
                     #provide the correct answer to the student
 
-resource.weight     # points the problem is worth
+resource.partid.acc # a string that can be used to control access, either
+                    # IP based or Domain Name based
 
-resource.maxtries   # maximum number of attempts the student can have
+resource.partid.weight     # points the problem is worth
 
+resource.partid.maxtries   # maximum number of attempts the student can have
 
+resource.partid.problemstyle # style to show a problem in, possible values:
+                             # online - show problem in default online mode
+                             # bubble - show problem in a mode approriate to
+                             #          being printed out for a bubble sheet
+                             #          exam
 
-<caparesponse needed: (has a default if nonexistant)>
+resource.partid.type       # type of problem homework can be:
+                           # homework - randomized, graded, stored with 
+                           #            requesting user, full feeback
+                           # exam - randomized, graded, stored with 
+                           #        requesting user, minimal feedback
+                           # form - unrandomized, ungraded, stored with 
+                           #        specified user, full feedback
+                           # survey - unrandomized, ungraded, stored with 
+                           #          requesting user, full feedback
 
-resource.tolerance  # lots of possibilities here
+
+<numerical/formula/response needed: (has a default if nonexistant)>
+
+resource.partid.responseid.tol   # lots of possibilities here
                     # percentage, range (inclusive and exclusive),
 		    # variable name, etc
+                    # 3%
+                    # 0.5
+                    # .05+
+                    # 3%+
+                    # 0.5+,.005
 
-resource.significantfigures  # one or two integers
+resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
+                     # number of significatn figures a student must use
 
-resource.feedback   # at least a single bit (yes/no) may go with a
-                    # bitmask in the future
 
 
 <Problem sets using cstore (required):>
-resource.solved # if not set, problem yet to be viewed
-                # 0 == incorrect and attempted
-                # 1 == correct by student work
-                # 2 == correct, instructor override
-                # -1 == incorrect, instructor override
-                # E == excused, problem no longer counts for student
-
-resource.tries  # positive integer of number of unsuccessful attempts
+resource.partid.solved # if not set, problem yet to be viewed
+                # incorrect_attempted == incorrect and attempted
+                # correct_by_student == correct by student work
+                # correct_by_override == correct, instructor override
+                # incorrect_by_override == incorrect, instructor override
+                # excused == excused, problem no longer counts for student
+                # '' (empty) == not attempted
+                # ungraded_attempted == an ungraded answer has been
+                                          sumbitted and stored
+resource.partid.tries  # positive integer of number of unsuccessful attempts
                 # made, malformed answers don't count if feedback is
                 # on
 
-resource.awarded # float between 0 and 1, percentage of
+resource.partid.awarded # float between 0 and 1, percentage of
                  # resource.weight that the stundent earned.
 
-resource.submissons # list of all of the student submitted strings for all of
-                    # answers in the part
-
-resource.awarddetail # list of all of the results of grading the submissions
-                     # in detailed form of the specific failure
+resource.partid.award # final detailed award that was applied to the entire
+                      # part of the question, check awarddetail below for
+                      # possibilities
 
+resource.partid.previous # boolean, is this submission a previous submission
 
+resource.partid.responseid.submissons
+                    # the student submitted string for the part.response
 
+resource.partid.responseid.awarddetail
+                     # list of all of the results of grading the submissions
+                     # in detailed form of the specific failure
+		     #Possible values:
+                     # EXACT_ANS, APPROX_ANS : student is correct
+                     # NO_RESPONSE : student submitted no response
+                     # MISSING_ANSWER : student submitted some but not
+                     #                   all parts of a response
+                     # 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
+                     # NO_UNIT : needed a unit but none was submitted
+		     # BAD_FORMULA : syntax error in submitted formula
+                     # INCORRECT : answer was wrong
+                     # SUBMITTED : submission wasn't graded
+                     # DRAFT : submission only stored
+                     # MISORDERED_RANK : student submitted a poorly order
+                     #                   rank response
+		     # ERROR : unable to get a grade
+
+resource.partid.responseid.message (optional) (not yet supported)
+		     # a message that should be shown to the student
+
+resource.partid.bonustries (optional) (not yet supported)
+                     # if set, added to the maxtries parameter for student 
+                     # total number of tries overall