From dfb05a9e8567e29f5620009125c07241ea29988f Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Sat, 29 Jun 2013 19:41:35 +0200
Subject: [PATCH] [#2095] Document <forcedType/>'s feature of forcing a column
 onto a SQL type

---
 .../src/main/resources/manual-3.1.xml         | 33 ++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/jOOQ-website/src/main/resources/manual-3.1.xml b/jOOQ-website/src/main/resources/manual-3.1.xml
index 97438b8fc7..d889011b70 100644
--- a/jOOQ-website/src/main/resources/manual-3.1.xml
+++ b/jOOQ-website/src/main/resources/manual-3.1.xml
@@ -9674,6 +9674,36 @@ public class Book implements java.io.Serializable
 					</section>
 
 
+                    <section id="data-type-rewrites">
+                        <title>Data type rewrites</title>
+                        <content>
+                            <p>
+                                Sometimes, the actual database data type does not match the SQL data type that you would like to use in Java. This is often the case for ill-supported SQL data types, such as <code>BOOLEAN</code> or <code>UUID</code>. jOOQ's code generator allows you to apply simple data type rewriting. The following configuration will rewrite <code>IS_VALID</code> columns in all tables to be of type <code>BOOLEAN</code>.
+                            </p>
+
+
+<xml><![CDATA[<database>
+
+  <!-- Associate data type rewrites with database columns -->
+  <forcedTypes>
+    <forcedType>
+      <!-- Specify any data type from org.jooq.impl.SQLDataType -->
+      <name>BOOLEAN</name>
+
+      <!-- Add a Java regular expression matching fully-qualified columns. 
+           Use the pipe to separate several expressions -->
+      <expressions>.*\.IS_VALID</expressions>
+    </forcedType>
+  </forcedTypes>
+</database>]]></xml>
+
+                            <p>
+                                See the section about <reference id="custom-data-types" title="Custom data types"/> for rewriting columns to your own custom data types.
+                            </p>
+                        </content>
+                    </section>
+
+
 				    <section id="custom-data-types">
 						<title>Custom data types and type conversion</title>
 						<content>
@@ -9700,7 +9730,8 @@ public class Book implements java.io.Serializable
       <!-- Specify again he fully-qualified class name of your custom type -->
       <name>java.util.GregorianCalendar</name>
 
-      <!-- Add a Java regular expression matching columns. Use the pipe to separate several expressions -->
+      <!-- Add a Java regular expression matching fully-columns. 
+           Use the pipe to separate several expressions -->
       <expressions>.*\.DATE_OF_.*</expressions>
     </forcedType>
   </forcedTypes>