From 4faca9c2f9c38d648e0c0152d497bd6b3fd57e6f Mon Sep 17 00:00:00 2001
From: Joe Shindelar <eojthebrave@gmail.com>
Date: Tue, 17 Feb 2015 07:26:51 -0700
Subject: [PATCH] Updated routing events documentation.

---
 core/lib/Drupal/Core/Routing/RoutingEvents.php | 44 +++++++++++++++++++++++---
 1 file changed, 39 insertions(+), 5 deletions(-)

diff --git a/core/lib/Drupal/Core/Routing/RoutingEvents.php b/core/lib/Drupal/Core/Routing/RoutingEvents.php
index 8df9698..87247ae 100644
--- a/core/lib/Drupal/Core/Routing/RoutingEvents.php
+++ b/core/lib/Drupal/Core/Routing/RoutingEvents.php
@@ -13,21 +13,55 @@
 final class RoutingEvents {
 
   /**
-   * THE DYNAMIC event is fired on a route collection to allow new routes.
+   * Name of the event fired during route collection to allow new routes.
    *
-   * This event is used to add new routes based upon existing routes.
+   * This event is used to add new routes based upon existing routes, giving
+   * modules the opportunity to dynamically generate additional routes. The
+   * event listener method receives a \Drupal\Core\Routing\RouteBuildEvent
+   * instance.
+   *
+   * @Event
+   *
+   * @see \Drupal\Core\Routing\RouteBuildEvent
+   * @see \Drupal\Core\EventSubscriber\EntityRouteProviderSubscriber
+   * @see \Drupal\Core\Routing\RouteBuilder::rebuild()
+   *
+   * @var string
    */
   const DYNAMIC = 'routing.route_dynamic';
 
   /**
-   * The ALTER event is fired on a route collection to allow changes to routes.
+   * Name of the event fired during route collection to allow changes to routes.
+   *
+   * This event is used to process new routes before they get saved, giving
+   * modules the opportunity to alter routes provided by any other module. The
+   * event listener method receives a \Drupal\Core\Routing\RouteBuildEvent
+   * instance.
+   *
+   * @Event
    *
-   * This event is used to process new routes before they get saved.
+   * @see \Symfony\Component\Routing\RouteCollection
+   * @see \Drupal\system\EventSubscriber\AdminRouteSubscriber
+   * @see \Drupal\Core\Routing\RouteBuilder::rebuild()
+   *
+   * @var string
    */
   const ALTER = 'routing.route_alter';
 
   /**
-   * The FINISHED event is fired when the route building ended.
+   * Name of the event fired to indicate route building has ended.
+   *
+   * This event gives modules the opportunity to perform some action after route
+   * building has completed. The event listener receives a
+   * \Symfony\Component\EventDispatcher\Event instance.
+   *
+   * @Event
+   *
+   * @see \Symfony\Component\EventDispatcher\Event
+   * @see \Drupal\Core\EventSubscriber\MenuRouterRebuildSubscriber
+   * @see \Drupal\Core\Routing\RouteBuilder::rebuild()
+   *
+   * @var string
    */
   const FINISHED = 'routing.route_finished';
 
-- 
2.2.2