Acquires returns false instead of throwing exception

jderusse · jderusse · commit 4539a99a5734 · 2017-01-22T17:04:18.000+01:00
diff --git a/components/lock.rst b/components/lock.rst
@@ -30,30 +30,25 @@ Then, you can use the :class:`Symfony\\Component\\Lock\\Factory` to create a
 Lock for your ``resource``.
 
 The :method:`Symfony\\Component\\Lock\\LockInterface::acquire` method tries to
-acquire the lock. If the lock can not be acquired, the method throws a
-:class:`Symfony\\Component\\Lock\\Exception\\LockConflictedException`. You can
-safely call the ``acquire()`` method several times, even if you already acquired
-it.
+acquire the lock. If the lock can not be acquired, the method returns ``false``.
+You can safely call the ``acquire()`` method several times, even if you already
+acquired it.
 
 .. code-block:: php
 
     use Symfony\Component\Lock\Factory;
     use Symfony\Component\Lock\Store\SemaphoreStore;
-    use Symfony\Component\Lock\Exception\LockConflictedException;
 
     $store = new SemaphoreStore();
     $factory = new Factory($store);
     $lock = $factory->createLock('invoice-pdf-generation');
 
-    try {
-        $lock->acquire();
+    if ($lock->acquire()) {
         // the resource "invoice-pdf-generation" is locked.
 
         // You can compute and generate invoice safely here.
 
         $lock->release();
-    } catch (LockConflictedException $e) {
-        // the resource "invoice-pdf-generation" is already locked by another process
     }
 
 The first argument of ``createLock`` is a string representation of the
