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

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

commit 4eb611282b53c64f91a3fa22c682c2f5d011ef28
Author: Peter Palaga <[email protected]>
AuthorDate: Mon Apr 27 13:01:25 2020 +0200

    CAMEL-14934: (Batch 5) Improve Component and Language descriptions
---
 .../main/java/org/apache/camel/component/direct/DirectEndpoint.java | 2 +-
 .../java/org/apache/camel/component/directvm/DirectVmEndpoint.java  | 2 +-
 .../main/java/org/apache/camel/model/dataformat/AvroDataFormat.java | 2 +-
 .../src/main/java/org/apache/camel/model/dataformat/BindyType.java  | 2 +-
 .../org/apache/camel/model/dataformat/DataFormatsDefinition.java    | 2 +-
 .../java/org/apache/camel/model/dataformat/FhirJsonDataFormat.java  | 2 +-
 .../java/org/apache/camel/model/dataformat/FhirXmlDataFormat.java   | 2 +-
 .../java/org/apache/camel/model/dataformat/FlatpackDataFormat.java  | 3 ++-
 .../main/java/org/apache/camel/model/dataformat/GzipDataFormat.java | 2 +-
 .../java/org/apache/camel/model/dataformat/JsonApiDataFormat.java   | 3 ++-
 .../main/java/org/apache/camel/model/dataformat/JsonLibrary.java    | 2 +-
 .../main/java/org/apache/camel/model/dataformat/LZFDataFormat.java  | 2 +-
 .../java/org/apache/camel/model/dataformat/TarFileDataFormat.java   | 2 +-
 .../java/org/apache/camel/model/dataformat/ThriftDataFormat.java    | 2 +-
 .../org/apache/camel/model/dataformat/UniVocityCsvDataFormat.java   | 2 +-
 .../camel/model/dataformat/UniVocityFixedWidthDataFormat.java       | 2 +-
 .../org/apache/camel/model/dataformat/UniVocityTsvDataFormat.java   | 2 +-
 .../java/org/apache/camel/model/dataformat/XStreamDataFormat.java   | 2 +-
 .../java/org/apache/camel/model/dataformat/XmlRpcDataFormat.java    | 2 +-
 .../main/java/org/apache/camel/model/dataformat/YAMLLibrary.java    | 2 +-
 .../org/apache/camel/model/dataformat/ZipDeflaterDataFormat.java    | 2 +-
 .../java/org/apache/camel/model/language/ConstantExpression.java    | 6 +-----
 .../org/apache/camel/model/language/ExchangePropertyExpression.java | 2 +-
 .../main/java/org/apache/camel/model/language/GroovyExpression.java | 2 +-
 .../main/java/org/apache/camel/model/language/HeaderExpression.java | 2 +-
 .../java/org/apache/camel/model/language/Hl7TerserExpression.java   | 2 +-
 .../java/org/apache/camel/model/language/JsonPathExpression.java    | 2 +-
 .../java/org/apache/camel/model/language/LanguageExpression.java    | 2 +-
 .../java/org/apache/camel/model/language/MethodCallExpression.java  | 2 +-
 .../main/java/org/apache/camel/model/language/MvelExpression.java   | 2 +-
 .../main/java/org/apache/camel/model/language/OgnlExpression.java   | 2 +-
 .../main/java/org/apache/camel/model/language/RefExpression.java    | 3 +--
 .../main/java/org/apache/camel/model/language/SimpleExpression.java | 2 +-
 .../main/java/org/apache/camel/model/language/SpELExpression.java   | 2 +-
 .../java/org/apache/camel/model/language/TokenizerExpression.java   | 3 +--
 .../org/apache/camel/model/language/XMLTokenizerExpression.java     | 3 +--
 .../main/java/org/apache/camel/model/language/XPathExpression.java  | 2 +-
 .../main/java/org/apache/camel/model/language/XQueryExpression.java | 2 +-
 38 files changed, 40 insertions(+), 45 deletions(-)

