summaryrefslogtreecommitdiff
path: root/usagepool.go
diff options
context:
space:
mode:
Diffstat (limited to 'usagepool.go')
-rw-r--r--usagepool.go17
1 files changed, 9 insertions, 8 deletions
diff --git a/usagepool.go b/usagepool.go
index df69caf..6fd48f5 100644
--- a/usagepool.go
+++ b/usagepool.go
@@ -25,14 +25,15 @@ import (
// only inserted if they do not already exist. There
// are two ways to add values to the pool:
//
-// 1) LoadOrStore will increment usage and store the
-// value immediately if it does not already exist
-// 2) LoadOrNew will increment usage and construct the
-// value immediately if it does not already exist,
-// then store that value in the pool. When the
-// constructed value is finally deleted from the
-// pool (after its usage reaches 0), it will be
-// cleaned up by calling its Destruct method.
+// 1) LoadOrStore will increment usage and store the
+// value immediately if it does not already exist.
+// 2) LoadOrNew will atomically check for existence
+// and construct the value immediately if it does
+// not already exist, or increment the usage
+// otherwise, then store that value in the pool.
+// When the constructed value is finally deleted
+// from the pool (when its usage reaches 0), it
+// will be cleaned up by calling Destruct().
//
// The use of LoadOrNew allows values to be created
// and reused and finally cleaned up only once, even