Updating from symfony-docs

Author: gregquat

book/doctrine.rst

@@ -260,7 +260,10 @@ disponibles, reportez vous à la section :ref:`book-doctrine-field-types`.
     le nom de la classe de votre entité est ``Group``, alors, par défaut, le nom
     de la table correspondante sera ``group``, ce qui causera des problèmes SQL
     avec certains moteurs. Lisez la documentation sur les `Mots-clé SQL réservés`_ de
-    Doctrine pour savoir comment échapper ces noms.
+    Doctrine pour savoir comment échapper ces noms. Alternativement, si vous êtes libre
+    de choisir votre schéma de base de données, vous pouvez simplement utiliser un autre
+    nom de table ou de colonne. Lisez les documentations de Doctrine `Classes persistantes`_
+    et `Mapping de propriétés`_.
 
 .. note::
 
@@ -1466,4 +1469,6 @@ suivant :
 .. _`Property Mapping documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#property-mapping
 .. _`Lifecycle Events documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#lifecycle-events
 .. _`Mots-clé SQL réservés`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/basic-mapping.html#quoting-reserved-words
+.. _`Classes persistantes`: http://docs.doctrine-project.org/projects/doctrine-orm/en/2.1/reference/basic-mapping.html#persistent-classes
+.. _`Mapping de propriétés`: http://docs.doctrine-project.org/projects/doctrine-orm/en/2.1/reference/basic-mapping.html#property-mapping
 

book/installation.rst

@@ -18,7 +18,7 @@ Télécharger une Distribution Symfony2
 
 .. tip::
     Premièrement, vérifiez que vous avez installé et configuré un serveur web
-    (comme Apache) avec PHP 5.3.2 ou supérieur. Pour plus d'informations sur les
+    (comme Apache) avec PHP 5.3.3 ou supérieur. Pour plus d'informations sur les
     prérequis Symfony2, lisez le chapitre :doc:`pré-requis</reference/requirements>`.
     Pour plus d'informations sur la manière de configurer la racine web de votre serveur,
     lisez les documentations suivantes : `Apache`_ | `Nginx`_ .
@@ -175,6 +175,11 @@ S'il y a des problèmes, corrigez les maintenant avant de poursuivre.
         sudo setfacl -R -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs
         sudo setfacl -dR -m u:www-data:rwx -m u:`whoami`:rwx app/cache app/logs
 
+    Notez que tout les serveurs web n'utilisent pas l'utilisateur ``www-data``. Vous devez
+    vérifier quel utilisateur votre serveur web utilise et le remplacer dans la commande
+    ci-dessus si besoin. Cela peut être fait en vérifiant la liste des processus pour voir
+    quel utilisateur éxécute votre serveur web.
+
     **3. Sans utiliser l'ACL**
 
     Si vous n'avez pas les droits de changer les accès aux répertoires, vous aurez
@@ -252,4 +257,4 @@ pour récupérer toutes les librairies nécessaires.
 .. _`GitHub`: http://help.github.com/set-up-git-redirect
 .. _`Composer`: http://getcomposer.org/
 .. _`Apache`: http://httpd.apache.org/docs/current/mod/core.html#documentroot
-.. _`Nginx`: http://wiki.nginx.org/HttpCoreModule#root
+.. _`Nginx`: http://wiki.nginx.org/Symfony

book/propel.rst

@@ -26,22 +26,22 @@ Configuring the Database
 
 Before you can start, you'll need to configure your database connection
 information.  By convention, this information is usually configured in an
-``app/config/parameters.ini`` file:
+``app/config/parameters.yml`` file:
 
-.. code-block:: ini
+.. code-block:: yml
 
