From 3f0c0d88482b0dddf30f600c47f61cf51a849063 Mon Sep 17 00:00:00 2001
From: Mark Story <mark@mark-story.com>
Date: Sun, 28 Feb 2010 01:55:23 -0500
Subject: [PATCH] Adding doc blocks for new methods.

---
 cake/libs/controller/component.php  | 7 +++++++
 cake/libs/controller/controller.php | 7 +++++++
 2 files changed, 14 insertions(+)

diff --git a/cake/libs/controller/component.php b/cake/libs/controller/component.php
index e72fb3086..15e41eb76 100644
--- a/cake/libs/controller/component.php
+++ b/cake/libs/controller/component.php
@@ -167,6 +167,13 @@ class Component extends Object {
  * that have such a method.  You can implement and fire custom callbacks in addition to the
  * standard ones.
  *
+ * example use, from inside a controller:
+ *
+ * `$this->Component->triggerCallback('beforeFilter', $this);`
+ *
+ * will trigger the beforeFilter callback on all components that have implemented one. You
+ * can trigger any method in this fashion.
+ *
  * @param Controller $controller Controller instance
  * @param string $callback Callback to trigger.
  * @return void
diff --git a/cake/libs/controller/controller.php b/cake/libs/controller/controller.php
index 8b8e7dcc9..bde4969fc 100644
--- a/cake/libs/controller/controller.php
+++ b/cake/libs/controller/controller.php
@@ -518,6 +518,10 @@ class Controller extends Object {
  * Perform the startup process for this controller.
  * Fire the Component and Controller callbacks in the correct order.
  *
+ * - Initializes components, which fires their `initialize` callback
+ * - Calls the controller `beforeFilter`.
+ * - triggers Component `startup` methods.
+ *
  * @return void
  * @access public
  */
@@ -531,6 +535,9 @@ class Controller extends Object {
  * Perform the various shutdown processes for this controller.
  * Fire the Component and Controller callbacks in the correct order.
  *
+ * - triggers the component `shutdown` callback.
+ * - calls the Controller's `afterFilter` method.
+ *
  * @return void
  * @access public
  */