From: zooko <zooko@zooko.com>
Date: Sat, 19 Jan 2008 03:06:18 +0000 (+0530)
Subject: add in-line doc
X-Git-Url: https://git.rkrishnan.org/specifications/%5B/%5D%20/frontends/nxhtml.html?a=commitdiff_plain;h=95d57f96f421f11044d8d8b8607b81bd33633782;p=tahoe-lafs%2Fzfec.git

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
---

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++;