diff --git 
a/components/camel-direct/src/main/java/org/apache/camel/component/direct/DirectEndpoint.java
 
b/components/camel-direct/src/main/java/org/apache/camel/component/direct/DirectEndpoint.java
index 1115ad5..03bbeff 100644
--- 
a/components/camel-direct/src/main/java/org/apache/camel/component/direct/DirectEndpoint.java
+++ 
b/components/camel-direct/src/main/java/org/apache/camel/component/direct/DirectEndpoint.java
@@ -32,7 +32,7 @@ import org.apache.camel.util.StopWatch;
 import org.apache.camel.util.StringHelper;
 
 /**
- * Provides a direct, synchronous call to another endpoint from the same 
CamelContext.
+ * Call another endpoint from the same Camel Context synchronously.
  *
  * This endpoint can be used to connect existing routes in the same 
CamelContext.
  */
diff --git 
a/components/camel-directvm/src/main/java/org/apache/camel/component/directvm/DirectVmEndpoint.java
 
b/components/camel-directvm/src/main/java/org/apache/camel/component/directvm/DirectVmEndpoint.java
index 72d4f09..a202b38 100644
--- 
a/components/camel-directvm/src/main/java/org/apache/camel/component/directvm/DirectVmEndpoint.java
+++ 
b/components/camel-directvm/src/main/java/org/apache/camel/component/directvm/DirectVmEndpoint.java
@@ -28,7 +28,7 @@ import org.apache.camel.spi.UriPath;
 import org.apache.camel.support.DefaultEndpoint;
 
 /**
- * Provides direct, synchronous call to another endpoint from any CamelContext 
in the same JVM.
+ * Call another endpoint from any Camel Context in the same JVM synchronously.
  *
  * This endpoint can be used to connect existing routes in the same JVM 
between different CamelContexts.
  */
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/AvroDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/AvroDataFormat.java
index d1db945..0046d9e 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/AvroDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/AvroDataFormat.java
@@ -26,7 +26,7 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Serialize and deserialize messages using Apache Avro binary dataformat.
+ * Serialize and deserialize messages using Apache Avro binary data format.
  */
 @Metadata(firstVersion = "2.14.0", label = "dataformat,transformation", title 
= "Avro")
 @XmlRootElement(name = "avro")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/BindyType.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/BindyType.java
index 892cdfe..d969fa9 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/BindyType.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/BindyType.java
@@ -20,7 +20,7 @@ import javax.xml.bind.annotation.XmlEnum;
 import javax.xml.bind.annotation.XmlType;
 
 /**
- * Represents the different types of bindy data formats.
+ * Represents the different types of Bindy data formats.
  */
 @XmlType
 @XmlEnum
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/DataFormatsDefinition.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/DataFormatsDefinition.java
index d3c1485..a961f09 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/DataFormatsDefinition.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/DataFormatsDefinition.java
@@ -30,7 +30,7 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To configure data formats
+ * Configure data formats.
  */
 @Metadata(label = "dataformat,transformation", title = "Data formats")
 @XmlRootElement(name = "dataFormats")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FhirJsonDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FhirJsonDataFormat.java
index 7a9f29e..08e6d9d 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FhirJsonDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FhirJsonDataFormat.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Marshall/unmarshall FHIR objects to/from JSON.
+ * Marshall and unmarshall FHIR objects to/from JSON.
  */
 @Metadata(firstVersion = "2.21.0", label = 
"dataformat,transformation,hl7,json", title = "FHIR JSon")
 @XmlRootElement(name = "fhirJson")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FhirXmlDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FhirXmlDataFormat.java
index fac5d38..f1cad18 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FhirXmlDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FhirXmlDataFormat.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Marshall/unmarshall FHIR objects to/from XML.
+ * Marshall and unmarshall FHIR objects to/from XML.
  */
 @Metadata(firstVersion = "2.21.0", label = 
"dataformat,transformation,hl7,xml", title = "FHIR XML")
 @XmlRootElement(name = "fhirXml")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FlatpackDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FlatpackDataFormat.java
