From c7f51e19e9ebd65adf79ebb40d9f77a4f4ff387f Mon Sep 17 00:00:00 2001
From: Joe Shindelar <eojthebrave@gmail.com>
Date: Thu, 12 Feb 2015 15:01:43 -0500
Subject: [PATCH] Initial pass at improving event configuration documentation.

---
 core/lib/Drupal/Core/Config/ConfigEvents.php | 70 +++++++++++++++++++++++++---
 1 file changed, 63 insertions(+), 7 deletions(-)

diff --git a/core/lib/Drupal/Core/Config/ConfigEvents.php b/core/lib/Drupal/Core/Config/ConfigEvents.php
index 7fc0750..0ba9075 100644
--- a/core/lib/Drupal/Core/Config/ConfigEvents.php
+++ b/core/lib/Drupal/Core/Config/ConfigEvents.php
@@ -15,48 +15,104 @@
 final class ConfigEvents {
 
   /**
-   * Name of event fired when saving the configuration object.
+   * Name of the event fired when saving a configuration object.
    *
+   * This event allows modules to perform an action whenever a configuration
+   * object is saved. The event listener method receives a
+   * \Drupal\Core\Config\ConfigCrudEvent instance.
+   *
+   * @Event
+   *
+   * @see \Drupal\Core\Config\ConfigCrudEvent
    * @see \Drupal\Core\Config\Config::save()
    * @see \Drupal\Core\Config\ConfigFactory::onConfigSave()
+   *
+   * @var string
    */
   const SAVE = 'config.save';
 
   /**
-   * Name of event fired when deleting the configuration object.
+   * Name of the event fired when deleting a configuration object.
+   *
+   * This event allows modules to perform an action whenever a configuration
+   * object is deleted. The event listener method receives a
+   * \Drupal\Core\Config\ConfigCrudEvent instance.
+   *
+   * @Event
    *
+   * @see \Drupal\Core\Config\ConfigCrudEvent
    * @see \Drupal\Core\Config\Config::delete()
+   * @see \Drupal\Core\Config\ConfigFactory::onConfigDelete()
+   *
+   * @var string
    */
   const DELETE = 'config.delete';
 
   /**
-   * Name of event fired when renaming a configuration object.
+   * Name of the event fired when renaming a configuration object.
+   *
+   * This event allows modules to perform an action whenever a configuration
+   * object's name is changed. The event listener method receives a
+   * \Drupal\Core\Config\ConfigRenameEvent instance.
+   *
+   * @Event
    *
+   * @see \Drupal\Core\Config\ConfigRenameEvent
    * @see \Drupal\Core\Config\ConfigFactoryInterface::rename().
+   *
+   * @var string
    */
   const RENAME = 'config.rename';
 
   /**
-   * Name of event fired when validating in the configuration import process.
+   * Name of the event fired when validating imported configuration.
+   *
+   * This event allows modules to perform additional validation operations when
+   * configuration is being imported. The event listener method receives a
+   * \Drupal\Core\Config\ConfigImporterEvent instance.
    *
+   * @Event
+   *
+   * @see \Drupal\Core\Config\ConfigImporterEvent
    * @see \Drupal\Core\Config\ConfigImporter::validate().
    * @see \Drupal\Core\EventSubscriber\ConfigImportSubscriber::onConfigImporterValidate().
+   *
+   * @var string
    */
   const IMPORT_VALIDATE = 'config.importer.validate';
 
   /**
-   * Name of event fired when when importing configuration to target storage.
+   * Name of the event fired when importing configuration to target storage.
+   *
+   * This event allows modules to perform additional actions when configuration
+   * is imported. The event listener method receives a
+   * \Drupal\Core\Config\ConfigImporterEvent instance.
    *
+   * @Event
+   *
+   * @see \Drupal\Core\Config\ConfigImporterEvent
    * @see \Drupal\Core\Config\ConfigImporter::import().
    * @see \Drupal\Core\EventSubscriber\ConfigSnapshotSubscriber::onConfigImporterImport().
+   *
+   * @var string
    */
   const IMPORT = 'config.importer.import';
 
   /**
-   * Name of event fired to collect information on all collections.
+   * Name of event fired to collect information on all config collections.
+   *
+   * This event allows modules to add to the list of configuration collections
+   * retrieved by \Drupal\Core\Config\ConfigManager::getConfigCollectionInfo().
+   * The event listener method receives a
+   * \Drupal\Core\Config\ConfigCollectionInfo instance.
+   *
+   * @Event
    *
-   * @see \Drupal\Core\Config\ConfigManager::getConfigCollectionInfo()
    * @see \Drupal\Core\Config\ConfigCollectionInfo
+   * @see \Drupal\Core\Config\ConfigManager::getConfigCollectionInfo()
+   * @see \Drupal\Core\Config\ConfigFactoryOverrideBase
+   *
+   * @var string
    */
   const COLLECTION_INFO = 'config.collection_info';
 
-- 
2.2.2