3414: update comment for code review

[arvados.git] / services / keepstore / keepstore.go

diff --git a/services/keepstore/keepstore.go b/services/keepstore/keepstore.go
index 79ce9684593d71cd27e936290f2dca9f1970bff9..e5bd3bffb5450236981f3d2c336840b014383c1f 100644 (file)
--- a/services/keepstore/keepstore.go
+++ b/services/keepstore/keepstore.go
@@ -92,10 +92,11 @@ func (e *KeepError) Error() string {
 // Initialized by the --volumes flag (or by FindKeepVolumes).
 var KeepVM VolumeManager
 
-// The pull list manager is responsible for pulling blocks from other
-// Keep servers to ensure replication. When Keep receives a new "pull
-// list" from Data Manager, the pull manager is responsible for fetching
-// blocks on the list.
+// The pull list manager is a singleton pull list (a list of blocks
+// that the current keepstore process should be pulling from remote
+// keepstore servers in order to increase data replication) with
+// atomic update methods that are safe to use from multiple
+// goroutines.
 var pullmgr *pull_list.Manager
 
 // TODO(twp): continue moving as much code as possible out of main