Tweak section to remove some text

Author: wouterj

book/controller.rst

@@ -782,6 +782,12 @@ There are also special classes to make certain kinds of responses easier:
   :class:`Symfony\\Component\\HttpFoundation\\StreamedResponse`.
   See :ref:`streaming-response`.
 
+.. seealso::
+
+    Now that you know the basics you can continue your research on Symfony
+    ``Request`` and ``Response`` object in the
+    :ref:`HttpFoundation component documentation <component-http-foundation-request>`.
+
 JSON Helper
 ~~~~~~~~~~~
 
@@ -809,46 +815,39 @@ the :phpfunction:`json_encode` function is used.
 File helper
 ~~~~~~~~~~~
 
-If you want to serve file use the
-:method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::file`
-helper::
-
-    $this->file($file, $fileName = null, $disposition = ResponseHeaderBag::DISPOSITION_ATTACHMENT);
+.. versionadded:: 3.2
+    The ``file()`` helper was introduced in Symfony 3.2.
 
-You can pass:
+You can use :method:`Symfony\\Bundle\\FrameworkBundle\\Controller\\Controller::file`
+to serve a file from inside a controller::
 
-* An instance of
-  :class:`Symfony\\Component\\HttpFoundation\\File`
-  in ``$file`` parameter (you can customize ``$fileName`` and ``$disposition``)
+    $this->file($file, $fileName = null, $disposition = ResponseHeaderBag::DISPOSITION_ATTACHMENT);
 
-* Path to file in ``$file`` parameter
+You can pass an :phpclass:`SplFileInfo` instance (like
+:class:`Symfony\\Component\\HttpFoundation\\File`) or the path to a file as
+first argument. Using the second and third arguments, you can customize the
+send filename and the disposition.
 
-Example usage::
+.. code-block:: php
 
     use Symfony\Component\HttpFoundation\File\File;
     use Symfony\Component\HttpFoundation\ResponseHeaderBag;
 
-    // This will send file with original name as attachment to browser
     public function fileAction()
     {
-        // Load file from file system
+        // load file from the file system
         $file = new File('some_file.pdf');
 
-        return $this->file($file);
+        // send the file as attachment to browser
+        return $this->file($file, 'custom_name.pdf');
     }
 
-    // Server file from specified path
     public function pathFileAction()
     {
+        // serve file from specified path
         return $this->file('/path/to/my/picture.jpg');
     }
 
-.. seealso::
-
-    Now that you know the basics you can continue your research on Symfony
-    ``Request`` and ``Response`` object in the
-    :ref:`HttpFoundation component documentation <component-http-foundation-request>`.
-
 Creating Static Pages
 ---------------------