symfony
diff --git a/‎components/config/definition.rst
Copy file name to clipboardExpand all lines: components/config/definition.rst
+25Lines changed: 25 additions & 0 deletions b/‎components/config/definition.rst
Copy file name to clipboardExpand all lines: components/config/definition.rst
+25Lines changed: 25 additions & 0 deletions
@@ -425,9 +425,34 @@ All options can be documented using the
 :method:`Symfony\\Component\\Config\\Definition\\Builder\\NodeDefinition::info`
 method.
 
+.. code-block:: php
+
+    $rootNode
+        ->children()
+            ->inetegerNode('entries_per_page')
+                ->info('This value is only used for the search results page.')
+                ->devaultValue(25)
+            ->end()
+        ->end()
+    ;
+
 The info will be printed as a comment when dumping the configuration tree
 with the ``config:dump-reference`` command.
 
+In YAML you may have:
+
+.. code-block:: yaml
+
+    # This value is only used for the search results page.
+    entries_per_page:     25
+
+and in XML:
+
+.. code-block:: xml
+
+    <!-- entries-per-page: This value is only used for the search results page. -->
+    <config entries-per-page="25" />
+
 Optional Sections
 -----------------