diff --git a/components/yaml.rst b/components/yaml.rst
index ec47ea6a9ee..7e22b4cdafd 100644
--- a/components/yaml.rst
+++ b/components/yaml.rst
@@ -410,13 +410,22 @@ Then, execute the script for validating contents:
 
     # validates a single file
     $ php lint.php path/to/file.yaml
+    
+    # or validates multiple files
+    $ php lint.php path/to/file1.yaml path/to/file2.yaml 
 
     # or all the files in a directory
     $ php lint.php path/to/directory
+    
+    # or all the files in multiple directories
+    $ php lint.php path/to/directory1 path/to/directory2
 
     # or contents passed to STDIN
     $ cat path/to/file.yaml | php lint.php
 
+.. versionadded:: 4.2
+    The feature to lint multiple files and directories was introduced in Symfony 4.2.
+
 The result is written to STDOUT and uses a plain text format by default.
 Add the ``--format`` option to get the output in JSON format: