merged branch gimler/fix_phpdocs (PR #3176)

Commits
-------

5bf1143 fix some translations component phpdocs

Discussion
----------

fix some translations component phpdocs

Bug fix: yes
Feature addition: no
Backwards compatibility break: no
Symfony2 tests pass: yes

src/Symfony/Component/Translation/Loader/LoaderInterface.php

@@ -25,9 +25,9 @@ interface LoaderInterface
     /**
      * Loads a locale.
      *
-     * @param  mixed  $resource A resource
-     * @param  string $locale   A locale
-     * @param  string $domain   The domain
+     * @param mixed  $resource A resource
+     * @param string $locale   A locale
+     * @param string $domain   The domain
      *
      * @return MessageCatalogue A MessageCatalogue instance
      *

src/Symfony/Component/Translation/Loader/MoFileLoader.php

@@ -65,7 +65,8 @@ class MoFileLoader extends ArrayLoader implements LoaderInterface
      * Parses machine object (MO) format, independent of the machine's endian it
      * was created on. Both 32bit and 64bit systems are supported.
      *
-     * @param resource $stream
+     * @param resource $resource
+     *
      * @return array
      * @throws InvalidArgumentException If stream content has an invalid format.
      */

src/Symfony/Component/Translation/Loader/PoFileLoader.php

@@ -49,7 +49,8 @@ class PoFileLoader extends ArrayLoader implements LoaderInterface
      *
      * Items with an empty id are ignored.
      *
-     * @param resource $stream
+     * @param resource $resource
+     *
      * @return array
      */
     private function parse($resource)

src/Symfony/Component/Translation/Loader/ResourceBundleLoader.php

@@ -58,9 +58,9 @@ class ResourceBundleLoader implements LoaderInterface
      *
      * This function takes an array by reference and will modify it
      *
-     * @param array \ResourceBundle $rb the ResourceBundle that will be flattened
-     * @param array $messages used internally for recursive calls
-     * @param string $path current path being parsed, used internally for recursive calls
+     * @param \ResourceBundle $rb        the ResourceBundle that will be flattened
+     * @param array           &$messages used internally for recursive calls
+     * @param string          $path      current path being parsed, used internally for recursive calls
      *
      * @return array the flattened ResourceBundle
      */

src/Symfony/Component/Translation/Writer/TranslationWriter.php

@@ -31,7 +31,7 @@ class TranslationWriter
     /**
      * Adds a dumper to the writer.
      *
-     * @param string $format The format of the dumper
+     * @param string          $format The format of the dumper
      * @param DumperInterface $dumper The dumper
      */
     public function addDumper($format, DumperInterface $dumper)