Merge branch '4.2'

* 4.2:
  Document the multi-host DSN for Memcache caches
  Minor reword in the testing article
  Mentioned all the debug:* commands
  Clarify a sentence
  Update serializer.rst
  Fix typos and improve wording for the Lock component documentation
  More precision about the log directory permissions
  Updated the output of debug:autowiring
  Minor tweak for translation:update command
  Added some missing steps in the main form login article

Author: javiereguiluz

components/cache/adapters/memcached_adapter.rst

@@ -64,6 +64,16 @@ helper method allows creating and configuring a `Memcached`_ class instance usin
         // etc...
     ]);
 
+    // a single DSN can define multiple servers using the following syntax:
+    // host[hostname-or-IP:port] (where port is optional). Sockets must include a trailing ':'
+    $client = MemcachedAdapter::createConnection(
+        'memcached:?host[localhost]&host[localhost:12345]&host[/some/memcached.sock:]=3'
+    );
+
+.. versionadded:: 4.2
+
+    The option to define multiple servers in a single DSN was introduced in Symfony 4.2.
+
 The `Data Source Name (DSN)`_ for this adapter must use the following format:
 
 .. code-block:: text

components/http_kernel.rst

@@ -549,7 +549,7 @@ below for more details).
     There are two main listeners to ``kernel.exception`` when using the
     Symfony Framework.
 
-    **ExceptionListener in HttpKernel**
+    **ExceptionListener in the HttpKernel Component**
 
     The first comes core to the HttpKernel component
     and is called :class:`Symfony\\Component\\HttpKernel\\EventListener\\ExceptionListener`.
@@ -578,7 +578,7 @@ below for more details).
        controller to render is passed as a constructor argument to this listener.
        This controller will return the final ``Response`` for this error page.
 
-    **ExceptionListener in Security**
+    **ExceptionListener in the Security Component**
 
     The other important listener is the
     :class:`Symfony\\Component\\Security\\Http\\Firewall\\ExceptionListener`.

components/lock.rst

@@ -106,7 +106,7 @@ with the ``release()`` method.
 
 The trickiest part when working with expiring locks is choosing the right TTL.
 If it's too short, other processes could acquire the lock before finishing the
-job; it it's too long and the process crashes before calling the ``release()``
+job; if it's too long and the process crashes before calling the ``release()``
 method, the resource will stay locked until the timeout::
 
     // ...
@@ -449,8 +449,8 @@ Some file systems (such as some types of NFS) do not support locking.
     always be locked on the same machine or to use a well configured shared file
     system.
 
-Files on file system can be removed during a maintenance operation. For instance
-to cleanup the ``/tmp`` directory or after a reboot of the machine when directory
+Files on the file system can be removed during a maintenance operation. For instance,
+to clean up the ``/tmp`` directory or after a reboot of the machine when a directory
 uses tmpfs. It's not an issue if the lock is released when the process ended, but
 it is in case of ``Lock`` reused between requests.
 
@@ -479,7 +479,7 @@ needs space to add new items.
 
 .. caution::
 
-    Number of items stored in the Memcached must be under control. If it's not
+    The number of items stored in Memcached must be under control. If it's not
     possible, LRU should be disabled and Lock should be stored in a dedicated
     Memcached service away from Cache.
 

components/serializer.rst

@@ -185,7 +185,7 @@ when constructing the normalizer::
     $classMetadataFactory = new ClassMetadataFactory(new AnnotationLoader(new AnnotationReader()));
     $normalizer = new ObjectNormalizer($classMetadataFactory);
     $serializer = new Serializer([$normalizer]);
-    $person = $serializer->deserialize($data, 'Acme\Person', 'xml', [
+    $person = $serializer->deserialize($data, 'App\Model\Person', 'xml', [
         'allow_extra_attributes' => false,
     ]);
 

form/create_custom_field_type.rst

@@ -87,6 +87,15 @@ The goal of this field was to extend the choice type to enable selection of the
 shipping type. This is achieved by fixing the ``choices`` to a list of available
 shipping options.
 
+.. tip::
+
+    Run the following command to verify that the form type was successfully
+    registered in the application:
+
+    .. code-block:: terminal
+
+        $ php bin/console debug:form
+
 Creating a Template for the Field
 ---------------------------------
 

form/create_form_type_extension.rst

@@ -78,6 +78,15 @@ Once the extension is registered, any method that you've overridden (e.g.
 ``buildForm()``) will be called whenever *any* field of the given type
 (``FileType``) is built.
 
+.. tip::
+
+    Run the following command to verify that the form type extension was
+    successfully registered in the application:
+
+    .. code-block:: terminal
+
+        $ php bin/console debug:form
+
 Adding the extension Business Logic
 -----------------------------------
 

form/type_guesser.rst

@@ -232,3 +232,12 @@ and tag it with ``form.type_guesser``:
             ->getFormFactory();
 
         // ...
+
+.. tip::
+
+    Run the following command to verify that the form type guesser was
+    successfullyregistered in the application:
+
+    .. code-block:: terminal
+
+        $ php bin/console debug:form

quick_tour/the_architecture.rst

@@ -63,16 +63,21 @@ What other possible classes or interfaces could you use? Find out by running:
 
     $ php bin/console debug:autowiring
 
-=============================================================== =====================================
-Class/Interface Type                                            Alias Service ID
-=============================================================== =====================================
-``Psr\Cache\CacheItemPoolInterface``                            alias for "cache.app.recorder"
-``Psr\Log\LoggerInterface``                                     alias for "monolog.logger"
-``Symfony\Component\EventDispatcher\EventDispatcherInterface``  alias for "debug.event_dispatcher"
-``Symfony\Component\HttpFoundation\RequestStack``               alias for "request_stack"
-``Symfony\Component\HttpFoundation\Session\SessionInterface``   alias for "session"
-``Symfony\Component\Routing\RouterInterface``                   alias for "router.default"
-=============================================================== =====================================
+      # this is just a *small* sample of the output...
+
+      Describes a logger instance.
+      Psr\Log\LoggerInterface (monolog.logger)
+
+      Request stack that controls the lifecycle of requests.
+      Symfony\Component\HttpFoundation\RequestStack (request_stack)
+
+      Interface for the session.
+      Symfony\Component\HttpFoundation\Session\SessionInterface (session)
+
+      RouterInterface is the interface that all Router classes must implement.
+      Symfony\Component\Routing\RouterInterface (router.default)
+
+      [...]
 
 This is just a short summary of the full list! And as you add more packages, this
 list of tools will grow!

reference/forms/types/birthday.rst

@@ -50,6 +50,8 @@ option defaults to 120 years ago to the current year.
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\BirthdayType`        |
 +----------------------+-------------------------------------------------------------------------------+
 
+.. include:: /reference/forms/types/options/_debug_form.rst.inc
+
 Overridden Options
 ------------------
 

reference/forms/types/button.rst

@@ -19,6 +19,8 @@ A simple, non-responsive button.
 | Class                | :class:`Symfony\\Component\\Form\\Extension\\Core\\Type\\ButtonType` |
 +----------------------+----------------------------------------------------------------------+
 
+.. include:: /reference/forms/types/options/_debug_form.rst.inc
+
 Inherited Options
 -----------------