[EventDispatcher] tweaked public @api

Author: fabpot

Event.php

@@ -37,6 +37,8 @@
  * @author  Jonathan Wage <jonwage@gmail.com>
  * @author  Roman Borschel <roman@code-factory.org>
  * @author  Bernhard Schussek <bschussek@gmail.com>
+ *
+ * @api
  */
 class Event
 {
@@ -50,6 +52,8 @@ class Event
      *
      * @see Event::stopPropagation
      * @return Boolean Whether propagation was already stopped for this event.
+     *
+     * @api
      */
     public function isPropagationStopped()
     {
@@ -62,6 +66,8 @@ public function isPropagationStopped()
      * If multiple event listeners are connected to the same event, no
      * further event listener will be triggered once any trigger calls
      * stopPropagation().
+     *
+     * @api
      */
     public function stopPropagation()
     {

EventDispatcher.php

@@ -61,8 +61,6 @@ public function dispatch($eventName, Event $event = null)
 
     /**
      * @see EventDispatcherInterface::getListeners
-     *
-     * @api
      */
     public function getListeners($eventName = null)
     {
@@ -89,8 +87,6 @@ public function getListeners($eventName = null)
 
     /**
      * @see EventDispatcherInterface::hasListeners
-     *
-     * @api
      */
     public function hasListeners($eventName = null)
     {
@@ -126,6 +122,8 @@ public function removeListener($eventName, $listener)
 
     /**
      * @see EventDispatcherInterface::addSubscriber
+     *
+     * @api
      */
     public function addSubscriber(EventSubscriberInterface $subscriber)
     {

EventDispatcherInterface.php

@@ -79,8 +79,6 @@ function removeSubscriber(EventSubscriberInterface $subscriber);
      *
      * @return array The event listeners for the specified event, or all event
      *               listeners by event name.
-     *
-     * @api
      */
     function getListeners($eventName = null);
 
@@ -91,8 +89,6 @@ function getListeners($eventName = null);
      *
      * @return Boolean TRUE if the specified event has any listeners, FALSE
      *                 otherwise.
-     *
-     * @api
      */
     function hasListeners($eventName = null);
 }

EventSubscriberInterface.php

@@ -33,6 +33,8 @@
  * @author  Jonathan Wage <jonwage@gmail.com>
  * @author  Roman Borschel <roman@code-factory.org>
  * @author  Bernhard Schussek <bschussek@gmail.com>
+ *
+ * @api
  */
 interface EventSubscriberInterface
 {
@@ -50,6 +52,8 @@ interface EventSubscriberInterface
      *  * array('eventName' => array('methodName', $priority))
      *
      * @return array The event names to listen to
+     *
+     * @api
      */
     static function getSubscribedEvents();
 }