r9657: Cleanup and document the FDDL.
[clsql.git] / doc / TODO
index f6b1715b7a945c47c126f21a6857f6bdb6188c92..d82e67978e99adfedb4e9c3f455e22a9a192d0f3 100644 (file)
--- a/doc/TODO
+++ b/doc/TODO
@@ -1,19 +1,23 @@
 DOCUMENTATION TO DO LIST
 
-1. Variances from CommonSQL
-
- - Ideally, this will be extremely minimal
+1. Variances from CommonSQL (Ideally, this will be extremely minimal) 
 
  - The SQL syntax state functions are macros in CLSQL. 
 
+ - CLSQL starts with in transaction AUTOCOMMIT mode. To begin a transaction,
+   START-TRANSACTION has to be called.
+
+
 2. Underdocumented CommonSQL features:
 
  - Retrieval immediate
  - SQL operators: ||, SUBSTR, MINUS, INTERSECT, UNION, NVL 
 
-2. CLSQL extensions to CommonSQL
 
- - RESULT-TYPES, FIELD-NAMES keywords for SELECT and QUERY
+3. CLSQL extensions to CommonSQL
+
+ - RESULT-TYPES, FIELD-NAMES keywords for SELECT, QUERY, DO-QUERY and 
+   MAP-QUERY. 
 
  - New types such as wall-time, boolean, and bigint
 
@@ -21,9 +25,7 @@ DOCUMENTATION TO DO LIST
    sql-view-class, coalesce, except (just from a quick scan of 
    operations.lisp)
 
- - FDDL: list-views, view-exists-p, list-indexes, list-table-indexes,
-   index-exists-p, create-sequence, drop-sequence, list-sequences,
-   sequence-exists-p, sequence-next, sequence-last, set-sequence-position
+ - FDML: TRUNCATE-DATABASE, FOR-EACH-ROW and large object support. 
 
  - OODML: *db-auto-sync*
 
@@ -33,28 +35,41 @@ DOCUMENTATION TO DO LIST
  - SQL-RECORDING-P: also accepts :both and :either values for the TYPE 
    parameter. 
 
- - SQL-EXPRESSION: also accepts a :params keyword arg which is passed 
+ - DEF-VIEW-CLASS: DB-CONSTRAINTS, DB-TYPE and VOID-VALUE slot options. 
+
+ - transactions: START-TRANSACTION and IN-TRANSACTION-P. 
+
+ - Tranactions: AUTOCOMMIT
+
 
 4. Documenting lower level, non-CommonSQL functions (some of this is already 
    done). 
 
  - connection pools
  - database-query-result-set 
 
 5. Notes on any peculiarities of each of the backends (e.g., unsupported 
    features, notable extensions etc.). 
 
  - MYSQL 
 
-   drop-index:   requires a table to be specified with the :from parameter
+   drop-index:   requires a table to be specified with the :on parameter
    views:        mysql does not support views  
    queries:      nested subqueries are not supported
    syntax:       doesn't support the sql concatenation operator (||). 
                  doesn't support INTERSECT/EXCEPT set operations. 
+   create-table: the transactions keyword arg controls whether the created 
+                 table is an InnoDB table (supporting transactions) or not. 
+   FDDL:         list-*/*-exists-p: :OWNER keyword argument ignored. 
 
  - SQLITE 
 
    connection:   specifying ":memory:" gives you an SQLite database in RAM.
    create-view:  column-list parameter not supported 
    syntax:       doesn't support the sql SUBSTRING operator. 
+   FDDL:         list-*/*-exists-p: :OWNER keyword argument ignored. 
+
+ - ODBC 
 
+   FDDL:         list-*/*-exists-p: :OWNER keyword argument ignored.