From 95d57f96f421f11044d8d8b8607b81bd33633782 Mon Sep 17 00:00:00 2001
From: zooko <zooko@zooko.com>
Date: Sat, 19 Jan 2008 08:36:18 +0530
Subject: [PATCH] add in-line doc

Brian Warner had the idea of "forgetfulness oriented programming".  Anything that you can't remember six months later needs to be simplified or documented.  This weird little stanza that I inherited from Luigi Rizzo's library is in that class.

darcs-hash:a84e7a80dd6fa2541254120e377cf2a87b0e235b
---
 zfec/zfec/_fecmodule.c | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/zfec/zfec/_fecmodule.c b/zfec/zfec/_fecmodule.c
index 38fc400..05b24d6 100644
--- a/zfec/zfec/_fecmodule.c
+++ b/zfec/zfec/_fecmodule.c
@@ -429,7 +429,9 @@ Decoder_decode(Decoder *self, PyObject *args) {
         oldsz = sz;
     }
 
-    /* move src packets into position */
+    /* Move src packets into position.  At the end of this loop we want the i'th
+       element of the arrays to be the block with block number i, if that block
+       is among our inputs. */
     for (i=0; i<self->kk;) {
         if (cblocknums[i] >= self->kk || cblocknums[i] == i)
             i++;
-- 
2.37.2