[#7033] Added versionadded and some formatting improvements

Author: wouterj

components/dom_crawler.rst

@@ -285,12 +285,15 @@ and :phpclass:`DOMNode` objects:
 Expression Evaluation
 ~~~~~~~~~~~~~~~~~~~~~
 
-The ``evaluate()`` method evaluates the given XPath expression.
-The return value depends on if the expression operates on simple values
-(like HTML attributes), or a subset of the current document.
-If the expression evaluates to a scalar value, an array of results will be
-returned. If the expression evaluates to a DOM document, a new ``Crawler``
-instance will be returned.
+.. versionadded::
+    The :method:`Symfony\\Component\\DomCrawler\\Crawler::evaluate` method was
+    introduced in Symfony 3.2.
+
+The ``evaluate()`` method evaluates the given XPath expression. The return
+value depends on the XPath expression. If the expression evaluates to a scalar
+value (e.g. HTML attributes), an array of results will be returned. If the
+expression evaluates to a DOM document, a new ``Crawler`` instance will be
+returned.
 
 This behavior is best illustrated with examples::
 
@@ -308,31 +311,35 @@ This behavior is best illustrated with examples::
     $crawler->addHtmlContent($html);
 
     $crawler->filterXPath('//span[contains(@id, "article-")]')->evaluate('substring-after(@id, "-")');
-    // array:3 [
-    //   0 => "100"
-    //   1 => "101"
-    //   2 => "102"
-    // ]
+    /* array:3 [
+         0 => "100"
+         1 => "101"
+         2 => "102"
+       ]
+     */
 
     $crawler->evaluate('substring-after(//span[contains(@id, "article-")]/@id, "-")');
-    // array:1 [
-    //   0 => "100"
-    // ]
+    /* array:1 [
+         0 => "100"
+       ]
+     */
 
     $crawler->filterXPath('//span[@class="article"]')->evaluate('count(@id)');
-    // array:3 [
-    //   0 => 1.0
-    //   1 => 1.0
-    //   2 => 1.0
-    // ]
+    /* array:3 [
+         0 => 1.0
+         1 => 1.0
+         2 => 1.0
+       ]
+     */
 
     $crawler->evaluate('count(//span[@class="article"])');
-    // array:1 [
-    //   0 => 3.0
-    // ]
+    /* array:1 [
+         0 => 3.0
+       ]
+     */
 
     $crawler->evaluate('//span[1]');
-    // Symfony\Component\DomCrawler\Crawler { }
+    // A Symfony\Component\DomCrawler\Crawler instance
 
 Links
 ~~~~~