Merge #563 from branch '497-improve-decode-xml-documentation' of github.com:metafacture/metafacture-core

Author: dr0i

metafacture-xml/src/main/java/org/metafacture/xml/GenericXmlHandler.java

@@ -34,7 +34,11 @@
  * @author Markus Michael Geipel
  *
  */
-@Description("A generic xml reader")
+@Description("A generic XML reader. Separates XML data in distinct records with the defined record tag name (default: `recordtagname=\"record\"`) " +
+        "If no matching record tag is found, the output will be empty. " +
+        "The handler breaks down XML elements with simple string values and optional attributes " +
+        "into entities with a value subfield (name configurable) and additional subfields for each attribute. " +
+        "Record tag and value tag names can be configured. Attributes can get an attributeMarker.")
 @In(XmlReceiver.class)
 @Out(StreamReceiver.class)
 @FluxCommand("handle-generic-xml")

metafacture-xml/src/main/java/org/metafacture/xml/SimpleXmlEncoder.java

@@ -47,7 +47,7 @@
  * @author Christoph Böhme
  *
  */
-@Description("Encodes a stream as xml")
+@Description("Encodes a stream as XML. Defaults: `rootTag=\"records\"`, `recordTag=\"record\"`, no attributeMarker.")
 @In(StreamReceiver.class)
 @Out(String.class)
 @FluxCommand("stream-to-xml")