git commit: CAMEL-6426: Polished javadoc to be more accurate.

[da...@apache.org]

Updated Branches:
  refs/heads/camel-2.11.x be41c4dd5 -> 66e1c2812


CAMEL-6426: Polished javadoc to be more accurate.


Project: http://git-wip-us.apache.org/repos/asf/camel/repo
Commit: http://git-wip-us.apache.org/repos/asf/camel/commit/66e1c281
Tree: http://git-wip-us.apache.org/repos/asf/camel/tree/66e1c281
Diff: http://git-wip-us.apache.org/repos/asf/camel/diff/66e1c281

Branch: refs/heads/camel-2.11.x
Commit: 66e1c281288d06c0aa9a04ec607e7d9cf7a85af8
Parents: be41c4d
Author: Claus Ibsen <da...@apache.org>
Authored: Wed Jun 5 15:23:55 2013 +0200
Committer: Claus Ibsen <da...@apache.org>
Committed: Wed Jun 5 15:27:59 2013 +0200

----------------------------------------------------------------------
 .../java/org/apache/camel/StartupListener.java     |    9 ++++++---
 1 files changed, 6 insertions(+), 3 deletions(-)
----------------------------------------------------------------------


http://git-wip-us.apache.org/repos/asf/camel/blob/66e1c281/camel-core/src/main/java/org/apache/camel/StartupListener.java
----------------------------------------------------------------------
diff --git a/camel-core/src/main/java/org/apache/camel/StartupListener.java b/camel-core/src/main/java/org/apache/camel/StartupListener.java
index da5daec..a797d44 100644
--- a/camel-core/src/main/java/org/apache/camel/StartupListener.java
+++ b/camel-core/src/main/java/org/apache/camel/StartupListener.java
@@ -17,12 +17,15 @@
 package org.apache.camel;
 
 /**
- * Allows objects to be notified when {@link CamelContext} has just been started.
+ * Allows objects to be notified when {@link CamelContext} has done all work when starting.
  * <p/>
- * This can be used to perform any custom work when the entire {@link CamelContext} has been initialized and started.
- * For example this ensures that all Camel routes have been started and are up and running, before this callback
+ * This can be used to perform any custom work when the entire {@link CamelContext} has been initialized and <b>almost</b>
+ * started. For example this ensures that all Camel routes have been started and are up and running, before this callback
  * is invoked.
  * <p/>
+ * The state of {@link CamelContext} may still be in <tt>starting</tt> when this callback is invoked, this is by design.
+ * The callback is invoked as the last step during all the processes that occur during starting {@link CamelContext}.
+ * <p/>
  * For example the QuartzComponent leverages this to ensure the Quartz scheduler does not start until after all the
  * Camel routes and services have already been started.
  *