From 30e106eeb0612706063cd7e57ccc9061f3e271d5 Mon Sep 17 00:00:00 2001
From: Oleg Zhurakousky <ozhurakousky@vmware.com>
Date: Wed, 10 Nov 2010 10:52:53 -0500
Subject: [PATCH] INT-1501 initial refactoing of the transformer section to
 address better docs for header-enricher

---
 docs/src/reference/docbook/claim-check.xml    | 11 ++++++++
 .../reference/docbook/content-enrichment.xml  | 28 +++++++++++++++++++
 .../docbook/message-transformation.xml        |  3 +-
 docs/src/reference/docbook/transformer.xml    |  9 ++----
 4 files changed, 43 insertions(+), 8 deletions(-)
 create mode 100644 docs/src/reference/docbook/claim-check.xml
 create mode 100644 docs/src/reference/docbook/content-enrichment.xml

diff --git a/docs/src/reference/docbook/claim-check.xml b/docs/src/reference/docbook/claim-check.xml
new file mode 100644
index 0000000000..67d6da2174
--- /dev/null
+++ b/docs/src/reference/docbook/claim-check.xml
@@ -0,0 +1,11 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="claim-check"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+  <title>Claim Check</title>
+
+  <section id="claim-check-introduction">
+    <title>Introduction</title>
+    
+  </section>
+
+</section>
diff --git a/docs/src/reference/docbook/content-enrichment.xml b/docs/src/reference/docbook/content-enrichment.xml
new file mode 100644
index 0000000000..016a06bc5c
--- /dev/null
+++ b/docs/src/reference/docbook/content-enrichment.xml
@@ -0,0 +1,28 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<section xmlns="http://docbook.org/ns/docbook" version="5.0" xml:id="content-enricher"
+    xmlns:xlink="http://www.w3.org/1999/xlink">
+  <title>Content Enricher</title>
+
+  <section id="content-enricher-introduction">
+    <title>Introduction</title>
+   <para>
+   Some time you may have a requirement to enhance a request with more information then it was 
+   provided by the target system. <link href="http://www.eaipatterns.com/DataEnricher.html">Content Enricher</link> pattern 
+   describes various scenarios as well as the component (Enricher), which allows you to address such requirements.
+   </para>
+  </section>
+  
+  <section id="header-enricher">
+    <title>Header Enricher</title>
+   
+    <para>
+    If you only need to add headers to a Message, and they are not dynamically determined by Message content,
+    then referencing a custom implementation may be overkill. For that reason, Spring Integration provides the
+    'header-enricher' element.   <programlisting language="xml"><![CDATA[ <header-enricher input-channel="in" output-channel="out">
+     <header name="foo" value="123"/>
+     <header name="bar" ref="someBean"/>
+ </header-enricher>]]></programlisting>
+    </para>
+  </section>
+
+</section>
diff --git a/docs/src/reference/docbook/message-transformation.xml b/docs/src/reference/docbook/message-transformation.xml
index c8644b35f4..6a4f708876 100644
--- a/docs/src/reference/docbook/message-transformation.xml
+++ b/docs/src/reference/docbook/message-transformation.xml
@@ -5,5 +5,6 @@
   <title>Message Transformation</title>
 
   <xi:include href="./transformer.xml"/>
-
+  <xi:include href="./content-enrichment.xml"/>
+  <xi:include href="./claim-check.xml"/>
 </chapter>
diff --git a/docs/src/reference/docbook/transformer.xml b/docs/src/reference/docbook/transformer.xml
index f0a6341e90..108f249878 100644
--- a/docs/src/reference/docbook/transformer.xml
+++ b/docs/src/reference/docbook/transformer.xml
@@ -88,13 +88,8 @@
 
  <payload-deserializing-transformer input-channel="bytesIn" output-channel="objectsOut"/>]]></programlisting>
   </para>
-  <para>
-    If you only need to add headers to a Message, and they are not dynamically determined by Message content,
-    then referencing a custom implementation may be overkill. For that reason, Spring Integration provides the
-    'header-enricher' element.   <programlisting language="xml"><![CDATA[ <header-enricher input-channel="in" output-channel="out">
-     <header name="foo" value="123"/>
-     <header name="bar" ref="someBean"/>
- </header-enricher>]]></programlisting>
+    <para>
+    <emphasis>Object-to-Map Transformer</emphasis>
     </para>
     <para>
     As added convenience, Spring Integration also provides <emphasis>Object-to-Map</emphasis> and <emphasis>Map-to-Object</emphasis> transformers which