merged branch lsmith77/serializer_api_docblock (PR #1843)

Commits
-------

6773cd7 [Serializer] removed @api since its not yet part of the stable API

Discussion
----------

[Serializer] removed @api since its not yet part of the stable API

sorry .. only realized this while shaving this morning ..

src/Symfony/Component/Serializer/Encoder/DecoderInterface.php

@@ -26,7 +26,6 @@ interface DecoderInterface
      * @param string $data data to decode
      * @param string $format format to decode from
      * @return mixed
-     * @api
      */
     function decode($data, $format);
 }

src/Symfony/Component/Serializer/Encoder/EncoderInterface.php

@@ -26,7 +26,6 @@ interface EncoderInterface
      * @param mixed $data data to encode
      * @param string $format format to encode to
      * @return string
-     * @api
      */
     function encode($data, $format);
 }

src/Symfony/Component/Serializer/Normalizer/NormalizerInterface.php

@@ -26,7 +26,6 @@ interface NormalizerInterface
      * @param object $object object to normalize
      * @param string $format format the normalization result will be encoded as
      * @return array|scalar
-     * @api
      */
     function normalize($object, $format = null);
 
@@ -37,7 +36,6 @@ interface NormalizerInterface
      * @param string $class the expected class to instantiate
      * @param string $format format the given data was extracted from
      * @return object
-     * @api
      */
     function denormalize($data, $class, $format = null);
 
@@ -47,7 +45,6 @@ interface NormalizerInterface
      * @param mixed   $data   Data to normalize.
      * @param string  $format The format being (de-)serialized from or into.
      * @return Boolean
-     * @api
      */
     function supportsNormalization($data, $format = null);
 
@@ -58,7 +55,6 @@ interface NormalizerInterface
      * @param string  $type   The class to which the data should be denormalized.
      * @param string  $format The format being deserialized from.
      * @return Boolean
-     * @api
      */
     function supportsDenormalization($data, $type, $format = null);
 }

src/Symfony/Component/Serializer/SerializerAwareInterface.php

@@ -24,7 +24,6 @@ interface SerializerAwareInterface
      * Sets the owning Serializer object
      *
      * @param SerializerInterface $serializer
-     * @api
      */
     function setSerializer(SerializerInterface $serializer);
 }

src/Symfony/Component/Serializer/SerializerInterface.php

@@ -29,7 +29,6 @@ interface SerializerInterface
      * @param mixed $data any data
      * @param string $format format name
      * @return string
-     * @api
      */
     function serialize($data, $format);
 
@@ -39,7 +38,6 @@ interface SerializerInterface
      * @param mixed $data
      * @param string $type
      * @param string $format
-     * @api
      */
     function deserialize($data, $type, $format);
 
@@ -49,7 +47,6 @@ interface SerializerInterface
      * @param mixed $data data to normalize
      * @param string $format format name, present to give the option to normalizers to act differently based on formats
      * @return array|scalar
-     * @api
      */
     function normalize($data, $format = null);
 
@@ -60,7 +57,6 @@ interface SerializerInterface
      * @param string $type
      * @param string $format
      * @return mixed
-     * @api
      */
     function denormalize($data, $type, $format = null);
 
@@ -70,7 +66,6 @@ interface SerializerInterface
      * @param mixed $data data to encode
      * @param string $format format name
      * @return array|scalar
-     * @api
      */
     function encode($data, $format);
 
@@ -80,7 +75,6 @@ interface SerializerInterface
      * @param string $data data to decode
      * @param string $format format name
      * @return mixed
-     * @api
      */
     function decode($data, $format);
 
@@ -89,7 +83,6 @@ interface SerializerInterface
      *
      * @param string $format format name
      * @return Boolean
-     * @api
      */
     function supportsSerialization($format);
 
@@ -98,7 +91,6 @@ interface SerializerInterface
      *
      * @param string $format format name
      * @return Boolean
-     * @api
      */
     function supportsDeserialization($format);
 
@@ -107,7 +99,6 @@ interface SerializerInterface
      *
      * @param string $format format name
      * @return Boolean
-     * @api
      */
     function supportsEncoding($format);
 
@@ -116,7 +107,6 @@ interface SerializerInterface
      *
      * @param string $format format name
      * @return Boolean
-     * @api
      */
     function supportsDecoding($format);
 
@@ -124,7 +114,6 @@ interface SerializerInterface
      * Get the encoder for the given format
      *
      * @return EncoderInterface
-     * @api
      */
     function getEncoder($format);
 }