[tor-commits] [bridgedb/master] Add a more verbose comment on what insertBridgeAndGetRing() does now.

[karsten at torproject.org]

commit daa394e94d275499dca2f96aed443e2fd67049bd
Author: Christian Fromme <kaner at strace.org>
Date:   Tue Mar 8 20:09:53 2011 +0100

    Add a more verbose comment on what insertBridgeAndGetRing() does now.
---
 lib/bridgedb/Storage.py |    7 +++++--
 1 files changed, 5 insertions(+), 2 deletions(-)

diff --git a/lib/bridgedb/Storage.py b/lib/bridgedb/Storage.py
index ae48dde..62ed71c 100644
--- a/lib/bridgedb/Storage.py
+++ b/lib/bridgedb/Storage.py
@@ -178,8 +178,11 @@ class Database:
 
     def insertBridgeAndGetRing(self, bridge, setRing, seenAt, validRings,
                                defaultPool="unallocated"):
-        '''updates info about bridge, setting ring to setRing if none was set.
-           Returns the bridge's validated ring.
+        '''Updates info about bridge, setting ring to setRing if none was set.
+           Also sets distributor to `defaultPool' if the bridge was found in
+           the database, but its distributor isn't valid anymore.
+
+           Returns the name of the distributor the bridge is assigned to.
         '''
         cur = self._cur