From 568e661155f5676c0fec2376077934ab05abc8b1 Mon Sep 17 00:00:00 2001
From: Adrien Brault <adrien.brault@gmail.com>
Date: Mon, 8 Jul 2013 17:35:00 +0200
Subject: [PATCH] Document the SubscribingHandlerInterface a bit

---
 .../Handler/SubscribingHandlerInterface.php         | 13 +++++++++++++
 1 file changed, 13 insertions(+)

diff --git a/src/JMS/Serializer/Handler/SubscribingHandlerInterface.php b/src/JMS/Serializer/Handler/SubscribingHandlerInterface.php
index a4e7b0bcf..b9623ca22 100644
--- a/src/JMS/Serializer/Handler/SubscribingHandlerInterface.php
+++ b/src/JMS/Serializer/Handler/SubscribingHandlerInterface.php
@@ -21,6 +21,19 @@
 interface SubscribingHandlerInterface
 {
     /**
+     * Return format:
+     *
+     *      array(
+     *          array(
+     *              'direction' => GraphNavigator::DIRECTION_SERIALIZATION,
+     *              'format' => 'json',
+     *              'type' => 'DateTime',
+     *              'method' => 'serializeDateTimeToJson',
+     *          ),
+     *      )
+     *
+     * The direction and method keys can be omitted.
+     *
      * @return array
      */
     public static function getSubscribingMethods();