-    ;app/config/parameters.ini
-    [parameters]
-        database_driver   = mysql
-        database_host     = localhost
-        database_name     = test_project
-        database_user     = root
-        database_password = password
-        database_charset  = UTF8
+    # app/config/parameters.yml
+    parameters:
+        database_driver:   mysql
+        database_host:     localhost
+        database_name:     test_project
+        database_user:     root
+        database_password: password
+        database_charset:  UTF8
 
 .. note::
 
-    Defining the configuration via ``parameters.ini`` is just a convention. The
+    Defining the configuration via ``parameters.yml`` is just a convention. The
     parameters defined in that file are referenced by the main configuration
     file when setting up Propel:
 

book/routing.rst

@@ -1145,7 +1145,7 @@ depuis les templates.
 
     .. code-block:: javascript
 	
-        var url = Routing.generate('blog_show', { "slug": 'my-blog-post});
+        var url = Routing.generate('blog_show', { "slug": 'my-blog-post'});
 
     Pour plus d'informations, lisez la documentation du bundle.
 

book/service_container.rst

@@ -1086,11 +1086,11 @@ des paramètres supplémentaires (au-delà du paramètre ``name``).
 * translation.loader
 * validator.constraint_validator
 
-Apprenez en plus en lisant le Cookbook
---------------------------------------
+Apprenez en plus
+----------------
 
-* :doc:`/cookbook/service_container/factories`
-* :doc:`/cookbook/service_container/parentservices`
+* :doc:`/components/dependency_injection/factories`
+* :doc:`/components/dependency_injection/parentservices`
 * :doc:`/cookbook/controller/service`
 
 .. _`service-oriented architecture`: http://wikipedia.org/wiki/Service-oriented_architecture

book/templating.rst

@@ -582,9 +582,7 @@ un template.
 
 La solution consiste simplement à imbriquer les résultats d'un contrôleur dans un
 template. Dans un premier temps, créez un contrôleur qui retourne un certain
-nombre d'articles récents :
-
-.. code-block:: php
+nombre d'articles récents::
 
     // src/Acme/ArticleBundle/Controller/ArticleController.php
 
@@ -966,15 +964,11 @@ Le coeur du système de template dans Symfony2 est le ``moteur`` de template (``
 objet spécial est responsable de rendre des templates et de retourner leur
 contenu. Quand vous effectuez le rendu d'un template à travers un contrôleur
 par exemple, vous utilisez en effet le service de moteur de template. Par
-exemple :
-
-.. code-block:: php
+exemple::
 
     return $this->render('AcmeArticleBundle:Article:index.html.twig');
 
-est équivalent à
-
-.. code-block:: php
+est équivalent à::
 
     $engine = $this->container->get('templating');
     $content = $engine->render('AcmeArticleBundle:Article:index.html.twig');
@@ -1276,9 +1270,7 @@ n'est pas rendu différemment en se basant sur ce format.
 
 Dans beaucoup de cas, vous pourriez vouloir autoriser un simple contrôleur à
 rendre plusieurs formats en se basant sur le « request format ». Pour cette
-raison, un pattern commun est de procéder comme cela :
-
-.. code-block:: php
+raison, un pattern commun est de procéder comme cela::
 
     public function indexAction()
     {
@@ -1320,9 +1312,7 @@ chaque fois que vous avez besoin de générer du contenu de répresentation en
 HTML, XML ou tout autre format. Et bien que les templates soient un moyen commun
 de générer du contenu dans un contrôleur, leur utilisation n'est pas
 systèmatique. L'objet ``Response`` retourné par un contrôleur peut être créé
-avec ou sans utilisation de template :
-
-.. code-block:: php
+avec ou sans utilisation de template::
 
     // création d'un objet Response qui contient le rendu d'un template
     $response = $this->render('AcmeArticleBundle:Article:index.html.twig');

book/testing.rst

@@ -154,7 +154,7 @@ son ``DemoController`` (`DemoControllerTest`_) :
 
             $crawler = $client->request('GET', '/demo/hello/Fabien');
 
-            $this->assertTrue($crawler->filter('html:contains("Hello Fabien")')->count() > 0);
+            $this->assertGreaterThan(0, $crawler->filter('html:contains("Hello Fabien")')->count());
         }
     }
 
@@ -232,7 +232,7 @@ qu'elle fasse. Utilisez le Crawler pour faire des assertions sur le DOM :
 .. code-block:: php
 
     // affirme que la réponse correspond au sélecteur CSS donné
-    $this->assertTrue($crawler->filter('h1')->count() > 0);
+    $this->assertGreaterThan(0, $crawler->filter('h1')->count());
 
 Ou alors, testez directement le contenu de la Réponse si vous voulez
 juste vérifier qu'il contient un certain texte, ou si la Réponse n'est pas un
@@ -278,18 +278,18 @@ document XML/HTML :
 .. index::
    single: Tests; Assertions
 
-.. sidebar: Assertions Utiles
+.. sidebar:: Assertions Utiles
 
     Afin que vous démarriez plus rapidement, voici une liste des
     assertions les plus communes et utiles :
 
     .. code-block:: php
 
         // Vérifie qu'il y a au moins une balise h2 dans la classe "subtitle"
-        $this->assertTrue($crawler->filter('h2.subtitle')->count() > 0);
+        $this->assertGreaterThan(0, $crawler->filter('h2.subtitle')->count());
 
         // Vérifie qu'il y a exactement 4 balises h2 sur la page
-        $this->assertEquals(4, $crawler->filter('h2')->count());
+        $this->assertCount(4, $crawler->filter('h2')->count());
 
         // Vérifie que l'entête "Content-Type" vaut "application/json"
         $this->assertTrue($client->getResponse()->headers->contains('Content-Type', 'application/json'));

book/translation.rst

@@ -859,7 +859,7 @@ manuellement la locale à utiliser pour la traduction :
         'fr_FR',
     );
 
-    $this->get('translator')->trans(
+    $this->get('translator')->transChoice(
         '{0} There is no apples|{1} There is one apple|]1,Inf[ There are %count% apples',
         10,
         array('%count%' => 10),

components/console.rst

@@ -211,14 +211,14 @@ will work:
 
 There are 4 option variants you can use:
 
-===========================  =====================================================
+===========================  =====================================================================================
 Option                       Value
-===========================  =====================================================
-InputOption::VALUE_IS_ARRAY  This option accepts multiple values
+===========================  =====================================================================================
+InputOption::VALUE_IS_ARRAY  This option accepts multiple values (e.g. ``--dir=/foo --dir=/bar``)
 InputOption::VALUE_NONE      Do not accept input for this option (e.g. ``--yell``)
-InputOption::VALUE_REQUIRED  This value is required (e.g. ``iterations=5``)
-InputOption::VALUE_OPTIONAL  This value is optional
-===========================  =====================================================
+InputOption::VALUE_REQUIRED  This value is required (e.g. ``--iterations=5``), the option itself is still optional
+InputOption::VALUE_OPTIONAL  This option may or may not have a value (e.g. ``yell`` or ``yell=loud``)
+===========================  =====================================================================================
 
 You can combine VALUE_IS_ARRAY with VALUE_REQUIRED or VALUE_OPTIONAL like this:
 
@@ -345,16 +345,16 @@ Calling a command from another one is straightforward::
         // ...
     }
 
-First, you :method:`Symfony\\Component\\Console\\Command\\Command::find` the
+First, you :method:`Symfony\\Component\\Console\\Application::find` the
 command you want to execute by passing the command name.
 
 Then, you need to create a new
 :class:`Symfony\\Component\\Console\\Input\\ArrayInput` with the arguments and
 options you want to pass to the command.
 
 Eventually, calling the ``run()`` method actually executes the command and
-returns the returned code from the command (``0`` if everything went fine, any
-other integer otherwise).
+returns the returned code from the command (return value from command's
+``execute()`` method).
 
 .. note::