CAMEL-4826: Polished code comment and java doc. Thanks to Glen Mazza for the patch.

git-svn-id: https://svn.apache.org/repos/asf/camel/trunk@1224915 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/camel-core/src/main/java/org/apache/camel/builder/ExpressionBuilder.java b/camel-core/src/main/java/org/apache/camel/builder/ExpressionBuilder.java
index c23e5b7..94a4722 100644
--- a/camel-core/src/main/java/org/apache/camel/builder/ExpressionBuilder.java
+++ b/camel-core/src/main/java/org/apache/camel/builder/ExpressionBuilder.java
@@ -219,7 +219,7 @@
                 Message out = exchange.getOut();
                 Object header = out.getHeader(headerName);
                 if (header == null) {
-                    // lets try the exchange header
+                    // let's try the exchange header
                     header = exchange.getProperty(headerName);
                 }
                 return header;
diff --git a/camel-core/src/main/java/org/apache/camel/builder/xml/Namespaces.java b/camel-core/src/main/java/org/apache/camel/builder/xml/Namespaces.java
index dca3d75..d4651b1 100644
--- a/camel-core/src/main/java/org/apache/camel/builder/xml/Namespaces.java
+++ b/camel-core/src/main/java/org/apache/camel/builder/xml/Namespaces.java
@@ -75,7 +75,7 @@
     }
 
     public Namespaces add(Element element) {
-        // lets set the parent first in case we overload a prefix here
+        // let's set the parent first in case we overload a prefix here
         Node parentNode = element.getParentNode();
         if (parentNode instanceof org.w3c.dom.Element) {
             add((Element) parentNode);
diff --git a/camel-core/src/main/java/org/apache/camel/builder/xml/XPathBuilder.java b/camel-core/src/main/java/org/apache/camel/builder/xml/XPathBuilder.java
index 8f48696..a401196 100644
--- a/camel-core/src/main/java/org/apache/camel/builder/xml/XPathBuilder.java
+++ b/camel-core/src/main/java/org/apache/camel/builder/xml/XPathBuilder.java
@@ -93,7 +93,7 @@
     // For some reason the default expression of "a/b" on a document such as
     // <a><b>1</b><b>2</b></a>
     // will evaluate as just "1" by default which is bizarre. So by default
-    // lets assume XPath expressions result in nodesets.
+    // let's assume XPath expressions result in nodesets.
     private Class<?> resultType;
     private QName resultQName = XPathConstants.NODESET;
     private String objectModelUri;
@@ -697,7 +697,7 @@
     }
 
     /**
-     * Lets populate a number of standard prefixes if they are not already there
+     * Populate a number of standard prefixes if they are not already there
      */
     protected void populateDefaultNamespaces(DefaultNamespaceContext context) {
         setNamespaceIfNotPresent(context, "in", IN_NAMESPACE);
@@ -802,7 +802,7 @@
             answer = body;
         }
 
-        // lets try coerce some common types into something JAXP can deal with
+        // let's try coercing some common types into something JAXP can work with
         if (answer instanceof WrappedFile) {
             // special for files so we can work with them out of the box
             InputStream is = exchange.getContext().getTypeConverter().convertTo(InputStream.class, answer);
diff --git a/camel-core/src/main/java/org/apache/camel/builder/xml/XsltBuilder.java b/camel-core/src/main/java/org/apache/camel/builder/xml/XsltBuilder.java
index e14e0c0..03ef4ec 100644
--- a/camel-core/src/main/java/org/apache/camel/builder/xml/XsltBuilder.java
+++ b/camel-core/src/main/java/org/apache/camel/builder/xml/XsltBuilder.java
@@ -103,7 +103,7 @@
         ResultHandler resultHandler = resultHandlerFactory.createResult(exchange);
         Result result = resultHandler.getResult();
 
-        // lets copy the headers before we invoke the transform in case they modify them
+        // let's copy the headers before we invoke the transform in case they modify them
         Message out = exchange.getOut();
         out.copyFrom(exchange.getIn());
 
diff --git a/camel-core/src/main/java/org/apache/camel/component/bean/BeanInfo.java b/camel-core/src/main/java/org/apache/camel/component/bean/BeanInfo.java
index 81e03a9..fd36d7d 100644
--- a/camel-core/src/main/java/org/apache/camel/component/bean/BeanInfo.java
+++ b/camel-core/src/main/java/org/apache/camel/component/bean/BeanInfo.java
@@ -178,7 +178,7 @@
                 } else if (methods != null) {
                     // there are more methods with that name so we cannot decide which to use
 
-                    // but first lets try to choose a method and see if that comply with the name
+                    // but first let's try to choose a method and see if that complies with the name
                     // must use the method name which may have qualifiers
                     methodInfo = chooseMethod(pojo, exchange, methodName);
 
@@ -353,7 +353,7 @@
                         // use exchange
                         expression = ExpressionBuilder.exchangeExpression();
                     } else {
-                        // lets assume its the body and it must be mandatory convertable to the parameter type
+                        // assume it's the body and it must be mandatory convertible to the parameter type
                         // but we allow null bodies in case the message really contains a null body
                         expression = ExpressionBuilder.mandatoryBodyExpression(parameterType, true);
                     }
@@ -367,7 +367,7 @@
             LOG.trace("Parameter #{} has parameter info: ", i, parameterInfo);
         }
 
