Documentation.

diff --git a/docs/03_performance.mkd b/docs/03_performance.mkd
index 377d222c8cfead3fdbde346ce5d4e7db3fa44db2..34e545cecd516023479c2d02c42581725650285e 100644 (file)
--- a/docs/03_performance.mkd
+++ b/docs/03_performance.mkd
@@ -9,10 +9,12 @@ Performance of iciql statement generation is not currently benchmarked.
 \r
 ### iciql+database performance comparison\r
 \r
-The following data was generated by running the *single-threaded* iciql test suite.  All database connections are pooled and re-used within each execution of the test suite using [Apache Commons DBCP](http://commons.apache.org/dbcp).  All tables are created as CACHED when the database distinguishes between CACHED and MEMORY tables.\r
+The following data was generated by running the *single-threaded* iciql test suite.  All database connections are pooled and re-used within each execution of the test suite using [Apache Commons DBCP](http://commons.apache.org/dbcp).\r
 \r
 Connections are pooled to normalize embedded database performance with out-of-process database performance.  Some of the Java embedded database configurations have a very high startup-time penalty.  Notably, H2 is slow to open a database and its performance is substantially affected if connection pooling is not enabled to keep the embedded database open.\r
 \r
+All tables are created as CACHED when the database distinguishes between CACHED and MEMORY tables.\r
+  \r
 All performance numbers include the combined overhead of iciql statement generation and JUnit 4 test framework execution so they are not bare-metal database metrics.  \r
 \r
 <pre>\r

diff --git a/docs/06_jaqu_comparison.mkd b/docs/06_jaqu_comparison.mkd
new file mode 100644 (file)
index 0000000..da7da41
--- /dev/null
+++ b/docs/06_jaqu_comparison.mkd
@@ -0,0 +1,25 @@
+\r
+## Comparison to JaQu \r
+\r
+This is an overview of the fundamental differences between the original JaQu project and the current featureset of iciql.  \r
+\r
+<table>\r
+<tr><th></th><th>Iciql</th><th>JaQu</th></tr>\r
+<tr><th colspan="3">core</th></tr>\r
+<tr><td>deployment</td><td>small, discrete library</td><td>depends on H2 database jar file</td></tr>\r
+<tr><td>databases</td><td>supports H2, HSQL, Derby, MySQL, and PostreSQL</td><td>supports H2 only</td></tr>\r
+<tr><td>logging</td><td>supports console, SLF4J, or custom logging</td><td>supports console logging</td></tr>\r
+<tr><td>exceptions</td><td>always includes generated statement in exception, when available</td><td>--</td></tr>\r
+<tr><th colspan="3">syntax and api</th></tr>\r
+<tr><td>dynamic queries</td><td>methods and where clauses for dynamic queries that build iciql objects</td><td>--</td></tr>\r
+<tr><td>DROP</td><td>syntax to drop a table</td><td></td></tr>\r
+<tr><td>BETWEEN</td><td>syntax for specifying a BETWEEN x AND y clause</td><td>--</td></tr>\r
+<tr><th colspan="3">types</th></tr>\r
+<tr><td>primitives</td><td>fully supported</td><td>--</td></tr>\r
+<tr><td>enums</td><td>fully supported</td><td>--</td></tr>\r
+<tr><td>DECIMAL(length,scale)</td><td>can specify length/precision and scale</td><td>--</td></tr>\r
+<tr><td>BOOLEAN</td><td>flexible mapping of boolean as bool, varchar, or int</td><td>--</td></tr>\r
+<tr><td>BLOB</td><td>partially supported *(can not be used in a WHERE clause)*</td><td>--</td></tr>\r
+<tr><td>UUID</td><td>fully supported *(H2 only)* </td><td>--</td></tr>\r
+<tr><td>DEFAULT values</td><td>set from annotations or *default object values*</td><td>set from annotations</td></tr>\r
+</table>
\ No newline at end of file