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