index f348a6f..f05f90a 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FlatpackDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/FlatpackDataFormat.java
@@ -25,7 +25,8 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Marshal and unmarshal Java lists and maps to/from flat files (such as CSV, 
delimited, or fixed length formats).
+ * Marshal and unmarshal Java lists and maps to/from flat files (such as CSV, 
delimited, or fixed length formats) using
+ * <a href="https://github.com/appendium/flatpack";>Flatpack</a> library.
  */
 @Metadata(firstVersion = "2.1.0", label = "dataformat,transformation,csv", 
title = "Flatpack")
 @XmlRootElement(name = "flatpack")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/GzipDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/GzipDataFormat.java
index f6832fc..b5a5283 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/GzipDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/GzipDataFormat.java
@@ -22,7 +22,7 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Compress and de-compress messages using java.util.zip.GZIP*Stream.
+ * Compress and decompress messages using 
<code>java.util.zip.GZIP*Stream</code>.
  */
 @Metadata(firstVersion = "2.0.0", label = "dataformat,transformation", title = 
"GZip Deflater")
 @XmlRootElement(name = "gzipdeflater")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/JsonApiDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/JsonApiDataFormat.java
index f3d85a7..b73b5b7 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/JsonApiDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/JsonApiDataFormat.java
@@ -25,7 +25,8 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Marshal and unmarshal JSON:API resources.
+ * Marshal and unmarshal <a href="http://jsonapi.org/format/";>JSON:API 
resources</a> using
+ * <a href="https://github.com/jasminb/jsonapi-converter";>JSONAPI-Converter 
library</a>.
  */
 @Metadata(firstVersion = "3.0.0", label = "dataformat,transformation", title = 
"JSonApi")
 @XmlRootElement(name = "jsonApi")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/JsonLibrary.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/JsonLibrary.java
index 116004c..379a401 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/JsonLibrary.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/JsonLibrary.java
@@ -20,7 +20,7 @@ import javax.xml.bind.annotation.XmlEnum;
 import javax.xml.bind.annotation.XmlType;
 
 /**
- * Represents the concrete Json libraries Camel supports.
+ * Supported JSON marshalers.
  */
 @XmlType
 @XmlEnum
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/LZFDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/LZFDataFormat.java
index bfcd350..db9ac12 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/LZFDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/LZFDataFormat.java
@@ -25,7 +25,7 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Compression and de-compress streams using LZF deflate algorithm.
+ * Compress and decompress streams using LZF deflate algorithm.
  */
 @Metadata(firstVersion = "2.17.0", label = "dataformat,transformation", title 
= "LZF Deflate Compression")
 @XmlRootElement(name = "lzf")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/TarFileDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/TarFileDataFormat.java
index 27ed4d0..127547d 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/TarFileDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/TarFileDataFormat.java
@@ -25,7 +25,7 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Archive/extract files into/from tarballs.
+ * Archive files into tarballs or extract files from tarballs.
  */
 @Metadata(firstVersion = "2.16.0", label = "dataformat,transformation,file", 
title = "Tar File")
 @XmlRootElement(name = "tarfile")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/ThriftDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/ThriftDataFormat.java
index e9206e8..542e4fc 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/ThriftDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/ThriftDataFormat.java
@@ -26,7 +26,7 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Serialize and deserialize of messages using Apache Thrift binary dataformat.
+ * Serialize and deserialize messages using Apache Thrift binary data format.
  */
 @Metadata(firstVersion = "2.20.0", label = "dataformat,transformation", title 
= "Thrift")
 @XmlRootElement(name = "thrift")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityCsvDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityCsvDataFormat.java
