[camel] branch master updated: Polish javadoc due user forum issue

[da...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

davsclaus pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/camel.git


The following commit(s) were added to refs/heads/master by this push:
     new 0d6a998  Polish javadoc due user forum issue
0d6a998 is described below

commit 0d6a998b9941e15fa4b4d31ef9813aad84abd2ce
Author: Claus Ibsen <cl...@gmail.com>
AuthorDate: Thu Nov 2 19:27:23 2017 +0100

    Polish javadoc due user forum issue
---
 camel-core/src/main/java/org/apache/camel/StartupListener.java | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

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 a797d44..0d66d30 100644
--- a/camel-core/src/main/java/org/apache/camel/StartupListener.java
+++ b/camel-core/src/main/java/org/apache/camel/StartupListener.java
@@ -24,10 +24,14 @@ package org.apache.camel;
  * 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}.
+ * The callback is invoked during the routes startup procedure when 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.
+ * <p/>
+ * <b>Important:</b> You cannot use this listener to add and start new routes to the {@link CamelContext} as this is not
+ * supported by design, as this listener plays a role during starting up routes. Instead you can use an {@link org.apache.camel.spi.EventNotifier}
+ * and listen on the {@link org.apache.camel.management.event.CamelContextStartedEvent} event and then add and start new routes from there.
  *
  * @version 
  */

-- 
To stop receiving notification emails like this one, please contact
['"commits@camel.apache.org" <co...@camel.apache.org>'].