-        // now lets add the method to the repository
+        // now let's add the method to the repository
         return new MethodInfo(camelContext, clazz, method, parameters, bodyParameters, hasCustomAnnotation, hasHandlerAnnotation);
     }
 
@@ -400,14 +400,14 @@
     }
 
     /**
-     * Lets try choose one of the available methods to invoke if we can match
+     * Choose one of the available methods to invoke if we can match
      * the message body to the body parameter
      *
      * @param pojo the bean to invoke a method on
      * @param exchange the message exchange
      * @param name an optional name of the method that must match, use <tt>null</tt> to indicate all methods
      * @return the method to invoke or null if no definitive method could be matched
-     * @throws AmbiguousMethodCallException is thrown if cannot chose method due to ambiguous
+     * @throws AmbiguousMethodCallException is thrown if cannot choose method due to ambiguity
      */
     protected MethodInfo chooseMethod(Object pojo, Exchange exchange, String name) throws AmbiguousMethodCallException {
         // @Handler should be select first
@@ -470,7 +470,7 @@
     private MethodInfo chooseMethodWithMatchingBody(Exchange exchange, Collection<MethodInfo> operationList,
                                                     List<MethodInfo> operationsWithCustomAnnotation)
         throws AmbiguousMethodCallException {
-        // lets see if we can find a method who's body param type matches the message body
+        // see if we can find a method whose body param type matches the message body
         Message in = exchange.getIn();
         Object body = in.getBody();
         if (body != null) {
@@ -525,7 +525,7 @@
         } else if (possibles.isEmpty()) {
             LOG.trace("No possible methods so now trying to convert body to parameter types");
 
-            // lets try converting
+            // let's try converting
             Object newBody = null;
             MethodInfo matched = null;
             int matchCounter = 0;
@@ -555,7 +555,7 @@
                 return matched;
             }
         } else {
-            // if we only have a single method with custom annotations, lets use that one
+            // if we only have a single method with custom annotations, let's use that one
             if (possibleWithCustomAnnotation.size() == 1) {
                 MethodInfo answer = possibleWithCustomAnnotation.get(0);
                 LOG.trace("There are only one method with annotations so we choose it: {}", answer);
@@ -621,7 +621,7 @@
 
     private MethodInfo chooseMethodWithCustomAnnotations(Exchange exchange, Collection<MethodInfo> possibles)
         throws AmbiguousMethodCallException {
-        // if we have only one method with custom annotations lets choose that
+        // if we have only one method with custom annotations let's choose that
         MethodInfo chosen = null;
         for (MethodInfo possible : possibles) {
             if (possible.hasCustomAnnotation()) {
diff --git a/camel-core/src/main/java/org/apache/camel/component/bean/BeanProcessor.java b/camel-core/src/main/java/org/apache/camel/component/bean/BeanProcessor.java
index d9e5053..0d0d8df 100644
--- a/camel-core/src/main/java/org/apache/camel/component/bean/BeanProcessor.java
+++ b/camel-core/src/main/java/org/apache/camel/component/bean/BeanProcessor.java
@@ -175,7 +175,7 @@
 
             LOG.trace("Processing exchangeId: {} is continued being processed synchronously", exchange.getExchangeId());
         } catch (InvocationTargetException e) {
-            // lets unwrap the exception when its an invocation target exception
+            // let's unwrap the exception when it's an invocation target exception
             exchange.setException(e.getCause());
             callback.done(true);
             return true;
diff --git a/camel-core/src/main/java/org/apache/camel/component/bean/DefaultAnnotationExpressionFactory.java b/camel-core/src/main/java/org/apache/camel/component/bean/DefaultAnnotationExpressionFactory.java
index 35a5210..e215b4f 100644
--- a/camel-core/src/main/java/org/apache/camel/component/bean/DefaultAnnotationExpressionFactory.java
+++ b/camel-core/src/main/java/org/apache/camel/component/bean/DefaultAnnotationExpressionFactory.java
@@ -46,7 +46,7 @@
     }
 
     protected String getExpressionFromAnnotation(Annotation annotation) {
-        // lets try the 'value()' method
+        // let's try the 'value()' method
         try {
             Method method = annotation.getClass().getMethod("value");
             Object value = ObjectHelper.invokeMethod(method, annotation);
diff --git a/camel-core/src/main/java/org/apache/camel/component/bean/MethodInfo.java b/camel-core/src/main/java/org/apache/camel/component/bean/MethodInfo.java
index cff182d..2d8e3b3 100644
--- a/camel-core/src/main/java/org/apache/camel/component/bean/MethodInfo.java
+++ b/camel-core/src/main/java/org/apache/camel/component/bean/MethodInfo.java
@@ -542,7 +542,7 @@
         if (answer == null) {
             Class<?> type = method.getDeclaringClass();
 
-            // lets create the search order of types to scan
+            // create the search order of types to scan
             List<Class<?>> typesToSearch = new ArrayList<Class<?>>();
             addTypeAndSuperTypes(type, typesToSearch);
             Class<?>[] interfaces = type.getInterfaces();
@@ -550,7 +550,7 @@
                 addTypeAndSuperTypes(anInterface, typesToSearch);
             }
 
-            // now lets scan for a type which the current declared class overloads
+            // now let's scan for a type which the current declared class overloads
             answer = findOneWayAnnotationOnMethod(typesToSearch, method);
             if (answer == null) {
                 answer = findOneWayAnnotation(typesToSearch);
@@ -583,7 +583,7 @@
         int nextDepth = depth - 1;
 
         if (nextDepth > 0) {
-            // lets look at all the annotations to see if any of those are annotated
+            // look at all the annotations to see if any of those are annotated
             Annotation[] annotations = annotatedElement.getAnnotations();
             for (Annotation annotation : annotations) {
                 Class<? extends Annotation> annotationType = annotation.annotationType();
diff --git a/camel-core/src/main/java/org/apache/camel/component/browse/BrowseEndpoint.java b/camel-core/src/main/java/org/apache/camel/component/browse/BrowseEndpoint.java
index b609d04..3a54b2c 100644
--- a/camel-core/src/main/java/org/apache/camel/component/browse/BrowseEndpoint.java
+++ b/camel-core/src/main/java/org/apache/camel/component/browse/BrowseEndpoint.java
@@ -85,7 +85,7 @@
     protected void onExchange(Exchange exchange) throws Exception {
         getExchanges().add(exchange);
 
-        // lets fire any consumers
+        // now fire any consumers
         loadBalancer.process(exchange);
     }
 
diff --git a/camel-core/src/main/java/org/apache/camel/component/dataset/DataSetEndpoint.java b/camel-core/src/main/java/org/apache/camel/component/dataset/DataSetEndpoint.java
index 27995c4..078b404 100644
--- a/camel-core/src/main/java/org/apache/camel/component/dataset/DataSetEndpoint.java
+++ b/camel-core/src/main/java/org/apache/camel/component/dataset/DataSetEndpoint.java
@@ -184,7 +184,7 @@
         long index = receivedCount - 1;
         Exchange expected = createExchange(index);
 
-        // now lets assert that they are the same
+        // now let's assert that they are the same
         if (log.isDebugEnabled()) {
             log.debug("Received message: {} (DataSet index={}) = {}",
                     new Object[]{index, copy.getIn().getHeader(Exchange.DATASET_INDEX, Integer.class), copy});
diff --git a/camel-core/src/main/java/org/apache/camel/component/dataset/DataSetSupport.java b/camel-core/src/main/java/org/apache/camel/component/dataset/DataSetSupport.java
index 9d24c95..14b542b 100644
--- a/camel-core/src/main/java/org/apache/camel/component/dataset/DataSetSupport.java
+++ b/camel-core/src/main/java/org/apache/camel/component/dataset/DataSetSupport.java
@@ -57,7 +57,7 @@
         Object expectedBody = expected.getIn().getBody();
         Object actualBody = actual.getIn().getBody();
         if (expectedBody != null) {
-            // lets coerce to the correct type
+            // let's coerce to the correct type
             actualBody = ExchangeHelper.getMandatoryInBody(actual, expectedBody.getClass());
         }
         DataSetEndpoint.assertEquals("message body", expectedBody, actualBody, actual);
diff --git a/camel-core/src/main/java/org/apache/camel/component/file/GenericFileProducer.java b/camel-core/src/main/java/org/apache/camel/component/file/GenericFileProducer.java
index 320395e..d5921b7 100644
--- a/camel-core/src/main/java/org/apache/camel/component/file/GenericFileProducer.java
+++ b/camel-core/src/main/java/org/apache/camel/component/file/GenericFileProducer.java
@@ -197,7 +197,7 @@
                 writeFile(empty, doneFileName);
             }
 
-            // lets store the name we really used in the header, so end-users
+            // let's store the name we really used in the header, so end-users
             // can retrieve it
             exchange.getIn().setHeader(Exchange.FILE_NAME_PRODUCED, target);
         } catch (Exception e) {
diff --git a/camel-core/src/main/java/org/apache/camel/component/mock/MockEndpoint.java b/camel-core/src/main/java/org/apache/camel/component/mock/MockEndpoint.java
index af45540..e4b7766c 100644
--- a/camel-core/src/main/java/org/apache/camel/component/mock/MockEndpoint.java
+++ b/camel-core/src/main/java/org/apache/camel/component/mock/MockEndpoint.java
@@ -1144,7 +1144,7 @@
         // Wait for a default 10 seconds if resultWaitTime is not set
         long waitTime = timeout == 0 ? 10000L : timeout;
 
-        // now lets wait for the results
+        // now let's wait for the results
         LOG.debug("Waiting on the latch for: " + timeout + " millis");
         latch.await(waitTime, TimeUnit.MILLISECONDS);
     }
diff --git a/camel-core/src/main/java/org/apache/camel/component/ref/RefComponent.java b/camel-core/src/main/java/org/apache/camel/component/ref/RefComponent.java
index 8ae30ce..c0bf0b9 100644
--- a/camel-core/src/main/java/org/apache/camel/component/ref/RefComponent.java
+++ b/camel-core/src/main/java/org/apache/camel/component/ref/RefComponent.java
@@ -30,7 +30,7 @@
 public class RefComponent extends DefaultComponent {
 
     protected Endpoint createEndpoint(String uri, String remaining, Map<String, Object> parameters) throws Exception {
-        // lets remove the scheme from the URI
+        // first remove the scheme from the URI
         int index = uri.indexOf(':');
         String name = uri;
         if (index >= 0) {
diff --git a/camel-core/src/main/java/org/apache/camel/impl/DefaultCamelContext.java b/camel-core/src/main/java/org/apache/camel/impl/DefaultCamelContext.java
index 87180bb..cabb072 100644
--- a/camel-core/src/main/java/org/apache/camel/impl/DefaultCamelContext.java
+++ b/camel-core/src/main/java/org/apache/camel/impl/DefaultCamelContext.java
@@ -1994,7 +1994,7 @@
     }
 
     /**
-     * Lets force some lazy initialization to occur upfront before we start any
+     * Force some lazy initialization to occur upfront before we start any
      * components and create routes
      */
     protected void forceLazyInitialization() {
@@ -2005,7 +2005,7 @@
     }
 
     /**
-     * Lets force clear lazy initialization so they can be re-created on restart
+     * Force clear lazy initialization so they can be re-created on restart
      */
     protected void forceStopLazyInitialization() {
         injector = null;
diff --git a/camel-core/src/main/java/org/apache/camel/impl/MessageSupport.java b/camel-core/src/main/java/org/apache/camel/impl/MessageSupport.java
index 61392d4..14ea7b6 100644
--- a/camel-core/src/main/java/org/apache/camel/impl/MessageSupport.java
+++ b/camel-core/src/main/java/org/apache/camel/impl/MessageSupport.java
@@ -185,7 +185,7 @@
     }
 
     /**
-     * Lets allow implementations to auto-create a messageId
+     * Allow implementations to auto-create a messageId
      */
     protected String createMessageId() {
         String uuid = null;
diff --git a/camel-core/src/main/java/org/apache/camel/spi/RouteContext.java b/camel-core/src/main/java/org/apache/camel/spi/RouteContext.java
index 9effb00..b4f44c6 100644
--- a/camel-core/src/main/java/org/apache/camel/spi/RouteContext.java
+++ b/camel-core/src/main/java/org/apache/camel/spi/RouteContext.java
@@ -97,7 +97,7 @@
     <T> Map<String, T> lookupByType(Class<T> type);
 
     /**
-     * Lets complete the route creation, creating a single event driven route
+     * For completing the route creation, creating a single event driven route
      * for the current from endpoint with any processors required
      */
     void commit();
diff --git a/camel-core/src/main/java/org/apache/camel/view/NodeData.java b/camel-core/src/main/java/org/apache/camel/view/NodeData.java
index 8f8a093..ba29f66 100644
--- a/camel-core/src/main/java/org/apache/camel/view/NodeData.java
+++ b/camel-core/src/main/java/org/apache/camel/view/NodeData.java
@@ -171,7 +171,7 @@
     }
 
     /**
-     * Lets insert a space before each upper case letter after a lowercase
+     * Inserts a space before each upper case letter after a lowercase
      */
     public static String insertSpacesBetweenCamelCase(String name) {
         boolean lastCharacterLowerCase = false;
diff --git a/components/camel-amqp/src/main/java/org/apache/camel/component/amqp/AMQPComponent.java b/components/camel-amqp/src/main/java/org/apache/camel/component/amqp/AMQPComponent.java
index 4c8d38e..ec0cdd7 100644
--- a/components/camel-amqp/src/main/java/org/apache/camel/component/amqp/AMQPComponent.java
+++ b/components/camel-amqp/src/main/java/org/apache/camel/component/amqp/AMQPComponent.java
@@ -24,6 +24,8 @@
 import org.apache.qpid.url.URLSyntaxException;
 
 /**
+ * This component supports the AMQP protocol using the Client API of the Apache Qpid project.
+ * 
  * @version 
  */
 public class AMQPComponent extends JmsComponent {
@@ -52,7 +54,7 @@
     }
 
     /**
-     * Lets install the default connection factory
+     * Let's install the default connection factory
      */
     private void init() {
         AMQConnectionFactory connectionFactory = new AMQConnectionFactory();
diff --git a/components/camel-amqp/src/test/java/org/apache/camel/component/amqp/AMQPRouteTest.java b/components/camel-amqp/src/test/java/org/apache/camel/component/amqp/AMQPRouteTest.java
index 5feec67..ba5bf6b 100644
--- a/components/camel-amqp/src/test/java/org/apache/camel/component/amqp/AMQPRouteTest.java
+++ b/components/camel-amqp/src/test/java/org/apache/camel/component/amqp/AMQPRouteTest.java
@@ -39,7 +39,7 @@
     
     @BeforeClass
     public static void startBroker() throws Exception {
-        // lets create an in JVM broker
+        // create an in-JVM broker
         try {
             TransportConnection.createVMBroker(1);
         } catch (Exception e) {
diff --git a/components/camel-bam/src/main/java/org/apache/camel/bam/ProcessBuilder.java b/components/camel-bam/src/main/java/org/apache/camel/bam/ProcessBuilder.java
index ea56b71..8d8ec0f 100644
--- a/components/camel-bam/src/main/java/org/apache/camel/bam/ProcessBuilder.java
+++ b/components/camel-bam/src/main/java/org/apache/camel/bam/ProcessBuilder.java
@@ -152,7 +152,7 @@
         ObjectHelper.notNull(getJpaTemplate(), "jpaTemplate", this);
         ObjectHelper.notNull(getTransactionTemplate(), "transactionTemplate", this);
 
-        // lets add the monitoring service - should there be an easier way??
+        // add the monitoring service - should there be an easier way??
         if (engine == null) {
             engine = new ActivityMonitorEngine(getJpaTemplate(), getTransactionTemplate(), getProcessRules());
         }
@@ -162,7 +162,7 @@
             defaultCamelContext.addService(engine);
         }
 
-        // lets create the routes for the activites
+        // create the routes for the activities
         for (ActivityBuilder builder : activityBuilders) {
             from(builder.getEndpoint()).process(builder.getProcessor());
         }
diff --git a/components/camel-bam/src/main/java/org/apache/camel/bam/processor/ActivityMonitorEngine.java b/components/camel-bam/src/main/java/org/apache/camel/bam/processor/ActivityMonitorEngine.java
index ed42414..fafac9f 100644
--- a/components/camel-bam/src/main/java/org/apache/camel/bam/processor/ActivityMonitorEngine.java
+++ b/components/camel-bam/src/main/java/org/apache/camel/bam/processor/ActivityMonitorEngine.java
@@ -109,7 +109,7 @@
 
         template.execute(new JpaCallback() {
             public Object doInJpa(EntityManager entityManager) throws PersistenceException {
-                // lets try lock the object first
+                // let's try locking the object first
                 if (isUseLocking()) {
                     LOG.info("Attempting to lock: " + activityState);
                     entityManager.lock(activityState, LockModeType.WRITE);
diff --git a/components/camel-bam/src/main/java/org/apache/camel/bam/processor/JpaBamProcessor.java b/components/camel-bam/src/main/java/org/apache/camel/bam/processor/JpaBamProcessor.java
index ff3f519..b5f3a23 100644
--- a/components/camel-bam/src/main/java/org/apache/camel/bam/processor/JpaBamProcessor.java
+++ b/components/camel-bam/src/main/java/org/apache/camel/bam/processor/JpaBamProcessor.java
@@ -49,7 +49,7 @@
     protected void processEntity(Exchange exchange, ProcessInstance process) throws Exception {
         LOG.debug("Processing process instance: {}", process);
 
-        // lets force the lazy creation of this activity
+        // force the lazy creation of this activity
         ActivityRules rules = getActivityRules();
         ActivityState state = process.getOrCreateActivityState(rules);
 
diff --git a/components/camel-bam/src/main/java/org/apache/camel/bam/rules/ActivityRules.java b/components/camel-bam/src/main/java/org/apache/camel/bam/rules/ActivityRules.java
index 1530031..d6c1a46 100644
--- a/components/camel-bam/src/main/java/org/apache/camel/bam/rules/ActivityRules.java
+++ b/components/camel-bam/src/main/java/org/apache/camel/bam/rules/ActivityRules.java
@@ -68,7 +68,7 @@
     //-------------------------------------------------------------------------
 
     public ActivityDefinition getActivityDefinition() {
-        // lets always query for it, to avoid issues with refreshing before a commit etc
+        // let's always query for it, to avoid issues with refreshing before a commit etc
         return builder.findOrCreateActivityDefinition(activityName);
     }
 
diff --git a/components/camel-bam/src/main/java/org/apache/camel/bam/rules/TemporalRule.java b/components/camel-bam/src/main/java/org/apache/camel/bam/rules/TemporalRule.java
index 4c058d7..0e182bb 100644
--- a/components/camel-bam/src/main/java/org/apache/camel/bam/rules/TemporalRule.java
+++ b/components/camel-bam/src/main/java/org/apache/camel/bam/rules/TemporalRule.java
@@ -104,7 +104,7 @@
         // TODO now we might need to set the second activity state
         // to 'grey' to indicate it now could happen?
 
-        // lets force the lazy creation of the second state
+        // let's force the lazy creation of the second state
         ActivityState secondState = second.getOrCreateActivityState(instance);
         if (expectedMillis > 0L) {
             Date expected = secondState.getTimeExpected();
diff --git a/components/camel-bam/src/test/java/org/apache/camel/bam/BamRouteTest.java b/components/camel-bam/src/test/java/org/apache/camel/bam/BamRouteTest.java
index 0153ebc..6d54d91 100644
--- a/components/camel-bam/src/test/java/org/apache/camel/bam/BamRouteTest.java
+++ b/components/camel-bam/src/test/java/org/apache/camel/bam/BamRouteTest.java
@@ -73,14 +73,14 @@
         return new ProcessBuilder(jpaTemplate, transactionTemplate) {
             public void configure() throws Exception {
 
-                // lets define some activities, correlating on an XPath on the message bodies
+                // let's define some activities, correlating on an XPath on the message bodies
                 ActivityBuilder a = activity("seda:a").name("a")
                         .correlate(xpath("/hello/@id"));
 
                 ActivityBuilder b = activity("seda:b").name("b")
                         .correlate(xpath("/hello/@id"));
 
-                // now lets add some rules
+                // now let's add some rules
                 b.starts().after(a.completes())
                         .expectWithin(seconds(1))
                         .errorIfOver(seconds(errorTimeout)).to("mock:overdue");
diff --git a/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/BlueprintComponentResolver.java b/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/BlueprintComponentResolver.java
index fb6a59f..9e4a474 100644
--- a/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/BlueprintComponentResolver.java
+++ b/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/BlueprintComponentResolver.java
@@ -41,7 +41,7 @@
                 LOG.debug("Found component: {} in registry: {}", name, bean);
                 return (Component) bean;
             } else {
-                // lets use Camel's type conversion mechanism to convert things like CamelContext
+                // let's use Camel's type conversion mechanism to convert things like CamelContext
                 // and other types into a valid Component
                 Component component = CamelContextHelper.convertTo(context, Component.class, bean);
                 if (component != null) {
diff --git a/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/PackageScanRouteBuilderFinder.java b/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/PackageScanRouteBuilderFinder.java
index 509747d..cea6f59 100644
--- a/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/PackageScanRouteBuilderFinder.java
+++ b/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/PackageScanRouteBuilderFinder.java
@@ -82,7 +82,7 @@
     }
 
     /**
-     * Lets ignore beans that are explicitly configured in the Spring XML files
+     * Allows for ignoring beans that are explicitly configured in the Spring XML files
      */
     protected boolean shouldIgnoreBean(Class<?> type) {
         for (Object metadataObject : blueprintContainer.getMetadata(BeanMetadata.class)) {
diff --git a/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/handler/CamelNamespaceHandler.java b/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/handler/CamelNamespaceHandler.java
index 3e855be..843a289 100644
--- a/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/handler/CamelNamespaceHandler.java
+++ b/components/camel-blueprint/src/main/java/org/apache/camel/blueprint/handler/CamelNamespaceHandler.java
@@ -155,7 +155,7 @@
         String contextId = element.getAttribute("id");
         boolean implicitId = false;
 
-        // lets avoid folks having to explicitly give an ID to a camel context
+        // let's avoid folks having to explicitly give an ID to a camel context
         if (ObjectHelper.isEmpty(contextId)) {
             // if no explicit id was set then use a default auto generated name
             CamelContextNameStrategy strategy = new DefaultCamelContextNameStrategy();
@@ -164,7 +164,7 @@
             implicitId = true;
         }
 
-        // now lets parse the routes with JAXB
+        // now let's parse the routes with JAXB
         Binder<Node> binder;
         try {
             binder = getJaxbContext().createBinder();
@@ -237,7 +237,7 @@
     }
 
     private Metadata parseRouteContextNode(Element element, ParserContext context) {
-        // now lets parse the routes with JAXB
+        // now parse the routes with JAXB
         Binder<Node> binder;
         try {
             binder = getJaxbContext().createBinder();
@@ -271,7 +271,7 @@
     }
 
     private Metadata parseKeyStoreParametersNode(Element element, ParserContext context) {
-        // now lets parse the key store parameters with JAXB
+        // now parse the key store parameters with JAXB
         Binder<Node> binder;
         try {
             binder = getJaxbContext().createBinder();
@@ -305,7 +305,7 @@
     }
 
     private Metadata parseSecureRandomParametersNode(Element element, ParserContext context) {
-        // now lets parse the key store parameters with JAXB
+        // now parse the key store parameters with JAXB
         Binder<Node> binder;
         try {
             binder = getJaxbContext().createBinder();
@@ -339,7 +339,7 @@
     }
 
     private Metadata parseSSLContextParametersNode(Element element, ParserContext context) {
-        // now lets parse the key store parameters with JAXB
+        // now parse the key store parameters with JAXB
         Binder<Node> binder;
         try {
             binder = getJaxbContext().createBinder();
diff --git a/components/camel-context/src/main/java/org/apache/camel/component/context/LocalContextComponent.java b/components/camel-context/src/main/java/org/apache/camel/component/context/LocalContextComponent.java
index 38a1514..b915cc5 100644
--- a/components/camel-context/src/main/java/org/apache/camel/component/context/LocalContextComponent.java
+++ b/components/camel-context/src/main/java/org/apache/camel/component/context/LocalContextComponent.java
@@ -65,7 +65,7 @@
     protected Endpoint createEndpoint(String uri, String remaining, Map<String, Object> parameters)
         throws Exception {
 
-        // lets first check if we are using a fully qualified name: [context:]contextId:endpointUri
+        // first check if we are using a fully qualified name: [context:]contextId:endpointUri
         Map<String, Endpoint> map = getLocalCamelContext().getEndpointMap();
 
         if (LOG.isTraceEnabled()) {
@@ -77,7 +77,7 @@
             return endpoint;
         }
 
-        // lets look to see if there is an endpoint of name 'remaining' using one of the local endpoints within
+        // look to see if there is an endpoint of name 'remaining' using one of the local endpoints within
         // the black box CamelContext
         String[] separators = {":", "://"};
         for (String scheme : localProtocolSchemes) {
diff --git a/components/camel-context/src/test/java/org/apache/camel/component/context/JavaDslBlackBoxTest.java b/components/camel-context/src/test/java/org/apache/camel/component/context/JavaDslBlackBoxTest.java
index 4850aa7..d5949f3 100644
--- a/components/camel-context/src/test/java/org/apache/camel/component/context/JavaDslBlackBoxTest.java
+++ b/components/camel-context/src/test/java/org/apache/camel/component/context/JavaDslBlackBoxTest.java
@@ -27,7 +27,7 @@
 import org.junit.Test;
 
 /**
- * Lets use the Java DSL to create a black box CamelContext and then test its use from another context
+ * Allows for use of the Java DSL to create a black box CamelContext and then test its use from another context
  */
 public class JavaDslBlackBoxTest extends CamelTestSupport {
 
@@ -52,13 +52,13 @@
     protected JndiRegistry createRegistry() throws Exception {
         JndiRegistry registry = super.createRegistry();
 
-        // lets create our black box as a camel context and a set of routes
+        // let's create our black box as a Camel context and a set of routes
         DefaultCamelContext blackBox = new DefaultCamelContext(registry);
         blackBox.setName("blackBox");
         blackBox.addRoutes(new RouteBuilder() {
             @Override
             public void configure() throws Exception {
-                // receive purchase orders, lets process it in some way then
+                // we received purchase orders, so let's process it in some way then
                 // send an invoice to our invoice endpoint
                 from("direct:purchaseOrder").setHeader("received").constant("true").to("direct:invoice");
             }
diff --git a/components/camel-context/src/test/java/org/apache/camel/component/context/JavaDslBlackBoxWithVerboseUriTest.java b/components/camel-context/src/test/java/org/apache/camel/component/context/JavaDslBlackBoxWithVerboseUriTest.java
index feb6c76..ee0fac0 100644
--- a/components/camel-context/src/test/java/org/apache/camel/component/context/JavaDslBlackBoxWithVerboseUriTest.java
+++ b/components/camel-context/src/test/java/org/apache/camel/component/context/JavaDslBlackBoxWithVerboseUriTest.java
@@ -19,7 +19,7 @@
 import org.apache.camel.builder.RouteBuilder;
 
 /**
- * Lets use the verbose context:camelContextId:actualEndpointName when referring to endpoints
+ * Tests use of the verbose context:camelContextId:actualEndpointName when referring to endpoints
  */
 public class JavaDslBlackBoxWithVerboseUriTest extends JavaDslBlackBoxTest {
 
diff --git a/components/camel-core-xml/src/main/java/org/apache/camel/core/xml/AbstractCamelContextFactoryBean.java b/components/camel-core-xml/src/main/java/org/apache/camel/core/xml/AbstractCamelContextFactoryBean.java
index ed19d08..63b1236 100644
--- a/components/camel-core-xml/src/main/java/org/apache/camel/core/xml/AbstractCamelContextFactoryBean.java
+++ b/components/camel-core-xml/src/main/java/org/apache/camel/core/xml/AbstractCamelContextFactoryBean.java
@@ -110,7 +110,7 @@
     private ClassLoader contextClassLoaderOnStart;
 
     public AbstractCamelContextFactoryBean() {
-        // Lets keep track of the class loader for when we actually do start things up
+        // Keep track of the class loader for when we actually do start things up
         contextClassLoaderOnStart = Thread.currentThread().getContextClassLoader();
     }
 
diff --git a/components/camel-guice/src/test/java/org/apache/camel/guice/ComponentFoundInRegistryTest.java b/components/camel-guice/src/test/java/org/apache/camel/guice/ComponentFoundInRegistryTest.java
index 17cc67e..04cb2aa 100644
--- a/components/camel-guice/src/test/java/org/apache/camel/guice/ComponentFoundInRegistryTest.java
+++ b/components/camel-guice/src/test/java/org/apache/camel/guice/ComponentFoundInRegistryTest.java
@@ -37,7 +37,7 @@
 import static org.hamcrest.Matchers.is;
 
 /**
- * Lets use a custom CamelModule to perform explicit binding of route builders
+ * Uses a custom CamelModule to perform explicit binding of route builders
  *
  * @version 
  */
diff --git a/components/camel-guice/src/test/java/org/apache/camel/guice/ConciseGuiceRouteTest.java b/components/camel-guice/src/test/java/org/apache/camel/guice/ConciseGuiceRouteTest.java
index 9991f3f..4619bdc 100644
--- a/components/camel-guice/src/test/java/org/apache/camel/guice/ConciseGuiceRouteTest.java
+++ b/components/camel-guice/src/test/java/org/apache/camel/guice/ConciseGuiceRouteTest.java
@@ -21,7 +21,7 @@
 import org.junit.Assert;
 import org.junit.Test;
 /**
- * Lets use a RouteBuilder to bind instances of routes to the CamelContext
+ * Uses a RouteBuilder to bind instances of routes to the CamelContext
  *
  * @version 
  */
diff --git a/examples/camel-example-guice-jms/src/main/java/org/apache/camel/example/guice/jms/MyModule.java b/examples/camel-example-guice-jms/src/main/java/org/apache/camel/example/guice/jms/MyModule.java
index 4f09400..0d4ccfc 100644
--- a/examples/camel-example-guice-jms/src/main/java/org/apache/camel/example/guice/jms/MyModule.java
+++ b/examples/camel-example-guice-jms/src/main/java/org/apache/camel/example/guice/jms/MyModule.java
@@ -36,13 +36,13 @@
     protected void configure() {
         super.configure();
 
-        // lets add in any RouteBuilder instances we want to use
+        // let's add in any RouteBuilder instances we want to use
         bind(MyRouteBuilder.class);
         bind(Printer.class);
     }
 
     /**
-     * Lets configure the JMS component, parameterizing some properties from the
+     * Let's configure the JMS component, parameterizing some properties from the
      * jndi.properties file
      */
     @Provides
diff --git a/tooling/archetypes/camel-archetype-component/src/main/resources/archetype-resources/ReadMe.txt b/tooling/archetypes/camel-archetype-component/src/main/resources/archetype-resources/ReadMe.txt
index 3cc57d1..16825ee 100644
--- a/tooling/archetypes/camel-archetype-component/src/main/resources/archetype-resources/ReadMe.txt
+++ b/tooling/archetypes/camel-archetype-component/src/main/resources/archetype-resources/ReadMe.txt
@@ -1,11 +1,12 @@
 Camel Component Project
 ====================
-This Project is a template of the Camel component.
-When you create the component project, you need to move the META-INF/services/org/apache/camel/component/${name}
-file to META-INF/services/org/apache/camel/component/foo where "foo" is the URI scheme for your component and any
- related endpoints created on the fly.
+This Project is a template of a Camel component.
 
-For more help see the Apache Camel documentation
+When you create a component project, you need to move the META-INF/services/org/apache/camel/component/${name}
+file to META-INF/services/org/apache/camel/component/foo where "foo" is the URI scheme for your component and any
+related endpoints created on the fly.
+
+For more help see the Apache Camel documentation:
 
     http://camel.apache.org/writing-components.html
     
diff --git a/tooling/archetypes/camel-archetype-java/src/main/resources/archetype-resources/src/main/java/MyRouteBuilder.java b/tooling/archetypes/camel-archetype-java/src/main/resources/archetype-resources/src/main/java/MyRouteBuilder.java
index f3a9c9f..3af5df9 100644
--- a/tooling/archetypes/camel-archetype-java/src/main/resources/archetype-resources/src/main/java/MyRouteBuilder.java
+++ b/tooling/archetypes/camel-archetype-java/src/main/resources/archetype-resources/src/main/java/MyRouteBuilder.java
@@ -34,7 +34,7 @@
     }
 
     /**
-     * Lets configure the Camel routing rules using Java code...
+     * Let's configure the Camel routing rules using Java code...
      */
     public void configure() {