diff --git a/src/okvs.a b/src/okvs.a
index e887c1d..0027c3e 100644
--- a/src/okvs.a
+++ b/src/okvs.a
@@ -327,7 +327,7 @@ okvs_update
 ; in:    stack contains 4 bytes of parameters:
 ;          +1 [word] handle to storage space
 ;          +3 [word] address of callback
-; out:   <callback> will be called for each record in the store with
+; out:   <callback> will be called for each record in the store, in order, with
 ;          X = numeric index of record
 ;          A/Y = address of key
 ;        all registers are clobbered
@@ -349,7 +349,7 @@ okvs_iter
          pha                         ; save PTR on stack (in case callback clobbers it)
          phy
          clc
-         adc   #$02
+         adc   #2                    ; skip over next-record pointer (2 bytes)
          bcc   +
          iny                         ; A/Y -> key
 +        phx
@@ -373,7 +373,7 @@ okvs_iter
 ; in:    stack contains 4 bytes of parameters:
 ;          +1 [word] handle to storage space
 ;          +3 [word] address of callback
-; out:   <callback> will be called for each record in the store with
+; out:   <callback> will be called for each record in the store, in order, with
 ;          X = numeric index of record
 ;          A/Y = address of value
 ;        all registers are clobbered