--- loncom/homework/grades.pm	2007/07/25 00:00:23	1.424
+++ loncom/homework/grades.pm	2007/07/25 00:11:05	1.425
@@ -1,7 +1,7 @@
 # The LearningOnline Network with CAPA
 # The LON-CAPA Grading handler
 #
-# $Id: grades.pm,v 1.424 2007/07/25 00:00:23 albertel Exp $
+# $Id: grades.pm,v 1.425 2007/07/25 00:11:05 albertel Exp $
 #
 # Copyright Michigan State University Board of Trustees
 #
@@ -5666,6 +5666,26 @@ sub scantron_remove_scan_data {
          count     - number of scanlines
  
      - second is the scan_data hash possible keys are
+       ($number refers to scanline numbered $number and thus the key affects
+        only that scanline
+        $bubline refers to the specific bubble line element and the aspects
+        refers to that specific bubble line element)
+
+       $number.user - username:domain to use
+       $number.CODE_ignore_dup 
+                    - ignore the duplicate CODE error 
+       $number.useCODE
+                    - use the CODE in the scanline as is
+       $number.no_bubble.$bubline
+                    - it is valid that there is no bubbled in bubble
+                      at $number $bubline
+       remember_skipping
+                    - a frozen hash containing keys of $number and values
+                      of either 
+                        1 - we are on a 'do skipped records pass' and plan
+                            on processing this line
+                        2 - we are on a 'do skipped records pass' and this
+                            scanline has been marked to skip yet again
 
 =cut