--- doc/homework/datastorage	2000/12/12 22:39:52	1.7
+++ doc/homework/datastorage	2003/01/19 08:19:40	1.17
@@ -8,15 +8,33 @@ resource.partid.duedate    #unix time of
 resource.partid.answerdate #unix time of when the local machine should
                     #provide the correct answer to the student
 
+resource.partid.acc # a string that can be used to control access, either
+                    # IP based or Domain Name based
+
 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
+
+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
 
 
-<caparesponse needed: (has a default if nonexistant)>
+<numerical/formula/response needed: (has a default if nonexistant)>
 
-resource.partid.tol   # lots of possibilities here
+resource.partid.responseid.tol   # lots of possibilities here
                     # percentage, range (inclusive and exclusive),
 		    # variable name, etc
                     # 3%
@@ -24,13 +42,10 @@ resource.partid.tol   # lots of possibil
                     # .05+
                     # 3%+
                     # 0.5+,.005
-                    
-resource.partid.sig  # one or two comma sepearted integers, specifying the 
+
+resource.partid.responseid.sig  # one or two comma sepearted integers, specifying the
                      # number of significatn figures a student must use
 
-resource.partid.feedback   # at least a single bit (yes/no) may go with a
-                         # bitmask in the future, controls whether or not
-                         # a problem should say "correct" or not
 
 
 <Problem sets using cstore (required):>
@@ -41,7 +56,8 @@ resource.partid.solved # if not set, pro
                 # 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
@@ -49,14 +65,40 @@ resource.partid.tries  # positive intege
 resource.partid.awarded # float between 0 and 1, percentage of
                  # resource.weight that the stundent earned.
 
-resource.partid.responseid.submissons 
+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 
+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