From: zooko <zooko@zooko.com>
Date: Thu, 20 Dec 2007 20:55:18 +0000 (+0530)
Subject: zfec: update in-line comments/docs
X-Git-Url: https://git.rkrishnan.org/rgr-080307.php?a=commitdiff_plain;h=ea3dc5a96ea0dfa0f984931d925421c006811089;p=tahoe-lafs%2Fzfec.git

zfec: update in-line comments/docs

darcs-hash:8ed8783b257bbbc7f65efa4f9fd7ff0b2700a03a
---

diff --git a/zfec/README.txt b/zfec/README.txt
index a4e9910..5c3e30e 100644
--- a/zfec/README.txt
+++ b/zfec/README.txt
@@ -22,8 +22,8 @@ This package is largely based on the old "fec" library by Luigi Rizzo et al.,
 which is a mature and optimized implementation of erasure coding.  The zfec
 package makes several changes from the original "fec" package, including
 addition of the Python API, refactoring of the C API to support zero-copy
-operation, a few clean-ups and micro-optimizations of the core code itself, 
-and the addition of a command-line tool named "zfec".
+operation, a few clean-ups and optimizations of the core code itself, and the
+addition of a command-line tool named "zfec".
 
 
  * Installation
diff --git a/zfec/zfec/fec.h b/zfec/zfec/fec.h
index 60cb14b..e9f1108 100644
--- a/zfec/zfec/fec.h
+++ b/zfec/zfec/fec.h
@@ -23,6 +23,7 @@ void fec_free(fec_t* p);
  * @param inpkts the "primary blocks" i.e. the chunks of the input data
  * @param fecs buffers into which the secondary blocks will be written
  * @param block_nums the numbers of the desired blocks -- including both primary blocks (the id < k) which fec_encode() ignores and check blocks (the id >= k) which fec_encode() will produce and store into the buffers of the fecs parameter
+XXX wrong -- it includes only the block nums of the secondary blocks
  * @param num_block_nums the length of the block_nums array
  */
 void fec_encode(const fec_t* code, const gf*restrict const*restrict const src, gf*restrict const*restrict const fecs, const unsigned*restrict const block_nums, size_t num_block_nums, size_t sz);