Address lingering review comments from SHM locking PR

Signed-off-by: Matthew Heon <matthew.heon@pm.me>

1 files changed, 3 insertions, 0 deletions

diff --git a/libpod/lock/lock.go b/libpod/lock/lock.go
index 73c1fdcf7..1f94171fe 100644
--- a/libpod/lock/lock.go
+++ b/libpod/lock/lock.go
@@ -43,6 +43,9 @@ type Locker interface {
 	// encounters a fatal error.
 	// All errors must be handled internally, as they are not returned. For
 	// the most part, panicking should be appropriate.
+	// Some lock implementations may require that Lock() and Unlock() occur
+	// within the same goroutine (SHM locking, for example). The usual Go
+	// Lock()/defer Unlock() pattern will still work fine in these cases.
 	Lock()
 	// Unlock unlocks the lock.
 	// All errors must be handled internally, as they are not returned. For