Mention PCNTL extension installation

Author: alexandre-daubois

components/console/events.rst

@@ -152,6 +152,8 @@ Listeners receive a
     It is then dispatched just after the ``ConsoleEvents::ERROR`` event.
     The exit code received in this case is the exception code.
 
+.. _console_signal-event:
+
 The ``ConsoleEvents::SIGNAL`` Event
 -----------------------------------
 
@@ -184,7 +186,8 @@ Listeners receive a
 .. tip::
 
     All the available signals (``SIGINT``, ``SIGQUIT``, etc.) are defined as
-    `constants of the PCNTL PHP extension`_.
+    `constants of the PCNTL PHP extension`_. The extension has to be installed
+    for these constants to be available.
 
 If you use the Console component inside a Symfony application, commands can
 handle signals themselves. To do so, implement the

components/lock.rst

@@ -269,6 +269,11 @@ Lock will be released automatically as soon as one process finishes::
     }
     // ...
 
+.. note::
+
+    In order for the above example to work, the `PCNTL`_ extension must be
+    installed.
+
 To disable this behavior, set the ``autoRelease`` argument of
 ``LockFactory::createLock()`` to ``false``. That will make the lock acquired
 for 3600 seconds or until ``Lock::release()`` is called::
@@ -1074,3 +1079,4 @@ are still running.
 .. _`ZooKeeper`: https://zookeeper.apache.org/
 .. _`readers-writer lock`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock
 .. _`priority policy`: https://en.wikipedia.org/wiki/Readers%E2%80%93writer_lock#Priority_policies
+.. _`PCNTL`: https://www.php.net/manual/book.pcntl.php

setup.rst

@@ -22,7 +22,10 @@ Before creating your first Symfony application you must:
 
 Optionally, you can also `install Symfony CLI`_. This creates a binary called
 ``symfony`` that provides all the tools you need to develop and run your
-Symfony application locally.
+Symfony application locally. Also, you may install the `PCNTL`_ extension to
+use some features like signal handling in
+:doc:`the Messenger component </messenger>` and when using
+:ref:`signals in commands <console_signal-event>`.
 
 The ``symfony`` binary also provides a tool to check if your computer meets all
 requirements. Open your console terminal and run this command:
@@ -329,3 +332,4 @@ Learn More
 .. _`Tokenizer`: https://www.php.net/book.tokenizer
 .. _`SimpleXML`: https://www.php.net/book.simplexml
 .. _`PCRE`: https://www.php.net/book.pcre
+.. _`PCNTL`: https://www.php.net/manual/book.pcntl.php