Expand LockConflictedException docs

NoelLH · NoelLH · commit 2e4335fc70dc · 2021-05-04T13:06:07.000+01:00
The goal of this is to reduce the chance of bad assumptions about lock acquisition behaviour. Fixes #40969
diff --git a/src/Symfony/Component/Lock/Exception/LockConflictedException.php b/src/Symfony/Component/Lock/Exception/LockConflictedException.php
@@ -11,9 +11,13 @@
 
 namespace Symfony\Component\Lock\Exception;
 
+use Symfony\Component\Lock\Lock;
+
 /**
  * LockConflictedException is thrown when a lock is acquired by someone else.
  *
+ * In non-blocking mode it is caught by {@see Lock::acquire()} and {@see Lock::acquireRead()}.
+ *
  * @author Jérémy Derussé <jeremy@derusse.com>
  */
 class LockConflictedException extends \RuntimeException implements ExceptionInterface