index 1b160f7..15e4111 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityCsvDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityCsvDataFormat.java
@@ -24,7 +24,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Marshal and unmarshal Java objects from and to CSV (Comma Separated Values) 
using univocity-parsers.
+ * Marshal and unmarshal Java objects from and to CSV (Comma Separated Values) 
using UniVocity Parsers.
  */
 @Metadata(firstVersion = "2.15.0", label = "dataformat,transformation,csv", 
title = "uniVocity CSV")
 @XmlRootElement(name = "univocity-csv")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityFixedWidthDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityFixedWidthDataFormat.java
index b6b01fd..550dd08 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityFixedWidthDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityFixedWidthDataFormat.java
@@ -24,7 +24,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Marshal and unmarshal Java objects from and to fixed length records using 
univocity-parsers.
+ * Marshal and unmarshal Java objects from and to fixed length records using 
UniVocity Parsers.
  */
 @Metadata(firstVersion = "2.15.0", label = "dataformat,transformation,csv", 
title = "uniVocity Fixed Length")
 @XmlRootElement(name = "univocity-fixed")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityTsvDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityTsvDataFormat.java
index 907ba6f..0bac6c0 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityTsvDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/UniVocityTsvDataFormat.java
@@ -24,7 +24,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Marshal and unmarshal Java objects from and to TSV (Tab-Separated Values) 
records using univocity-parsers.
+ * Marshal and unmarshal Java objects from and to TSV (Tab-Separated Values) 
records using UniVocity Parsers.
  */
 @Metadata(firstVersion = "2.15.0", label = "dataformat,transformation,csv", 
title = "uniVocity TSV")
 @XmlRootElement(name = "univocity-tsv")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/XStreamDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/XStreamDataFormat.java
index c0fc060..e3026fe 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/XStreamDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/XStreamDataFormat.java
@@ -33,7 +33,7 @@ import org.apache.camel.spi.Metadata;
 import org.apache.camel.util.CollectionStringBuffer;
 
 /**
- * Marshal and unmarshal POJOs to/from XML.
+ * Marshal and unmarshal POJOs to/from XML using <a 
href="https://x-stream.github.io/";>XStream</a> library.
  */
 @Metadata(firstVersion = "1.3.0", label = 
"dataformat,transformation,xml,json", title = "XStream")
 @XmlRootElement(name = "xstream")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/XmlRpcDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/XmlRpcDataFormat.java
index a4a4bdd..7823b91 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/XmlRpcDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/XmlRpcDataFormat.java
@@ -25,7 +25,7 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * The XML RPC data format is used for working with the XML RPC protocol.
+ * Marshal and unmarshal XML RPC protocol requests or responses.
  */
 @Metadata(firstVersion = "2.11.0", label = "dataformat,transformation,xml", 
title = "XML RPC")
 @XmlRootElement(name = "xmlrpc")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/YAMLLibrary.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/YAMLLibrary.java
index 0c0d771..ea5154b 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/YAMLLibrary.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/YAMLLibrary.java
@@ -20,7 +20,7 @@ import javax.xml.bind.annotation.XmlEnum;
 import javax.xml.bind.annotation.XmlType;
 
 /**
- * Represents the concrete Yaml libraries Camel supports.
+ * Supported YAML marshalers.
  */
 @XmlType
 @XmlEnum
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/ZipDeflaterDataFormat.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/ZipDeflaterDataFormat.java
index bc95ef7..de322f3 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/ZipDeflaterDataFormat.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/dataformat/ZipDeflaterDataFormat.java
@@ -25,7 +25,7 @@ import org.apache.camel.model.DataFormatDefinition;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Compress and decompress streams using java.util.zip.Deflater and 
java.util.zip.Inflater.
+ * Compress and decompress streams using <code>java.util.zip.Deflater</code> 
and <code>java.util.zip.Inflater</code>.
  */
 @Metadata(firstVersion = "2.12.0", label = "dataformat,transformation", title 
= "Zip Deflate Compression")
 @XmlRootElement(name = "zipdeflater")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/ConstantExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/ConstantExpression.java
