From: david-sarah <david-sarah@jacaranda.org>
Date: Sat, 11 Sep 2010 00:25:48 +0000 (-0700)
Subject: docs/frontends/webapi.txt: note that 'count-good-share-hosts' is computed incorrectly... 
X-Git-Tag: allmydata-tahoe-1.8.0c4~6
X-Git-Url: https://git.rkrishnan.org/specifications/%5B//%22doc.html/%22?a=commitdiff_plain;h=0091205e3c56a4de1e3ff9bb88dc7e7164707a30;p=tahoe-lafs%2Ftahoe-lafs.git

docs/frontends/webapi.txt: note that 'count-good-share-hosts' is computed incorrectly; refs #1115
---

diff --git a/docs/frontends/webapi.txt b/docs/frontends/webapi.txt
index 2f689195..52c3c555 100644
--- a/docs/frontends/webapi.txt
+++ b/docs/frontends/webapi.txt
@@ -1172,13 +1172,10 @@ POST $URL?t=check
      count-shares-good: the number of good shares that were found
      count-shares-needed: 'k', the number of shares required for recovery
      count-shares-expected: 'N', the number of total shares generated
-     count-good-share-hosts: the number of distinct storage servers with
-                             good shares. If this number is less than
-                             count-shares-good, then some shares are doubled
-                             up, increasing the correlation of failures. This
-                             indicates that one or more shares should be
-                             moved to an otherwise unused server, if one is
-                             available.
+     count-good-share-hosts: this was intended to be the number of distinct
+                             storage servers with good shares. It is currently
+                             (as of Tahoe-LAFS v1.8.0) computed incorrectly;
+                             see ticket #1115.
      count-wrong-shares: for mutable files, the number of shares for
                          versions other than the 'best' one (highest
                          sequence number, highest roothash). These are