[Serializer] Fix CS. Uniformize PHPDoc.

dunglas · dunglas · commit 5be84c4bf05c · 2014-10-02T20:41:27.000+02:00
diff --git a/src/Symfony/Component/Serializer/Encoder/ChainDecoder.php b/src/Symfony/Component/Serializer/Encoder/ChainDecoder.php
@@ -58,6 +58,7 @@ public function supportsDecoding($format)
      * @param string $format
      *
      * @return DecoderInterface
+     *
      * @throws RuntimeException if no decoder is found
      */
     private function getDecoder($format)
diff --git a/src/Symfony/Component/Serializer/Encoder/ChainEncoder.php b/src/Symfony/Component/Serializer/Encoder/ChainEncoder.php
@@ -80,6 +80,7 @@ public function needsNormalization($format)
      * @param string $format
      *
      * @return EncoderInterface
+     *
      * @throws RuntimeException if no encoder is found
      */
     private function getEncoder($format)
diff --git a/src/Symfony/Component/Serializer/Encoder/DecoderInterface.php b/src/Symfony/Component/Serializer/Encoder/DecoderInterface.php
@@ -14,7 +14,7 @@
 use Symfony\Component\Serializer\Exception\UnexpectedValueException;
 
 /**
- * Defines the interface of decoders
+ * Defines the interface of decoders.
  *
  * @author Jordi Boggiano <j.boggiano@seld.be>
  */
@@ -23,9 +23,9 @@ interface DecoderInterface
     /**
      * Decodes a string into PHP data.
      *
-     * @param scalar $data      Data to decode
-     * @param string $format    Format name
-     * @param array  $context   options that decoders have access to.
+     * @param scalar $data    Data to decode
+     * @param string $format  Format name
+     * @param array  $context options that decoders have access to.
      *
      * The format parameter specifies which format the data is in; valid values
      * depend on the specific implementation. Authors implementing this interface
diff --git a/src/Symfony/Component/Serializer/Encoder/EncoderInterface.php b/src/Symfony/Component/Serializer/Encoder/EncoderInterface.php
@@ -14,17 +14,17 @@
 use Symfony\Component\Serializer\Exception\UnexpectedValueException;
 
 /**
- * Defines the interface of encoders
+ * Defines the interface of encoders.
  *
  * @author Jordi Boggiano <j.boggiano@seld.be>
  */
 interface EncoderInterface
 {
     /**
-     * Encodes data into the given format
+     * Encodes data into the given format.
      *
-     * @param mixed  $data   Data to encode
-     * @param string $format Format name
+     * @param mixed  $data    Data to encode
+     * @param string $format  Format name
      * @param array  $context options that normalizers/encoders have access to.
      *
      * @return scalar
@@ -34,7 +34,7 @@ interface EncoderInterface
     public function encode($data, $format, array $context = array());
 
     /**
-     * Checks whether the serializer can encode to given format
+     * Checks whether the serializer can encode to given format.
      *
      * @param string $format format name
      *
diff --git a/src/Symfony/Component/Serializer/Encoder/JsonDecode.php b/src/Symfony/Component/Serializer/Encoder/JsonDecode.php
@@ -41,8 +41,8 @@ class JsonDecode implements DecoderInterface
     /**
      * Constructs a new JsonDecode instance.
      *
-     * @param bool     $associative True to return the result associative array, false for a nested stdClass hierarchy
-     * @param int      $depth       Specifies the recursion depth
+     * @param bool $associative True to return the result associative array, false for a nested stdClass hierarchy
+     * @param int  $depth       Specifies the recursion depth
      */
     public function __construct($associative = false, $depth = 512)
     {
diff --git a/src/Symfony/Component/Serializer/Encoder/JsonEncode.php b/src/Symfony/Component/Serializer/Encoder/JsonEncode.php
@@ -14,7 +14,7 @@
 use Symfony\Component\Serializer\Exception\UnexpectedValueException;
 
 /**
- * Encodes JSON data
+ * Encodes JSON data.
  *
  * @author Sander Coolen <sander@jibber.nl>
  */
@@ -43,7 +43,7 @@ public function getLastError()
     }
 
     /**
-     * Encodes PHP data to a JSON string
+     * Encodes PHP data to a JSON string.
      *
      * {@inheritdoc}
      */
@@ -71,7 +71,8 @@ public function supportsEncoding($format)
     /**
      * Merge default json encode options with context.
      *
-     * @param array $context
+     * @param  array $context
+     *
      * @return array
      */
     private function resolveContext(array $context = array())
diff --git a/src/Symfony/Component/Serializer/Encoder/JsonEncoder.php b/src/Symfony/Component/Serializer/Encoder/JsonEncoder.php
@@ -37,7 +37,7 @@ public function __construct(JsonEncode $encodingImpl = null, JsonDecode $decodin
     }
 
     /**
-     * Returns the last encoding error (if any)
+     * Returns the last encoding error (if any).
      *
      * @return int
      *
@@ -49,7 +49,7 @@ public function getLastEncodingError()
     }
 
     /**
-     * Returns the last decoding error (if any)
+     * Returns the last decoding error (if any).
      *
      * @return int
      *
diff --git a/src/Symfony/Component/Serializer/Encoder/NormalizationAwareInterface.php b/src/Symfony/Component/Serializer/Encoder/NormalizationAwareInterface.php
@@ -12,7 +12,7 @@
 namespace Symfony\Component\Serializer\Encoder;
 
 /**
- * Defines the interface of encoders that will normalize data themselves
+ * Defines the interface of encoders that will normalize data themselves.
  *
  * Implementing this interface essentially just tells the Serializer that the
  * data should not be pre-normalized before being passed to this Encoder.
diff --git a/src/Symfony/Component/Serializer/Encoder/SerializerAwareEncoder.php b/src/Symfony/Component/Serializer/Encoder/SerializerAwareEncoder.php
@@ -15,7 +15,7 @@
 use Symfony\Component\Serializer\SerializerAwareInterface;
 
 /**
- * SerializerAware Encoder implementation
+ * SerializerAware Encoder implementation.
  *
  * @author Jordi Boggiano <j.boggiano@seld.be>
  */
diff --git a/src/Symfony/Component/Serializer/Encoder/XmlEncoder.php b/src/Symfony/Component/Serializer/Encoder/XmlEncoder.php
@@ -14,7 +14,7 @@
 use Symfony\Component\Serializer\Exception\UnexpectedValueException;
 
 /**
- * Encodes XML data
+ * Encodes XML data.
  *
  * @author Jordi Boggiano <j.boggiano@seld.be>
  * @author John Wards <jwards@whiteoctober.co.uk>
@@ -146,7 +146,7 @@ public function supportsDecoding($format)
      }
 
     /**
-     * Sets the root node name
+     * Sets the root node name.
      *
      * @param string $name root node name
      */
@@ -156,7 +156,8 @@ public function setRootNodeName($name)
     }
 
     /**
-     * Returns the root node name
+     * Returns the root node name.
+     *
      * @return string
      */
     public function getRootNodeName()