index 15a80af..9188969 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/ConstantExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/ConstantExpression.java
@@ -23,11 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use a constant value in Camel expressions or predicates.
- * <p/>
- * <b>Important:</b>
- * this is a fixed constant value that is only set once during starting up the
- * route, do not use this if you want dynamic values during routing.
+ * A fixed value set only once during the route startup.
  */
 @Metadata(firstVersion = "1.5.0", label = "language,core", title = "Constant")
 @XmlRootElement(name = "constant")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/ExchangePropertyExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/ExchangePropertyExpression.java
index ccb91e5..249c298 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/ExchangePropertyExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/ExchangePropertyExpression.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use a Camel Exchange property in expressions or predicates.
+ * Get the value of named Camel Exchange property.
  */
 @Metadata(firstVersion = "2.0.0", label = "language,core", title = 
"ExchangeProperty")
 @XmlRootElement(name = "exchangeProperty")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/GroovyExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/GroovyExpression.java
index 45922d8..2c7ee4f 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/GroovyExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/GroovyExpression.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use Groovy scripts in Camel expressions or predicates.
+ * Evaluate a Groovy script.
  */
 @Metadata(firstVersion = "1.3.0", label = "language,script", title = "Groovy")
 @XmlRootElement(name = "groovy")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/HeaderExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/HeaderExpression.java
index 68cf3d3..c4c358f 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/HeaderExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/HeaderExpression.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use a Camel Message header in expressions or predicates.
+ * Get the value of the named Camel Message header.
  */
 @Metadata(firstVersion = "1.5.0", label = "language,core", title = "Header")
 @XmlRootElement(name = "header")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/Hl7TerserExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/Hl7TerserExpression.java
