r9370: * sql/db-interface.lisp: Add new db-type-has-union?
[clsql.git] / ChangeLog
1 15 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
2         * Version 2.10.18
3         * sql/db-interface.lisp: Add new db-type-has-union? 
4         since Mysql 3.23 does not support unions.
5         * sql/test-init.lisp: Don't try union tests on database
6         backends which do not support it.
7         * db-oracle/*.lisp: initial port to UFFI
8         * sql/objects.lisp: implement UPDATE-OBJECT-JOINS,
9         implement REFRESH for SELECT.
10         * tests/test-oodml.lisp: Add tests for deferred retrieval,
11         caching, refresh, and update-object-joins
12         * tests/test-init.lisp: Add deferred-employee-address class
13         
14 15 May 2004 Marcus Pearce (m.t.pearce@city.ac.uk) 
15         * sql/operations.lisp: make MINUS operator a synonym for EXCEPT. Add 
16         COALESCE operator and make NVL a synonym for this. Make ANY, SOME, 
17         ALL and EXISTS generate function expressions so they output the 
18         correct SQL. 
19         * sql/classes.lisp: SELECT now generates appropriate SQL when 
20         passed the SET-OPERATION and ALL keyword arguments. 
21         * sql/classes.lisp: the ORDER-BY keyword argument to SELECT now 
22         accepts ordering constraints as pairs of the form (column direction) 
23         where direction may be :ASC or :DESC. 
24         * tests/test-syntax.lisp: added tests for MINUS and COALESCE/NVL. 
25         Correct tests for ANY, SOME, ALL and EXISTS. 
26         * tests/test-fdml.lisp: added test for COALESCE. 
27         * sql/sql.lisp: MAP-QUERY now applies FUNCTION to QUERY-EXPRESSION 
28         using funcall unless QUERY-EXPRESSION returns one column and its 
29         FLATP slot is not nil in which case apply is used. 
30         * tests/test-basic.lisp: modified calls to MAP-QUERY to reflect the 
31         changes. 
32         * TODO: remove items done. 
33         * db-postgresql/postgresql-sql.lisp: no need to reverse results in 
34         DATABASE-LIST-ATTRIBUTES. 
35         * db-postgresql-socket/postgresql-socket-sql.lisp: no need to reverse
36         results in DATABASE-LIST-ATTRIBUTES.    
37         
38 15 May 2004 Marcus Pearce (m.t.pearce@city.ac.uk) 
39         * sql/classes.lisp: SELECT now accepts table identifiers as strings 
40         for CommonSQL compliance. Add support for qualified sql identifiers 
41         with aliased table names. 
42         * tests/test-fdml.lisp: added tests for table identifiers as strings 
43         in SELECT and for aliased definitions. 
44         * tests/test-syntax.lisp: added tests for alias definitions. 
45         
46 15 May 2004 Marcus Pearce (m.t.pearce@city.ac.uk) 
47         * sql/sql.lisp: PRINT-QUERY now calls QUERY with result-types and 
48         field-names set to nil. 
49         * sql/sql.lisp: PRINT-QUERY now computes column sizes correctly 
50         with null attribute values. 
51         * sql/operations.lisp: modify SQL concatenation operator to accept 
52         unescaped || symbol.  
53         * sql/syntax.lisp: modify sql reader macro function to accept 
54         unescaped sql concatenation operator. 
55         * tests/test-fdml.lisp: unescape sql concatenation operator. 
56         * tests/test-syntax.lisp: unescape sql concatenation operator. 
57         * TODO: remove items done. Add notes about SQLITE/MYSQL backends. 
58         Note to add test for universal-time. Note about difference from 
59         CommonSQL in transaction handling. 
60
61 13 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
62         * tests/test-init.lisp: Add deferred-employee-address
63         class
64         * tests/test-oodml.lisp: Add deferred retrieval testgs
65         
66 12 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
67         * Version 2.10.17
68         * LATEST-TEST-RESULTS: Run on all platforms, add AMD64
69         * sql/sql.lisp: Add FOR-EACH-ROW macro from clsql-classic/sql.lisp
70         * db-sqlite/sqlite-uffi-api.lisp: Fix row-pointer type
71         * *: Fix minor style warnings
72         * clsql-classic: Remove system and subdirectory
73         * clsql-base: Remove system and subdirectory and
74         fold into clsql system
75         * doc/intro.xml: Remove reference to old clsql-base. Add x86_64
76         as supported platform.
77         
78 12 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
79         * Version 2.10.16: CLSQL now fully supports AllegroCL AMD64
80         * db-odbc/odbc-api.lisp: work around return-type bug [spr28889] in
81         Allegro 7.0beta AMD64
82         * db-odbc/*.lisp: Add a layer of indirection to foreign-type
83         of ODBC longs since this type can vary on 64-bit platforms depending
84         upon the compilation options of unixODBC.
85         * db-mysql/mysql-api.lisp: Fix int vs. long slots in foreign
86         structures found by testing with AllegroCL 7.0b AMD64.
87         * db-*/*-loader.lisp: Load 64-bit libraries on 64-bit platorms
88         * sql/objects.lisp: Simple implementation of UPDATE-OBJECT-JOINS.
89         Initial caching support for SELECT
90         * tests/test-oodml.lisp: Avoid using cache when testing select.
91         * sql/kmr-mop.lisp: Explicitly check slot order and
92         store as a cl:*feature*
93         * sql/recording.lisp: Remove additional types to
94         increase CommonSQL conformance.
95         * tests/test-init.lisp: Change a :column attribute
96         to test symbols as value
97         * sql/relations.lisp: Remove functions since they don't support
98         many to many relationships.
99         * examples/clsql-tutorial.lisp, doc/csql.lisp: Remove use
100         of add-to-relations function and replace with explicit field settings.
101         * base/classes.lisp: Remove obsolute query-stream. Add record-caches slot.
102         
103 9 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
104         * Version 2.10.15
105         * LATEST-TEST-RESULTS: results with current version
106         * sql/kmr-mop.lisp: Make CMUCL reader macros specific for cmu18
107         since cmu19 has opposite order of class slots.
108         * sql/objects.lisp: Fix (setf slot-value-using-class) for Lispworks
109         * tests/test-fdml.lisp: Renumber SELECT tests to avoid overwriting
110         a previous test
111         * tests/test-init.lisp: Check test-database-underlying-type for
112         ODBC/MySQL tests
113         
114 8 May 2004 Marcus Pearce (m.t.pearce@city.ac.uk) 
115         * sql/operations.lisp: complete remaining operations for the sql 
116         syntax: SUBSTR, SOME, ORDER-BY, GROUP-BY, NULL, DISTINCT, EXCEPT, 
117         UNION, INTERSECT, BETWEEN. 
118         * sql/classes.lisp: add new classes: SQL-BETWEEN-EXPRESSION, 
119         SQL-QUERY-MODIFIER-EXPRESSION and SQL-SET-EXPRESSION. 
120         * tests/test-syntax.lisp: add tests for new operations. 
121         * tests/test-fdml.lisp: add tests for queries based on new operations. 
122         * tests/test-init.lisp: add select/20 to tests skipped for sqlite and 
123         select/20, query/5, query/7 and query/8 to tests skipped by mysql. 
124         * TODO: removed entries done. 
125
126 8 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
127         * tests/benchmarks.lisp: Add immediate vs. deferred
128         join test.
129         
130 8 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
131         * Version 2.10.13: Now works on openmcl 0.14.2 
132         * sql/objects.lisp: Add :retrieval :immediate for
133         object selections
134         * tests/test-init.lisp: Add non-index fields for testing 
135         join class employee-addresss
136         * test/test-oodml.lisp: Add tests for retrieval immediate
137         * sql/metaclasses.lisp: Handle differences in direct-slot-definition 
138         values which are now listifed by openmcl 14.2.
139         * sql/objects.lisp: more framework for supporing immediate retrieval 
140
141 7 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
142         * docs/intro.xml: Upload location of a README file
143         * sql/metaclass.lisp: Work-around openmcl's CHANGE-CLASS
144         changing the type-specifier. Use a lisp type of (OR NULL FOO)
145         for a specified-type of FOO unless :db-constraints :not-null.
146         No need to specialize finalize-inheritance for openmcl.
147         * tests/test-*.lisp: Rename fields so that joins occur on
148         fields with different names. This ensures that join code is
149         selecting the proper name.
150         * test/test-init.lisp: Add :base-table for employee-address
151         view class for testing.
152         * sql/objects.lisp: Use view-table rather than name of table
153         in a number of places to fix errors noted with using :base-table.
154
155 6 May 2004 Marcus Pearce (m.t.pearce@city.ac.uk) 
156         * sql/objects.lisp: replace *update-records-on-make-instance* with 
157         *db-auto-sync* which also controls both automatic creation of 
158         new records on creation of new instance and updating of record 
159         fields on setting of instance slots (as suggested by Edi Weitz). 
160         * tests/test-init.lisp: replace *update-records-on-make-instance* 
161         with *db-auto-sync*. 
162         * sql/package.lisp: replace *update-records-on-make-instance* 
163         with *db-auto-sync*. 
164         * TODO: replace *update-records-on-make-instance* with *db-auto-sync*. 
165         * sql/objects.lisp: remove redundant rebindings of *db-initializing* 
166         and *default-database* in FIND-ALL. 
167         * sql/package.lisp: import time functions from CLSQL-BASE. 
168         * tests/test-time.lisp: replace CLSQl-BASE package qualifier with CLSQL. 
169         * tests/test-fdml.lisp: replace CLSQl-BASE package qualifier with CLSQL. 
170         * tests/test-init.lisp: replace CLSQl-BASE package qualifier with CLSQL. 
171         * tests/test-ooddl.lisp: replace CLSQl-BASE package qualifier with 
172         CLSQL. 
173
174 4 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
175         * sql/classes.lisp: Add SQL-OBJECT-QUERY type. Have [select 'class]
176         now return a sql-object-query type rather than directly performing a query.
177         This improves CommonSQL conformance.
178         * sql/sql.lisp: Add new QUERY method for SQL-OBJECT-QUERY. Move
179         from basic/basic-sql.lisp the DO-QUERY and MAP-QUERY since they now
180         depend on sql-object-query-type.
181         * sql/loop-extensions.lisp: Move from base package
182         * classic/package.lisp: remove references to map-query and do-query
183
184 4 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
185         * TODO: New section on optimizations, especially optimizing JOINs.
186         * sql/objects.lisp: Have :target-slot return of list of lists rather
187         than a list of cons pairs to be conformant with CommonSQL.
188         Make :target-slot much more efficient by using a SQL inner join
189         statement and just requiring one SQL query. Add :retrieval :deferrred
190         to target-slot joins. Add placeholder for update-objects-join.
191         * sql/classes.lisp: Add :inner-join and :on slots to sql-query class
192         and process them for query output-sql. 
193
194 4 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
195         * Version 2.10.11
196         * base/basic-sql.lisp: Avoid multiple evaluation
197         of query-expression in DO-QUERY
198         * sql/objects.lisp: Make SELECT a normal function.
199         SELECT now accepts type-modified database identifiers, such as
200         [foo :string] which means that the values in column foo are returned 
201         as Lisp strings. Add new *update-records-on-make-instance* special
202         variable controlling automatic creation of new instances. Add missing
203         RESULT-TYPES keyword to FIND-ALL. Add :target-slot support.
204         * sql/packages.lisp: Export *update-records-on-make-instance* 
205         * test/test-oodml.lisp: Add tests for :target-slot and many-to-many
206         selections.
207         * test/test-fdml.lisp: Add tests for type-modified
208         database identifiers.
209         * test/test-init.lisp: Stop using add-relation since implementing
210         many-to-many joins. Use *update-records-on-make-instance* 
211         to automatically store records on instance creation. Add many-to-many
212         employee-address view-class.
213         
214 4 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
215         * Version 2.10.10
216         * base/loop.lisp: Add object iteration. Use :result-type
217         :auto for result-set. Remove 
218         duplicate (and non-correct) code for non-list variables by
219         simply making an atom variable into a list. 
220         * sql/package.lisp: Remove unnecessary clsql-sys package
221         and replace it with clsql.
222         * sql/metaclasses.lisp: Properly store specified-type from
223         direct-slot-definition and then store translated type in
224         effective-slot-definition
225         * sql/classes.lisp: Don't output type in sql-output
226         for SQL-IDENT-ATTRIBUTE. This is in preparation for supporting
227         [foo :integer] as fields in SELECT.
228         * sql/query.lisp: Set default for :result-types to :auto in
229         FDML QUERY.
230         * sql/objects.lisp: Use specified-type when invocating 
231         database-get-type-specifier. def-view-class macro now returns
232         the class instance.
233         * base/basic-sql.lisp: Make :AUTO the default value for
234         :RESULT-TYPES for MAP-QUERY and DO-QUERY.
235         * sql/objects.lisp: Add bigint type
236         * test/tests-basic.lisp: Add tests for :result-types for
237         MAP-QUERY and DO-QUERY
238         * test/test-fdml.lisp: Add test for result-types in LOOP
239         and also using single symbol rather than a list for variables.
240         Add test that default :result-types is auto for FDML QUERY.
241         * test/test-syntax.lisp: Don't expect TYPE in the SQL-OUTPUT
242         of SQL-IDENT-ATTRIBUTE.
243         * test/test-oodml.lisp: Enable OO loop iteration test,
244         modify it so it doesn't depend on boolean where.
245         
246 4 May 2004 Marcus Pearce (m.t.pearce@city.ac.uk) 
247         * Version 2.10.9
248         * sql/objects.lisp: added derived type specifier for universal time. 
249         * sql/package.lisp: added #:universal-time to clsql-sys exports. 
250         * tests/test-oodml.lisp: added test for translation of boolean slots 
251         in SELECT with object queries. 
252         
253 3 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
254         * db-odbc/odbc-api.lisp: Fix changing nil to "NIL" 
255         for odbc/postgresql backend.
256         * db-odbc/odbc-sql.lisp: Fix ATTRIBUTE-TYPE so that
257         it can handle NIL values from the ODBC driver
258         * tests/benchmarks.lisp: New file with initial
259         benchmark suite
260         * sql/relations.lisp: fix to add subclassing support,
261         minor optimizations [Edi Weitz]
262         
263 3 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
264         * Version 2.10.8        
265         * base/conditions.lisp: Add *backend-warning-behavior*
266         special variable.
267         * db-postgresql-socket/postgresql-socket-sql.lisp:
268         Honor value of *backend-warning-behavior*
269         * tests/test-fdml.lisp: Remove test of raw boolean value
270         since different backends handle this differently. Add
271         test for :column attribute.
272         * tests/test-oodml.lisp: Add tests for boolean slot value
273         and for :void-value attribute
274         * tests/test-init.lisp: Use *backend-warning-behavior*
275         to suppress warnings from postgresql about implicitly
276         creating primary key in tables. Add new address table.
277         
278 3 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
279         * Version 2.10.7
280         * db-odbc/odbc-dbi.lisp: Convert TINYINT to integers when
281         result-types is :auto
282         * sql/objects.lisp: Properly handled writing/reading Boolean
283         values from SQL database when retrieving objects.
284         * test/test-fdml.lisp: Add another test for boolean results
285         * test/utils.lisp: Fix incorrect declaration
286         
287 2 May 2004 Marcus Pearce (m.t.pearce@city.ac.uk) 
288         * Version 2.10.6
289         * sql/generics.lisp: add generic function for SELECT. 
290         * sql/objects.lisp: make SELECT a method specialisation. 
291         * sql/classes.lisp: MAKE-QUERY now calls SELECT if the selections 
292         referred to are View Classes. 
293         * base/basic-sql.lisp: in DO-QUERY and MAP-QUERY, if the 
294         query-expression arg evaluates to a list, then we have an object 
295         query. 
296         * tests/test-oodml.lisp: add tests for DO-QUERY and MAP-QUERY with 
297         object queries. 
298         * TODO: remove items done and add a todo for SELECT. 
299         * sql/objects.lisp: SELECT takes a :field-names arg to pass on to 
300         QUERY. 
301         * sql/sql.lisp: add :field-names arg to QUERY. 
302         * tests/test-fdml.lisp: minor rework to use :field-names arg to 
303         SELECT. 
304
305 2 May 2004 Marcus Pearce (m.t.pearce@city.ac.uk)
306         * sql/objects.lisp: fix bug in FIND-ALL when SELECT called with 2 
307         or more View Classes. 
308         * sql/objects.lisp: make the :flatp argument to SELECT work with 
309         object queries. 
310         * sql/objects.lisp: make SELECT accept a :result-types argument 
311         (defaults to :auto) which is passed on to QUERY.  
312         * sql/objects.lisp: SELECT returns field-names as a second value. 
313         * tests/test-ooddl.lisp: add flatp arg to SELECT calls as appropriate. 
314         * tests/test-fdml.lisp: add flatp/result-types arguments to calls 
315         to SELECT and take only first value as appropriate.
316         * tests/test-fdml.lisp: add two new tests for query result coercion 
317         and the field-names returned as a second value from SELECT. 
318         * tests/test-oodml.lisp: add flatp arg to SELECT calls as appropriate. 
319         
320 1 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
321         * Version 2.10.6-pre1
322         * sql/metaclasses.lisp: Add void-value slot
323         * doc/csql.xml: Update def-view-class documentation
324         * test/test-init.lisp: Change old :db-type to :db-kind.
325         Remove old :nulls-ok attributes.
326         * sql/objects.lisp: Add new universal-time and bigint
327         types. Optimize reading of integers using parse-integer
328         rather than read-from-string.
329         * */*.lisp: Merge clsql-base-sys and clsql-base packages
330         into clsql-base package
331         * classic/sql.lisp: Move large object support into base, leaving
332         classic without any functionality that is provided in the clsql
333         system.
334         * classic/package.lisp: Rename clsql-classic-sys package to
335         its former nickname of clsql-classic
336         
337 1 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
338         * Version 2.10.5: SQLite backend now passes all result-types tests
339         * clsql-sqlite.asd: Depend on clsql-uffi system
340         * db-sqlite/sqlite-sql.lisp: Use clsql-uffi:convert-raw-field
341         for efficiency and code reuse. 
342         * db-sqlite/sqlite-api-uffi.lisp: Change (* :char) to (* :unsigned-char)
343         for better cross-implementation compatibility.
344
345 1 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
346         * Version 2.10.4
347         * sql/tables.lisp: Fix typo in CACHE-TABLE-QUERIES
348         [Marcus Pearce]
349         * db-postgresql/postgresql-sql.lisp: Fix foreign-string vs. cstring
350         bug on SBCL in result-field-names function as reported by Marcus Pearce
351         * db-sqlite/sqlite-sql.lisp: Fix  in database-store-next-row
352         manifest in SBCL testing
353         
354 1 May 2004 Kevin Rosenberg (kevin@rosenberg.net)
355         * Version 2.10.3
356         * sql/database.lisp: Conform more to CommonSQL output
357         for STATUS command [Marcus Pearce]
358         * sql/sqlite-sql.lisp: Rework to use result-types
359         * sql/sqlite-api-clisp.lisp: Add compatibility layer
360         with sqlite-api-uffi.lisp so that sqlite-sql.lisp can
361         be cleaned up of most clisp reader conditionals
362         * sql/test-init.lisp: Now run field type tests on sqlite
363         backend
364         
365 30 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
366         * Version 2.10.2
367         * base/basic-sql.lisp: Set default value of :result-types 
368         to :auto for more CommonSQL conformance. 
369         * test/test-fdml.lisp: Add tests for numeric value of fields
370         
371
372 30 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
373         * Version 2.10.1: New API function: CACHE-TABLE-QUERIES.
374         * base/basic-sql.lisp, db-*/*-sql.lisp: More CommonSQL conformance.
375         Return field names as second value for QUERY. This can be overridden
376         for efficiency with the new keyword :FIELD-NAMES set to NIL
377         in the QUERY invocation.
378         * test/test-fdml.lisp: Add tests for new field-name feature
379         * sql/metaclass.lisp: Remove old Lispworks cruft
380         and replace it with invocation of new code in kmr-mop.lisp
381         which actually works with Lispworks 4.2
382         * doc/ref_clsql.xml: Document new :FIELD-NAMES keyword to
383         QUERY function
384         * base/db-interface.lisp: Document the multiple values
385         returned by DATABASE-ATTRIBUTE-TYPE so matches the
386         undocumented CommonSQL behavior. 
387         * sql/table.lisp: Add *CACHE-TABLE-QUERIES-DEFAULT* and
388         *DEFAULT-UPDATE-OBJECTS-MAX-LEN* variables and export them.
389         LIST-ATTRIBUTE-TYPES now conforms to CommonSQL spec.
390         Implement CACHE-TABLE-QUERIES.
391         * db-odbc/odbc-sql.lisp: Fix attribute-type function
392         * test/test-fddl.lisp: Add tests for attribute type     
393         * db-mysql/mysql-sql.lisp: Mild optimization in accessing
394         field structures.
395         * base/classes.lisp: Add attribute-cache slot to database clas
396         * base/initialize.lisp: initialize-database-type now automatically
397         loads database-type backend as needed.
398         * base/test-init.lisp: Utilize new initialize-database-type functionality.
399         * TODO: remove items done
400         
401 30 Apr 2004 Marcus Pearce (m.t.pearce@city.ac.uk) 
402         * Version 2.9.6
403         * sql/objects.lisp: remove create/drop-sequence-from-class. 
404         * sql/objects.lisp: add INSTANCE-REFRESHED generic function. 
405         * sql/objects.lisp: improved CommonSQL compatibility for
406         UPDATE-RECORD-FROM-SLOT, UPDATE-RECORD-FROM-SLOTS,
407         UPDATE-RECORDS-FROM-INSTANCE and DELETE-INSTANCE-RECORDS. 
408         * sql/generics.lisp: move generics from objects.lisp to here. 
409         
410 29 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
411         * Version 2.9.6-pre1
412         * db-mysql/mysql-client-info.lisp: Add client version 4.1
413         detection
414         * sql/sql.lisp: Make *default-database* the default for
415         TRUNCATE-DATABASE
416         
417 28 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
418         * Version 2.9.5
419         * db-mysql/mysql-sql.lisp: Fix bug in transaction capability
420         detection
421         * sql/objects.lisp: Commit patch from Slawek Zak to allow specifying 
422         :metaclass in DEF-VIEW-CLASS invocation. This allows defining classes 
423         on a metaclass specialized from standard-db-class.
424
425         
426 24 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
427         * Version 2.9.4: Multiple changes to support Allegro's "modern"
428         lisp which uses a lowercase reader and has case-sensitive symbols
429         * sql/classes.lisp: Fix make-load-form bug for sql-ident-table
430         exposed by case-sensitive mlisp. 
431
432 22 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
433         * Version 2.9.3: All tests now pass on all platforms!
434         * LATEST-TEST-RESULTS: New file with summary of test results
435         * sql/generics.lisp: New file for generic function definitions.
436         * test/test-init.lisp: Display names of skipped tests.
437         Use unwind-protect to ensure disconnect
438         * sql/objects.lisp: Change database-type to database-underlying-type
439         so that actual database engine is properly identified
440         * db-odbc/odbc-api.lisp: Have default *time-conversion-function*
441         return an ISO timestring for compatibility with other drivers.
442         Workaround bug in MyODBC for LIST-TABLE-INDEXES
443         * test/test-fdml.lisp: Accomodate that odbc-postgresql driver
444         returns floating-point values for floor and truncate operations 
445         * db-aodbc/aodbc-sql.lisp: Implement DATABASE-LIST-VIEWS
446         * tests/test-basic.lisp: Port to regression tester
447         * test/test-init.lisp: Output to *report-stream*
448         * docs/appendix.xml: Document ODBC and SQLite backends.
449         * sql/classes.lisp: Make output-sql require a database parameter.
450         This allows SQL generation to have the proper case to support
451         the differences in case handling between CommonSQL API,
452         Postgresql, MySQL, Oracle.
453         
454 21 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
455         * Version 2.9.2: Improvments in database capability introspection
456         and querying. Support transactions in MySQL where available.
457         All tests now pass on MySQL and SQLite in addition to postgresql
458         and postgresql-socket. ODBC fails only with OODDL/TIME/1 and OODDL/TIME/2.
459         * db-odbc/odbc-sql.lisp: Add DATABASE-LIST-VIEWS. Better support
460         DATABASE-LIST-SEQUENCES.
461         * clsql-uffi.asd, clsql-mysql.asd: Improve shared library loading
462         * Database_capabilies: add HAS-VIEWS, HAS-CREATE/DESTROY-DB,
463         HAS-BOOLEAN-WHERE, TRANSACTION-CAPABLE
464         * tests/*.lisp: Check database capabilities and remove tests which
465         the database backend does not support
466         * sql/table.lisp: Add :TRANSACTIONS keyword to create table which
467         controls whether InnoDB tables will be created when supported on
468         the underlying MySQL server.
469         
470 20 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
471         * Version 2.9.0: New API function: LIST-TABLE-INDEXES,
472         supported by all database backends (except AODBC since
473         AODBC doesn't support index querying)
474         * db-obdc/odbc-sql.lisp: Support DATABASE-LIST-INDEXES
475         * db-odbc/odbc-api.lisp: Add %TABLE-STATISTICS function
476         to support index queries
477         * db-aodbc/aodbc-sql.lisp: Filter driver manager
478         "information_schema" tables from LIST-TABLES
479         * tests/test-basic.lisp: Remove table after testing
480         * tests/test-fddl.lisp: Test LIST-TABLE-INDEXES
481         * base/db-interface.lisp: Add DATABASE-UNDERLYING-TYPE
482         which gets the underlying type of database -- required
483         when dealing with ODBC databases and want to query
484         database capabilities. Added DB-USE-COLUMN-ON-DROP-TABLES?
485         as first database-backend specific feature. Is T on
486         :mysql, NIL on other backends. Change DROP-TABLE to
487         query this.
488         
489 19 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
490         * Version 2.8.2: Build changes for FreeBSD [Slawek Zak]
491
492 19 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
493         * Version 2.8.1
494         * db-odbc/odbc-sql.lisp: Add DATABASE-LIST function 
495         * db-odbc/odbc-dbi.lisp: Add LIST-ALL-DATA-SOURCES function 
496
497 19 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
498         * Version 2.8.0: New API function: LIST-DATABASES
499         * base/utils.lisp: Fix command-output on CMUCL/SBCL
500         * db-*/*-sql.lisp: Add new database-list function
501         * base/database.lisp: Add new LIST-DATABASES command
502         
503 18 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
504         * Version 2.7.9
505         * db-sqlite/sqlite-sql.lisp: Fix sequence functions.
506         * db-sqlite/sqlite-api-uffi.lisp: Print error string
507         correctly.
508         
509 18 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
510         * Version 2.7.7
511         * doc/csql.xml, examples/clsql-tutorial.lisp: Patch for db-kind
512         from Eduardo Munoz.
513         
514 17 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
515         * Version 2.7.6
516         * base/objects.lisp, base/classes.lisp: Patch
517         for db-kind from Eduardo Munoz
518         
519 16 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
520         * Version 2.7.5
521         * base/basic-sql.lisp: Fix FLATP in QUERY
522
523 16 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
524         * Version 2.7.3: Implement RECONNECT
525
526 15 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
527         * Version 2.7.2: Fix ODBC on Lispworks Windows
528
529 15 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
530         * Version 2.7.1: Fix for new ODBC backend.
531         clsql-odbc now works on SBCL, CMUCL, OpenMCL
532         in addition to AllegroCL and Lispworks.
533
534 15 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
535         * Version 2.7.0: New backend: ODBC. Tests as
536         well as AODBC backend on Allegro,Lispworks.
537         SBCL and CMUCL don't work quite yet.  Requires UFFI v1.4.11+
538         * db-odbc/*.lisp: Add ODBC3 function SQLSetEnvAttr
539         to explicitly set ODBC2 support. Add BIGINT support.
540         Add result-types support. Added SQLTables.
541         Fix array type in fetch-all-rows. Make width
542         changable by database or query.
543         * base/utils.lisp: Add process functions
544         * base/package.lisp: Export utils to CLSQL-BASE-SYS
545         * db-aodbc: Implement sequence functions,
546         database-list-tables, database-list-attributes
547         * tests/utils.lisp: Add support for ODBC backend,
548         rework READ-SPECS to use +all-db-types+
549         * db-mysql/mysql-sql.lisp: Use WITHOUT-INTERRUPTS
550         for SEQUENCE-NEXT
551         
552 13 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
553         * Version 2.6.13. Requires UFFI version 1.4.9
554         * db-odbc/*.lisp: Further porting.
555         Pre-alpha code! But, basic query is now working.
556
557 13 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
558         * Version 2.6.12
559         * base/transactions.lisp: Add quote for macro
560         expansion of WITH-TRANSACTIONS [Time Howe]
561         * db-sqlite/sqlite-sql.lisp: Support memory database
562         in database-probe [Ng Pheng Siong]
563         * db-odbc/*.lisp: Initial port to UFFI of SQL-ODBC.
564         The DBI layer is not finished.
565         
566 12 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
567         * Version 2.6.11
568         * sql/objects.lisp: add :root-class functionality for
569         list-classes and add duration type support [Marcus Pearce]
570         * db-odbc: Add mid-level [DBI] layer
571
572 12 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
573         * Version 2.6.10
574         * db-aodbc: Add methods for generic functions, some are
575         not yet implemented.
576         * clsql-odbc.asd, db-odbc/*.lisp: Initial start of ODBC
577         support
578
579 12 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
580         * Version 2.6.9
581         * base/package.lisp: Add missing symbols [Marcus Pearce]
582
583 12 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
584         * Version 2.6.8
585         * test/test-fddl.lisp: Cleanup fix [Marcus Pearce]
586         * utils/time.lisp: Multiple fixes [Marcus Pearce]
587         * sql/sql.lisp: Fix for truncate-database [Marcus Pearce]
588         
589 12 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
590         * Version 2.6.7
591         * sql/*.lisp: Remove schema versioning cruft
592         [Marcus Pearce]
593         * Makefile: Add classic subdirectory
594         
595 12 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
596         * Version 2.6.6
597         * sql/sql.lisp: Fix TRUNCATE command, bug reported
598         by Marcus Pearce
599         * sql/sql.lisp: Remove EXPLAIN function. Postgresql/Oracle
600         specific and easy for an application to directly support.
601         Idea from Marcus Pearce.
602         * base/basic-sql.lisp: Remove DESCRIBE-TABLE top-level 
603         API as duplicates LIST-ATTRIBUTE-TYPES [Marcus Pearce].
604         Keep low-level interface for future optimization
605         supporting LIST-ATTRIBUTE-TYPES command.
606         * Makefile: Add to db-sqlite and test directories.
607         Include them in top-level Makefile
608         
609 12 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
610         * Version 2.6.5
611         * sql/relations.lisp: Add missing file
612         * utils/time.lisp: Fixes/extensions [Marcus Pearce]
613         * test/test-time.lips: New file [Marcus Pearce]
614         
615 10 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
616         * Version 2.6.4
617         * test/test-init.lisp: Properly handle object
618         creation. Close database after use.
619         * sql/sql.lisp: Make DESCRIBE-TABLE a generic
620         function so can have methods specialized on
621         table being a string or an sql-table object.
622         * base/pool.lisp: Really fix CMUCL locking
623         
624 10 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
625         * Version 2.6.3
626         * test/test-init.lisp: Signal correctly
627         if any errors occurred in any test suite
628         * base/loop-extensions.lisp: Fix error
629         introduced for Lispworks
630         * base/pool.lisp: Fix locking for CMUCL
631         * base/objects.lisp: Remove schema-version cruft
632         
633 10 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
634         * Version 2.6.2: New CLSQL API functions:
635         DESCRIBE-TABLE AND TRUNCATE-DATABASE
636         Currently, this are only supported on :postgresql
637         and :postgresql-socket
638         * base/database.lisp: automatically load ASDF system
639         in CONNECT if not already loaded
640         * base/tests.lisp: disconnect database after testing 
641         * base/*.lisp: Remove CLOSED-DATABASE type in favor
642         of storing open/closed status in slot of database
643         * base/pool.lisp: Support locks for CMUCL, OpenMCL, SBCL
644         * db-postgresql/postgresql-sql.lisp: add DATABASE-RECONNECT,
645         DATABASE-DESCRIBE-TABLE
646         * db-sqlite/sqlite-sql.lisp: Add missing slots in database
647         * base/conditions: Remove duplicate condition
648         * db-*/*-sql.lisp: Fill new database slot DATABASE-TYPE
649         * base/recording.lisp: Add new :QUERY type for recording
650         
651 10 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
652         * Version 2.6.1: documentation fixes, merged
653         classic-tests into tests
654
655 10 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
656         * Version 2.6.0 released: New API functions
657         CREATE-DATABASE, DESTORY-DATABASE, PROBE-DATABASE
658         * doc/ref_clsql.xml: Document new functions
659         * base/database.lisp: New API functions
660         * base/conditions.lisp: Added CLSQL-ACCESS-ERROR
661         * base/utils.lisp: Fix use of position-char.
662         Add COMMAND-OUTPUT used by backends for running
663         external programs. Fix parsing of SQL*NET-compatible
664         connection-specs.
665         * base/loop-extension.lisp: Simplify package use
666         for Lispworks and Allegro
667         * db-*/*-sql.lisp: Added DATABASE-CREATE,
668         DATABASE-DESTORY, PROBE-DATABASE methods
669         * tests/test-init.lisp, clasic-tests/tests.lisp:
670         Use destroy-database and create-database to ensure 
671         testing with empty database
672         * tests/test-connection.lisp: Add tests for
673         parsing of string connection-specs
674         * examples/run-tests.sh: New file for running
675         test suite on all installed CL implementations
676         * examples/clsql-tutorial.lisp: moved from
677         doc directory
678         * examples/dot.clsql-tests.config: New file
679         giving an example test configuration
680         * test/README: Add notes about rtest/ptester
681         downloads and link to sample test configuration file.
682         
683 10 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
684         * Version 2.5.1 released:
685         * tests/*.lisp: Rework so tests are run
686         on multiple backends automatically based
687         on the contents of ~/.clsql-tests.config.
688         Reuse helper functions from classic-tests.
689         * base/database.lisp: Support connection-spec
690         as string for CONNECT
691         * classic-tests/tests.lisp: Automatically
692         load database backends as needed. 
693         
694 09 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
695         * Version 2.5.0 released:
696         All tests for CLSQL and CLSQL-CLASSIC pass
697         on all platforms.
698         * base/loop-extension.lisp: Add Lispworks
699         loop-extension. Improve type specifying on
700         other platforms.
701         
702 09 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
703         * Version 2.4.2 released:
704         loop extension now supported on Allegro, all
705         CLSQL-TESTS pass on Allegro.
706         * sql/metaclasses.lisp: Some optimization
707         of compute-slots, be selective when
708         ordered-class-slots needs to be called
709         instead of class-slots
710         * TODO: add URL with documentation on
711         extending Lispworks LOOP form
712         
713 09 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
714         * Version 2.4.1 released: CLSQL-TESt suite passes
715         all tests for postgresql and CMUCL, SBCL, OpenMCL.
716         Allegro and Lispworks pass all tests except for
717         FDML/LOOP/1 since the loop extension have not yet
718         been ported to those implementions.
719         * sql/metaclasses.lisp: Added new slot to standard-db-class
720         to hold user-specified type. OpenMCL adjustments to compensate
721         for its type-predicate function. Since AllegroCL, Lispworks,
722         and OpenMCL have different slot orders, added compute-slots
723         and ordered-class-slots functions so their slot order matches
724         SBCL/CMUCL.
725
726 08 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
727         * Version 2.4.0 released: All tests for clsql-classic now finish
728         correctly on Allegro, Lispworks, CMUCL, SBCL, OpenMCL for
729         mysql, postgresql, postgresql-sockets, and sqlite backends.
730         * db-mysql/mysql-sql.lisp: Fix array dereferencing
731         * classic-tests/tests.lisp: Fix package name of
732         number-to-sql-string. 
733         * clsql.asd/clsql-tests.asd: Add support for asdf:test-op
734         * db-sqlite/sqlite-api-{uffi,sql}.lisp: Multiple UFFI fixes,
735         now passes tests on all support UFFI platforms.
736         * db-postgresql-socket/postgresql-socket-api.list: Ported to 
737         SBCL and OpenMCL
738         * multiple: Finish renaming of :types keyword to :result-types for
739         greater CommonSQL compatibility, including documentation
740         * sql/basic-cmds.lisp: Remove obsolete file
741         
742 08 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
743         * Version 2.3.3 released
744         * Fixes for sequences on mysql and sqlite [Marcus Pearce]
745         * Fixes for uffi sqlite backend [Aurelio Bignoli / Kevin Rosenberg]
746         * Fix for schema table [Marcus Pearce]
747         * Add loop extension support for SBCL and OpenMCL [Marcus Pearce]
748         * Fixes to test suite [Marcus Pearce]
749
750 06 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
751         * db-*/*-sql.lisp: Ensure that expr in
752         database-query-result-set is a string
753         * Documentation integration
754         
755 06 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
756         * With for Marcus Pearce's excellent work, I've merged
757         his clsql-usql port into clsql. The original clsql
758         interface is available in the clsql-classic package.
759
760 02 Apr 2004 Kevin Rosenberg (kevin@rosenberg.net)
761         * Integrate patch from Marcus Pearce <ek735@soi.city.ac.uk>
762         adding further support for providing backend for UncommonSQL
763
764 10 Mar 2004 Kevin Rosenberg (kevin@rosenberg.net)
765         * Integrate patch from Aurelio Bignoli for SQLite backend
766
767 11 Nov 2003 Kevin Rosenberg (kevin@rosenberg.net)
768         * Converted documentation to XML format
769         * Made package installable with asdf-install
770
771 23 Jul 2003 Kevin Rosenberg (kevin@rosenberg.net)
772         * Add for-each-row macro
773
774 12 Dec 2002 Kevin Rosenberg (kevin@rosenberg.net)
775         * uffi/clsql-uffi.lisp: return NIL for numeric fields that are NULL
776         
777 16 Oct 2002 Kevin Rosenberg (kevin@rosenberg.net)
778         * Add support for SBCL, OpenMCL, and SCL
779         * Add *load-truename* to search path for clsql's
780         compiled libraries.
781
782 01 Sep 2002 Kevin Rosenberg (kevin@rosenberg.net)
783         * Rework use of file types in .asd files
784
785 17 Aug 2002 Kevin Rosenberg (kevin@rosenberg.net)
786         * Add .asd definition files for ASDF users
787
788 31 Jul 2002 Kevin Rosenberg (kevin@rosenberg.net)
789         * Restructure directories for Common Lisp Controller v3 compatibility
790
791 25 Jul 2002 Kevin Rosenberg (kevin@rosenberg.net)
792         * Also change case of logical host in loader files
793         * Rework handling of logical pathnames
794         
795 05 Jul 2002 Kevin Rosenberg (kevin@rosenberg.net)
796         * Change case of logical host
797         
798 14 May 2002 Kevin Rosenberg (kevin@rosenberg.net)
799         * clsql-base.system: Added base package that can be used without
800         high-level SQL commands. Used for adding support for UncommonSQL.
801         * *.system: Reworked logical pathnames to be more consistent with
802         Common Lisp Controller.
803         * debian/*: Completed initial Debian support
804         
805 10 May 2002 Marc Battyani (marc.battyani@fractalconcept.com)
806         * sql/classes.cl:
807         * sql/transactions.cl:
808         Added transaction support. Functions/macros added:
809         with-transaction, commit-transaction, rollback-transaction,
810         add-transaction-commit-hook, add-transaction-rollback-hook
811
812 04 May 2002 Marc Battyani (marc.battyani@fractalconcept.com)
813         * sql/sql.cl:
814         * sql/pool.cl:
815         * sql/functional.cl:
816         Added pool support in connect/disconnect and with-database.
817         Removed with-db-from-pool as with-database can now works with the connections pool
818
819 01 May 2002 Marc Battyani (marc.battyani@fractalconcept.com)
820         * sql/sql.cl:
821         * sql/pool.cl:
822         * sql/classes.cl:
823         * sql/package.cl:
824         Completed connection pool.
825         Added with-db-from-pool macro.
826         
827 27 Apr 2002 Kevin Rosenberg (kevin@rosenberg.net)
828         * Multiple files:
829         Added initial support for connection pool
830         * sql/transactions.cl
831         Took transaction code from UncommonSQL and integrated
832         into CLSQL code. See file for disclaimer about why this
833         was added.
834
835 23 Apr 2002 Kevin Rosenberg (kevin@rosenberg.net)
836         * interfaces/postgresql/postgresql-sql.cl:
837         Fix keyword typo in database-read-large-object
838         * interfaces/mysql/mysql-loader.cl
839         Fix loading on Win32
840         * test-suite/tester-clsql.cl
841         Fix type coercion of double-float
842         * doc/*
843         Added debian docbook catalog, made it the default
844         
845 19 Apr 2002 Marc Battyani (marc.battyani@fractalconcept.com)
846         * interface/postgresql/postgresql-api.cl:
847         * interface/postgresql/postgresql-sql.cl:
848         * sql/sql.cl:
849         * sql/db-interface.cl:
850         Added large objects support for postgresql.
851
852 07 Apr 2002 Kevin Rosenberg (kevin@rosenberg.net)
853         * src/postgresql-socket/postgresql-socket-api.cl:
854         Fixed find-foreign-function call, eliminated crypt warning
855         * Makefiles:
856         Multiple improvements
857         * sql/usql.cl:
858         Moved functionality from low-level interfaces to this file
859         via generic functions
860         * test-suite/tester.cl:
861         Added test with acl-compat-tester, moved others to old-tests
862         directory.
863         
864 06 Apr 2002 Kevin Rosenberg (kevin@rosenberg.net)
865         * src/usql.cl:
866         Reinstated commented out sections
867         * interfaces/postgresql/postgresql-loader.cl:
868         * interfaces/mysql/mysql-loader.cl:
869         Updated find-forieign-library support.
870         * interfaces/postgresql-socket/postgresql-socket-package.cl:
871         Fixed require form for Lispworks (Thanks Marc Battyani!)
872         * interfaces/postgresql-socket/postgresql-socket-api.cl:
873         Fixed eval of def-function for crypt library.
874                 
875 31 Mar 2002 Kevin Rosenberg (kevin@rosenberg.net)
876         * Added interface to support USQL high-level rouines
877         
878 29 Mar 2002 Kevin Rosenberg (kevin@rosenberg.net)
879         * Separated db-interface and conditions from sql/sql.cl
880         * Improved foreign library loading testing
881         * interfaces/postgresql/postgresql-api.cl
882         Added PQisBusy function
883         * interfaces/clsql-uffi/clsql-uffi.cl
884         Fixed sign error for 64-bit processing
885         
886 27 Mar 2002 Kevin Rosenberg (kevin@rosenberg.net)
887         * interfaces/postgresql-socket/postgresql-socket-api.cl:
888         Fixes to read-double-from-socket. Added 64-bit integer support.
889         * test-suite/xptest-clsql.cl
890         Added testint for 64-bit integers
891         * Additons to installation docs
892         
893 26 Mar 2002 Kevin Rosenberg (kevin@rosenberg.net)
894         * interfaces/postgresql-socket/postgresql-socket-api.cl:
895         Implemented direct socket reading for field type :double
896         * Added usage information for :types to documentation
897         * interfaces/mysql/mysql-sql.cl: Fixed type specifiers in atoi,
898         atol, atof calls
899         * interfaces/clsql-uffi: Created new directory. Split common
900         interface routines that use UFFI into this package. Required
901         especially to support direct reading of 64-bit integers into
902         bignums and bypassing temporary strings.
903         * test-clsql.cl: Updated to test postgresql-socket's
904         read-double-from-socket function.
905         * test-suite/xptest-clsql.cl
906         Started work on test suite
907
908 25 Mar 2002 Kevin Rosenberg (kevin@rosenberg.net)
909         * interfaces/mysql/mysql-api.cl: Added mysql-fetch-fields,
910         mysql-fetch-field-direct Got :auto types working
911         * interfaces/postgresql/postgresql-api.cl
912         * interfaces/postgresql-socket/postgresql-socket-api.cl
913         Added pgsql-field-types enum. Got :auto types working.
914         * multiple-files
915         Renamed :field-types to :types.
916         
917 24 Mar 2002 Kevin Rosenberg (kevin@rosenberg.net)
918         * Added field-types parameter to query, database-query,
919         database-query-result-set, map-query. Haven't added code
920         to utilize field types, yet.
921         * Changed postgresql-socket result set from cons to a structure
922         * Updated test-clsql.cl to use automated testing with a config
923         file
924         * Changed return types of field accessors from cstring to
925         (* :unsigned-char).  This prepares for being able to use specified
926         type conversions when taking field data into lisp.
927         * Added field-type processing for most interfaces. Not done yet.
928         
929 23 Mar 2002 Kevin Rosenberg (kevin@rosenberg.net)
930         * doc/ref.sgml: Updated MAP-QUERY example to use
931         *read-default-float-format* (John Foderaro)
932         * Extensive work to foreign library loaders and .system files to
933         check for successful loading of foreign libraries.
934         * Modified test-clsql.cl to allow more modularity and
935         automated testing in future release.
936         * mysql/mysql-sql.lisp: Added field types
937         
938 01 Jan 2002 Kevin Rosenberg (kevin@rosenberg.net)
939         * mysql/mysql-sql.lisp:
940         - Added support for Allegro CL and Lispworks using UFFI layer
941         - Changed database-connect to use mysql-real-connect. This way,
942           can avoid using double (unwind-protect)
943         - Changed database-connect to have MySQL library allocate space
944           for MYSQL structure. This will make the code more robust in
945           the event that MySQL library changes the size of the mysql-mysql
946           structure.
947
948