@@ -229,7 +230,7 @@ final protected function appendDocumentFragment(\DOMNode $node, $fragment)
     }
 
     /**
-     * Checks the name is a valid xml element name
+     * Checks the name is a valid xml element name.
      *
      * @param string $name
      *
@@ -279,7 +280,7 @@ private function parseXml(\DOMNode $node)
     }
 
     /**
-     * Parse the input DOMNode attributes into an array
+     * Parse the input DOMNode attributes into an array.
      *
      * @param \DOMNode $node xml to parse
      *
@@ -305,7 +306,7 @@ private function parseXmlAttributes(\DOMNode $node)
     }
 
     /**
-     * Parse the input DOMNode value (content and children) into an array or a string
+     * Parse the input DOMNode value (content and children) into an array or a string.
      *
      * @param \DOMNode $node xml to parse
      *
@@ -347,7 +348,7 @@ private function parseXmlValue(\DOMNode $node)
     }
 
     /**
-     * Parse the data and convert it to DOMElements
+     * Parse the data and convert it to DOMElements.
      *
      * @param \DOMNode     $parentNode
      * @param array|object $data
@@ -452,7 +453,7 @@ private function needsCdataWrapping($val)
     }
 
     /**
-     * Tests the value being passed and decide what sort of element to create
+     * Tests the value being passed and decide what sort of element to create.
      *
      * @param \DOMNode $node
      * @param mixed    $val
@@ -488,6 +489,10 @@ private function selectNodeType(\DOMNode $node, $val)
 
     /**
      * Get real XML root node name, taking serializer options into account.
+     *
+     * @param array $context
+     *
+     * @return string
      */
     private function resolveXmlRootName(array $context = array())
     {
diff --git a/src/Symfony/Component/Serializer/Normalizer/DenormalizableInterface.php b/src/Symfony/Component/Serializer/Normalizer/DenormalizableInterface.php
@@ -12,7 +12,7 @@
 namespace Symfony\Component\Serializer\Normalizer;
 
 /**
- * Defines the most basic interface a class must implement to be denormalizable
+ * Defines the most basic interface a class must implement to be denormalizable.
  *
  * If a denormalizer is registered for the class and it doesn't implement
  * the Denormalizable interfaces, the normalizer will be used instead
@@ -28,11 +28,11 @@ interface DenormalizableInterface
      * recursively all child objects of the implementor.
      *
      * @param DenormalizerInterface $denormalizer The denormalizer is given so that you
-     *   can use it to denormalize objects contained within this object.
-     * @param array|scalar $data   The data from which to re-create the object.
-     * @param string|null  $format The format is optionally given to be able to denormalize differently
-     *   based on different input formats.
-     * @param array        $context options for denormalizing
+     *                                            can use it to denormalize objects contained within this object.
+     * @param array|scalar          $data         The data from which to re-create the object.
+     * @param string|null           $format       The format is optionally given to be able to denormalize differently
+     *                                            based on different input formats.
+     * @param array                 $context      options for denormalizing.
      */
     public function denormalize(DenormalizerInterface $denormalizer, $data, $format = null, array $context = array());
 }
diff --git a/src/Symfony/Component/Serializer/Normalizer/DenormalizerInterface.php b/src/Symfony/Component/Serializer/Normalizer/DenormalizerInterface.php
@@ -19,19 +19,19 @@
 interface DenormalizerInterface
 {
     /**
-     * Denormalizes data back into an object of the given class
+     * Denormalizes data back into an object of the given class.
      *
-     * @param mixed  $data   data to restore
-     * @param string $class  the expected class to instantiate
-     * @param string $format format the given data was extracted from
+     * @param mixed  $data    data to restore
+     * @param string $class   the expected class to instantiate
+     * @param string $format  format the given data was extracted from
      * @param array  $context options available to the denormalizer
      *
      * @return object
      */
     public function denormalize($data, $class, $format = null, array $context = array());
 
     /**
-     * Checks whether the given class is supported for denormalization by this normalizer
+     * Checks whether the given class is supported for denormalization by this normalizer.
      *
      * @param mixed  $data   Data to denormalize from.
      * @param string $type   The class to which the data should be denormalized.
diff --git a/src/Symfony/Component/Serializer/Normalizer/GetSetMethodNormalizer.php b/src/Symfony/Component/Serializer/Normalizer/GetSetMethodNormalizer.php
@@ -47,7 +47,7 @@ class GetSetMethodNormalizer extends SerializerAwareNormalizer implements Normal
      *
      * @throws InvalidArgumentException if a non-callable callback is set
      *
-     * @return GetSetMethodNormalizer
+     * @return self
      */
     public function setCallbacks(array $callbacks)
     {
@@ -62,11 +62,11 @@ public function setCallbacks(array $callbacks)
     }
 
     /**
-     * Set ignored attributes for normalization
+     * Set ignored attributes for normalization.
      *
      * @param array $ignoredAttributes
      *
-     * @return GetSetMethodNormalizer
+     * @return self
      */
     public function setIgnoredAttributes(array $ignoredAttributes)
     {
@@ -76,11 +76,11 @@ public function setIgnoredAttributes(array $ignoredAttributes)
     }
 
     /**
-     * Set attributes to be camelized on denormalize
+     * Set attributes to be camelized on denormalize.
      *
      * @param array $camelizedAttributes
      *
-     * @return GetSetMethodNormalizer
+     * @return self
      */
     public function setCamelizedAttributes(array $camelizedAttributes)
     {
@@ -185,9 +185,10 @@ public function denormalize($data, $class, $format = null, array $context = arra
     /**
      * Format attribute name to access parameters or methods
      * As option, if attribute name is found on camelizedAttributes array
-     * returns attribute name in camelcase format
+     * returns attribute name in camelcase format.
+     *
+     * @param  string $attributeName
      *
-     * @param string $attributeName
      * @return string
      */
     protected function formatAttribute($attributeName)
diff --git a/src/Symfony/Component/Serializer/Normalizer/NormalizableInterface.php b/src/Symfony/Component/Serializer/Normalizer/NormalizableInterface.php
@@ -12,10 +12,10 @@
 namespace Symfony\Component\Serializer\Normalizer;
 
 /**
- * Defines the most basic interface a class must implement to be normalizable
+ * Defines the most basic interface a class must implement to be normalizable.
  *
  * If a normalizer is registered for the class and it doesn't implement
- * the Normalizable interfaces, the normalizer will be used instead
+ * the Normalizable interfaces, the normalizer will be used instead.
  *
  * @author Jordi Boggiano <j.boggiano@seld.be>
  */
@@ -28,10 +28,10 @@ interface NormalizableInterface
      * recursively all child objects of the implementor.
      *
      * @param NormalizerInterface $normalizer The normalizer is given so that you
-     *   can use it to normalize objects contained within this object.
-     * @param string|null $format The format is optionally given to be able to normalize differently
-     *   based on different output formats.
-     * @param array $context Options for normalizing this object
+     *                                        can use it to normalize objects contained within this object.
+     * @param string|null         $format     The format is optionally given to be able to normalize differently
+     *                                        based on different output formats.
+     * @param array               $context    Options for normalizing this object
      *
      * @return array|scalar
      */
diff --git a/src/Symfony/Component/Serializer/Normalizer/NormalizerInterface.php b/src/Symfony/Component/Serializer/Normalizer/NormalizerInterface.php
@@ -19,18 +19,18 @@
 interface NormalizerInterface
 {
     /**
-     * Normalizes an object into a set of arrays/scalars
+     * Normalizes an object into a set of arrays/scalars.
      *
-     * @param object $object object to normalize
-     * @param string $format format the normalization result will be encoded as
-     * @param array $context Context options for the normalizer
+     * @param object $object  object to normalize
+     * @param string $format  format the normalization result will be encoded as
+     * @param array  $context Context options for the normalizer
      *
      * @return array|scalar
      */
     public function normalize($object, $format = null, array $context = array());
 
     /**
-     * Checks whether the given class is supported for normalization by this normalizer
+     * Checks whether the given class is supported for normalization by this normalizer.
      *
      * @param mixed  $data   Data to normalize.
      * @param string $format The format being (de-)serialized from or into.
diff --git a/src/Symfony/Component/Serializer/Normalizer/PropertyNormalizer.php b/src/Symfony/Component/Serializer/Normalizer/PropertyNormalizer.php
@@ -57,7 +57,7 @@ public function setCallbacks(array $callbacks)
     }
 
     /**
-     * Set ignored attributes for normalization
+     * Set ignored attributes for normalization.
      *
      * @param array $ignoredAttributes
      */
@@ -180,7 +180,7 @@ public function supportsDenormalization($data, $type, $format = null)
     /**
      * Format an attribute name, for example to convert a snake_case name to camelCase.
      *
-     * @param string $attributeName
+     * @param  string $attributeName
      * @return string
      */
     protected function formatAttribute($attributeName)
diff --git a/src/Symfony/Component/Serializer/Normalizer/SerializerAwareNormalizer.php b/src/Symfony/Component/Serializer/Normalizer/SerializerAwareNormalizer.php
diff --git a/src/Symfony/Component/Serializer/Serializer.php b/src/Symfony/Component/Serializer/Serializer.php
diff --git a/src/Symfony/Component/Serializer/SerializerAwareInterface.php b/src/Symfony/Component/Serializer/SerializerAwareInterface.php
diff --git a/src/Symfony/Component/Serializer/SerializerInterface.php b/src/Symfony/Component/Serializer/SerializerInterface.php

Original file line number	Diff line number	Diff line change
`@@ -58,6 +58,7 @@ public function supportsDecoding($format)`
`58`	`58`	`* @param string $format`
`59`	`59`	`*`
`60`	`60`	`* @return DecoderInterface`
	`61`	`+ *`
`61`	`62`	`* @throws RuntimeException if no decoder is found`
`62`	`63`	`*/`
`63`	`64`	`private function getDecoder($format)`
Original file line number	Diff line number	Diff line change
`@@ -80,6 +80,7 @@ public function needsNormalization($format)`
`80`	`80`	`* @param string $format`
`81`	`81`	`*`
`82`	`82`	`* @return EncoderInterface`
	`83`	`+ *`
`83`	`84`	`* @throws RuntimeException if no encoder is found`
`84`	`85`	`*/`
`85`	`86`	`private function getEncoder($format)`
Original file line number	Diff line number	Diff line change
`@@ -14,17 +14,17 @@`
`14`	`14`	`use Symfony\Component\Serializer\Exception\UnexpectedValueException;`
`15`	`15`
`16`	`16`	`/**`
`17`		`- * Defines the interface of encoders`
	`17`	`+ * Defines the interface of encoders.`
`18`	`18`	`*`
`19`	`19`	`* @author Jordi Boggiano <j.boggiano@seld.be>`
`20`	`20`	`*/`
`21`	`21`	`interface EncoderInterface`
`22`	`22`	`{`
`23`	`23`	`/**`
`24`		`- * Encodes data into the given format`
	`24`	`+ * Encodes data into the given format.`
`25`	`25`	`*`
`26`		`- * @param mixed $data Data to encode`
`27`		`- * @param string $format Format name`
	`26`	`+ * @param mixed $data Data to encode`
	`27`	`+ * @param string $format Format name`
`28`	`28`	`* @param array $context options that normalizers/encoders have access to.`
`29`	`29`	`*`
`30`	`30`	`* @return scalar`
`@@ -34,7 +34,7 @@ interface EncoderInterface`
`34`	`34`	`public function encode($data, $format, array $context = array());`
`35`	`35`
`36`	`36`	`/**`
`37`		`- * Checks whether the serializer can encode to given format`
	`37`	`+ * Checks whether the serializer can encode to given format.`
`38`	`38`	`*`
`39`	`39`	`* @param string $format format name`
`40`	`40`	`*`
Original file line number	Diff line number	Diff line change
`@@ -41,8 +41,8 @@ class JsonDecode implements DecoderInterface`
`41`	`41`	`/**`
`42`	`42`	`* Constructs a new JsonDecode instance.`
`43`	`43`	`*`
`44`		`- * @param bool $associative True to return the result associative array, false for a nested stdClass hierarchy`
`45`		`- * @param int $depth Specifies the recursion depth`
	`44`	`+ * @param bool $associative True to return the result associative array, false for a nested stdClass hierarchy`
	`45`	`+ * @param int $depth Specifies the recursion depth`
`46`	`46`	`*/`
`47`	`47`	`public function __construct($associative = false, $depth = 512)`
`48`	`48`	`{`
Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@`
`14`	`14`	`use Symfony\Component\Serializer\Exception\UnexpectedValueException;`
`15`	`15`
`16`	`16`	`/**`
`17`		`- * Encodes JSON data`
	`17`	`+ * Encodes JSON data.`
`18`	`18`	`*`
`19`	`19`	`* @author Sander Coolen <sander@jibber.nl>`
`20`	`20`	`*/`
`@@ -43,7 +43,7 @@ public function getLastError()`
`43`	`43`	`}`
`44`	`44`
`45`	`45`	`/**`
`46`		`- * Encodes PHP data to a JSON string`
	`46`	`+ * Encodes PHP data to a JSON string.`
`47`	`47`	`*`
`48`	`48`	`* {@inheritdoc}`
`49`	`49`	`*/`
`@@ -71,7 +71,8 @@ public function supportsEncoding($format)`
`71`	`71`	`/**`
`72`	`72`	`* Merge default json encode options with context.`
`73`	`73`	`*`
`74`		`- * @param array $context`
	`74`	`+ * @param array $context`
	`75`	`+ *`
`75`	`76`	`* @return array`
`76`	`77`	`*/`
`77`	`78`	`private function resolveContext(array $context = array())`
Original file line number	Diff line number	Diff line change
`@@ -37,7 +37,7 @@ public function __construct(JsonEncode $encodingImpl = null, JsonDecode $decodin`
`37`	`37`	`}`
`38`	`38`
`39`	`39`	`/**`
`40`		`- * Returns the last encoding error (if any)`
	`40`	`+ * Returns the last encoding error (if any).`
`41`	`41`	`*`
`42`	`42`	`* @return int`
`43`	`43`	`*`
`@@ -49,7 +49,7 @@ public function getLastEncodingError()`
`49`	`49`	`}`
`50`	`50`
`51`	`51`	`/**`
`52`		`- * Returns the last decoding error (if any)`
	`52`	`+ * Returns the last decoding error (if any).`
`53`	`53`	`*`
`54`	`54`	`* @return int`
`55`	`55`	`*`
Original file line number	Diff line number	Diff line change
`@@ -12,7 +12,7 @@`
`12`	`12`	`namespace Symfony\Component\Serializer\Encoder;`
`13`	`13`
`14`	`14`	`/**`
`15`		`- * Defines the interface of encoders that will normalize data themselves`
	`15`	`+ * Defines the interface of encoders that will normalize data themselves.`
`16`	`16`	`*`
`17`	`17`	`* Implementing this interface essentially just tells the Serializer that the`
`18`	`18`	`* data should not be pre-normalized before being passed to this Encoder.`
Original file line number	Diff line number	Diff line change
`@@ -15,7 +15,7 @@`
`15`	`15`	`use Symfony\Component\Serializer\SerializerAwareInterface;`
`16`	`16`
`17`	`17`	`/**`
`18`		`- * SerializerAware Encoder implementation`
	`18`	`+ * SerializerAware Encoder implementation.`
`19`	`19`	`*`
`20`	`20`	`* @author Jordi Boggiano <j.boggiano@seld.be>`
`21`	`21`	`*/`