From: zooko <zooko@zooko.com>
Date: Mon, 1 Oct 2007 19:40:32 +0000 (+0530)
Subject: zfec: add warning about changed share header in zfec v1.1
X-Git-Url: https://git.rkrishnan.org/%5B/%5D%20/file/URI:LIT:krugkidfnzsc4/frontends/quickstart.html?a=commitdiff_plain;h=8c433747cde4aaa0839fba7c6693609215214f01;p=tahoe-lafs%2Fzfec.git

zfec: add warning about changed share header in zfec v1.1

darcs-hash:93fac0833f5926037ab3bf56b7776d160e346246
---

diff --git a/zfec/README.txt b/zfec/README.txt
index 2bd5763..b3b16e5 100644
--- a/zfec/README.txt
+++ b/zfec/README.txt
@@ -96,6 +96,10 @@ input to the encoding step.
 
  * Command-Line Tool
 
+NOTE: the format of the sharefiles was changed in zfec v1.1 to allow K == 1 
+and K == M.  This change of the format of sharefiles means that zfec >= v1.1 
+cannot read sharefiles produced by zfec < v1.1.
+
 The bin/ directory contains two Unix-style, command-line tools "zfec" and 
 "zunfec".  Execute "zfec --help" or "zunfec --help" for usage instructions.
 
@@ -233,5 +237,5 @@ releasing it under a Free Software licence.
 Enjoy!
 
 Zooko Wilcox-O'Hearn
-2007-04-27
+2007-10-01
 Boulder, Colorado
diff --git a/zfec/zfec/filefec.py b/zfec/zfec/filefec.py
index 35d64c5..7e502a7 100644
--- a/zfec/zfec/filefec.py
+++ b/zfec/zfec/filefec.py
@@ -28,7 +28,7 @@ def _build_header(m, k, pad, sh):
     @param pad: the number of bytes of padding added to the file before encoding; 0 <= pad < k
     @param sh: the shnum of this share; 0 <= k < m
 
-    @return: a string (which is hopefully short) encoding m, k, sh, and pad
+    @return: a compressed string encoding m, k, pad, and sh
     """
     assert m >= 1
     assert m <= 2**8