svn commit: r1232792 - /camel/trunk/camel-core/src/main/java/org/apache/camel/CamelContext.java

[da...@apache.org]

Author: davsclaus
Date: Wed Jan 18 09:02:47 2012
New Revision: 1232792

URL: http://svn.apache.org/viewvc?rev=1232792&view=rev
Log:
Polished

Modified:
    camel/trunk/camel-core/src/main/java/org/apache/camel/CamelContext.java

Modified: camel/trunk/camel-core/src/main/java/org/apache/camel/CamelContext.java
URL: http://svn.apache.org/viewvc/camel/trunk/camel-core/src/main/java/org/apache/camel/CamelContext.java?rev=1232792&r1=1232791&r2=1232792&view=diff
==============================================================================
--- camel/trunk/camel-core/src/main/java/org/apache/camel/CamelContext.java (original)
+++ camel/trunk/camel-core/src/main/java/org/apache/camel/CamelContext.java Wed Jan 18 09:02:47 2012
@@ -359,7 +359,11 @@ public interface CamelContext extends Su
 
     /**
      * Adds a collection of routes to this context using the given builder
-     * to build them
+     * to build them.
+     * <p/>
+     * <b>Important:</b> The added routes will <b>only</b> be started, if {@link CamelContext}
+     * is already started. You may want to check the state of {@link CamelContext} before
+     * adding the routes, using the {@link org.apache.camel.CamelContext#getStatus()} method.
      *
      * @param builder the builder which will create the routes and add them to this context
      * @throws Exception if the routes could not be created for whatever reason