index 198b411..448a795 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/Hl7TerserExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/Hl7TerserExpression.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use HL7 terser scripts in Camel expressions or predicates.
+ * Get the value of an HL7 message field specified by terse location 
specification syntax.
  */
 @Metadata(firstVersion = "2.11.0", label = "language,hl7", title = "HL7 
Terser")
 @XmlRootElement(name = "hl7terser")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/JsonPathExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/JsonPathExpression.java
index 75dd3d0..f098cb8 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/JsonPathExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/JsonPathExpression.java
@@ -25,7 +25,7 @@ import javax.xml.bind.annotation.XmlTransient;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use JsonPath in Camel expressions or predicates.
+ * Evaluate a JsonPath expression against a JSON message body.
  */
 @Metadata(firstVersion = "2.13.0", label = "language,json", title = "JsonPath")
 @XmlRootElement(name = "jsonpath")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/LanguageExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/LanguageExpression.java
index 21eee66..a8b9ca3 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/LanguageExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/LanguageExpression.java
@@ -24,7 +24,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use the specified language in Camel expressions or predicates.
+ * Evaluate the given expression using the specified language.
  */
 @Metadata(label = "language,core", title = "Language")
 @XmlRootElement(name = "language")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/MethodCallExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/MethodCallExpression.java
index fc65cfd..1fcc9b9 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/MethodCallExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/MethodCallExpression.java
@@ -26,7 +26,7 @@ import org.apache.camel.spi.Metadata;
 import org.apache.camel.util.ObjectHelper;
 
 /**
- * To use a Java bean (aka method call) in Camel expressions or predicates.
+ * Call a method of the specified Java bean passing the Exchange, Body or 
specific headers to it.
  */
 @Metadata(firstVersion = "1.3.0", label = "language,core,java", title = "Bean 
method")
 @XmlRootElement(name = "method")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/MvelExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/MvelExpression.java
index 6855026..726cfb4 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/MvelExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/MvelExpression.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use MVEL scripts in Camel expressions or predicates.
+ * Evaluate an MVEL template against the Camel Exchange.
  */
 @Metadata(firstVersion = "2.0.0", label = "language,java", title = "MVEL")
 @XmlRootElement(name = "mvel")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/OgnlExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/OgnlExpression.java
index 007caee..ad46bf0 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/OgnlExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/OgnlExpression.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use OGNL scripts in Camel expressions or predicates.
+ * Evaluate an Apache Commons Object Graph Navigation Library (OGNL) 
expression against the Camel Exchange.
  */
 @Metadata(firstVersion = "1.1.0", label = "language,java", title = "OGNL")
 @XmlRootElement(name = "ognl")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/RefExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/RefExpression.java
index d08dffe..7406195 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/RefExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/RefExpression.java
@@ -23,8 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * Reference to an existing Camel expression or predicate, which is looked up
- * from the Camel registry.
+ * Look up an expression in the Camel Registry and evaluate it.
  */
 @Metadata(firstVersion = "2.8.0", label = "language,core", title = "Ref")
 @XmlRootElement(name = "ref")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/SimpleExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/SimpleExpression.java
index 5951d6f..14cdf24 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/SimpleExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/SimpleExpression.java
@@ -26,7 +26,7 @@ import org.apache.camel.Expression;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use Camels built-in Simple language in Camel expressions or predicates.
+ * Evaluate Camel's built-in Simple language expression against the Camel 
Exchange.
  */
 @Metadata(firstVersion = "1.1.0", label = "language,core,java", title = 
"Simple")
 @XmlRootElement(name = "simple")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/SpELExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/SpELExpression.java
index 793860f..1640270 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/SpELExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/SpELExpression.java
@@ -23,7 +23,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use Spring Expression Language (SpEL) in Camel expressions or predicates.
+ * Evaluate a Spring Expression Language (SpEL) expression against the Camel 
Exchange.
  */
 @Metadata(firstVersion = "2.7.0", label = "language,spring", title = "SpEL")
 @XmlRootElement(name = "spel")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/TokenizerExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/TokenizerExpression.java
index adba172..e4f7646 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/TokenizerExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/TokenizerExpression.java
@@ -24,8 +24,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use Camel message body or header with a tokenizer in Camel expressions or
- * predicates.
+ * Tokenize text payloads using the specified delimiter patterns.
  *
  * @see org.apache.camel.language.tokenizer.TokenizeLanguage
  */
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XMLTokenizerExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XMLTokenizerExpression.java
index 1218bfc..1691a6c 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XMLTokenizerExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XMLTokenizerExpression.java
@@ -24,8 +24,7 @@ import javax.xml.bind.annotation.XmlRootElement;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use Camel message body or header with a XML tokenizer in Camel 
expressions
- * or predicates.
+ * Tokenize XML payloads using the specified path expression.
  *
  * @see org.apache.camel.language.xtokenizer.XMLTokenizeLanguage
  */
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XPathExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XPathExpression.java
index 53bf195..31179c4 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XPathExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XPathExpression.java
@@ -29,7 +29,7 @@ import org.apache.camel.spi.Metadata;
 import org.apache.camel.util.ObjectHelper;
 
 /**
- * To use XPath (XML) in Camel expressions or predicates.
+ * Evaluate an XPath expression against an XML payload.
  */
 @Metadata(firstVersion = "1.1.0", label = "language,core,xml", title = "XPath")
 @XmlRootElement(name = "xpath")
diff --git 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XQueryExpression.java
 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XQueryExpression.java
index 4b97a43..d7564e8 100644
--- 
a/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XQueryExpression.java
+++ 
b/core/camel-core-engine/src/main/java/org/apache/camel/model/language/XQueryExpression.java
@@ -25,7 +25,7 @@ import javax.xml.bind.annotation.XmlTransient;
 import org.apache.camel.spi.Metadata;
 
 /**
- * To use XQuery (XML) in Camel expressions or predicates.
+ * Evaluate an XQuery expressions against an XML payload.
  */
 @Metadata(firstVersion = "1.0.0", label = "language,xml", title = "XQuery")
 @XmlRootElement(name = "xquery")

Reply via email to