From 0091205e3c56a4de1e3ff9bb88dc7e7164707a30 Mon Sep 17 00:00:00 2001
From: david-sarah <david-sarah@jacaranda.org>
Date: Fri, 10 Sep 2010 17:25:48 -0700
Subject: [PATCH] docs/frontends/webapi.txt: note that 'count-good-share-hosts'
 is computed incorrectly; refs #1115

---
 docs/frontends/webapi.txt | 11 ++++-------
 1 file changed, 4 insertions(+), 7 deletions(-)

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