From 3dd2803eeababc22dd56e0d18fa74e503756e9dc Mon Sep 17 00:00:00 2001
From: Lukas Eder <lukas.eder@gmail.com>
Date: Thu, 14 Feb 2013 13:42:50 +0100
Subject: [PATCH] [#1914] Document the fact that SELECT * is performed by
 leaving the SELECT list empty

---
 jOOQ-website/src/main/resources/manual-3.0.xml | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/jOOQ-website/src/main/resources/manual-3.0.xml b/jOOQ-website/src/main/resources/manual-3.0.xml
index 373da0a0d3..3cb46cf7f6 100644
--- a/jOOQ-website/src/main/resources/manual-3.0.xml
+++ b/jOOQ-website/src/main/resources/manual-3.0.xml
@@ -1664,6 +1664,21 @@ Select<?> select2 = create.selectOne();]]></java>
 <java><![CDATA[Select<?> select1 = create.selectDistinct(BOOK.TITLE);]]></java>
 </code-pair>
 
+                                            <h3>SELECT *</h3>
+                                            <p>
+                                            	jOOQ does not explicitly support the asterisk operator in projections. However, you can omit the projection as in these examples:
+                                            </p>
+                                            
+<java><![CDATA[// Explicitly selects all columns available from BOOK
+create.select().from(BOOK);
+
+// Explicitly selects all columns available from BOOK and AUTHOR
+create.select().from(BOOK, AUTHOR);
+create.select().from(BOOK).crossJoin(AUTHOR);
+
+// Renders a SELECT * statement, as columns are unknown to jOOQ
+create.select().from(tableByName("BOOK"));]]></java>                                            
+
 											<h3>Typesafe projections with degree up to {max-row-degree}</h3>
 											<p>
 												Since jOOQ 3.0, <reference id="record-n" title="records"/> and <reference id="row-value-expressions" title="row value expressions"/> up to degree {max-row-degree} are now generically typesafe. This is reflected by an overloaded <code>SELECT</code> (and <code>SELECT DISTINCT</code>) API in both Factory and Executor. An extract from Factory: