From: zooko Date: Sat, 19 Jan 2008 03:06:18 +0000 (+0530) Subject: add in-line doc X-Git-Url: https://git.rkrishnan.org/specifications/vdrive/htmlfontify-example.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; ikk;) { if (cblocknums[i] >= self->kk || cblocknums[i] == i) i++;