+++ /dev/null
-This is the header of the cadabra source file.
-
-
-;;;; a CMUCL/OCI implementation of a subset of the DBI interface
-;;;;
-;;;; The original version of this code was copyright (c) 1999-2000 Cadabra Inc.
-;;;; It was placed in the public domain by Cadabra in January 2000.
-;;;;
-;;;; The implementors of the original version were Winton Davies
-;;;; <wdavies@cadabra.com> and William Newman <william.newman@airmail.net>.
-;;;; The code will be maintained by Winton Davies.
-
-;;;; known issues:
-;;;; * The code will leak C resources if errors occur in the the wrong
-;;;; places, since it doesn't wrap its allocation/deallocation
-;;;; logic in the necessary EVAL-WHENs to prevent this. (This could be
-;;;; easily be an issue for long-running processes which recover from
-;;;; database errors instead of simply terminating when they occur. It's
-;;;; not an issue for programs which consider database errors so abnormal
-;;;; that they die immediately when they encounter one.)
-;;;; * Instead of reading Oracle header files automatically, this code
-;;;; uses constants, types, and function signatures manually transcribed
-;;;; from the Oracle header files. Thus, changes in the header files
-;;;; may require manual maintenance of the code. (This version was written
-;;;; for Oracle 8.1.5.)
-;;;; * various KLUDGEs noted in the code
-
-;;;; log:
-;;;; 6. * moved test suite to separate file
-;;;; * removed trailing spaces from all strings returned from database
-;;;; * fixed error in LIST-ALL-DATABASE-TABLES interface: DB should be
-;;;; a &KEY argument, not an &OPTIONAL argument
-;;;; 7. * merged Winton's code to allow the SQL function to ask OCI
-;;;; whether an operation returns a table, and not to worry about
-;;;; the TYPE keyword argument if no table is returned
-;;;; * reduced +N-BUF-ROWS+ from 1000 to reduce probability of
-;;;; hitting CMUCL 18b 8Mb-of-C-data limit
-;;;; * changed NOT-USED argument of FETCH-ROW to EOF-ERRORP, to
-;;;; conform to Allegro interface
-;;;; * found apparent bug in OCI (wrong size of value returned for the
-;;;; +oci-attr-data-size+ attribute); added workaround
-;;;; * found and documented the unnecessariness of "workaround" for
-;;;; "WITH-ALIEN not working" (which was actually a conceptual error
-;;;; on WHN's part, expecting WITH-ALIEN to work the same way as
-;;;; MAKE-ALIEN, not expecting one less level of indirection)
-;;;; * cleaned up NULLS-OK-USE-THIS-ERRHP weirdness and inflexibility,
-;;;; splitting the one argument into separate NULLS-OK and ERRHP
-;;;; arguments
-;;;; * added :ERRHP optional arguments to various OERR expressions,
-;;;; so that now failures are more likely to generate informative
-;;;; error messages instead of just "OCI Error (and no ERRHP
-;;;; available to find subcode)"
-;;;; 8. * added code to deallocate C resources
-;;;; 9. * Added in an extra field for DATE-FORMAT and DATE-FORMAT-LENGTH
-;;;; Munged the code for datatype and colsize. Winton Davies.
-;;;; 10. * cleaned up remnants of old date-is-fixed-length-field design
-;;;; assumption, getting rid of +OCi-date-bytes+
-;;;; * reduced consing in FETCH-ROW and associated functions
-;;;; * replaced WARN with IWARN for implementor-only warnings
-;;;; 11. * fixed bad (THE (ALIEN (* FLOAT)) B) declaration for
-;;;; SQLT_FLT buffers (should be (ALIEN (* DOUBLE)) instead;
-;;;; and for some reason fell through the cracks of CMUCL's
-;;;; "declarations are assertions" principle)
-;;;; * deleted various FIXME notes a la "does this code ever get
-;;;; exercised?" and "are these really all the cases we need?"
-;;;; * changed the IWARN call to a KLUDGE comment, deleted IWARN
-;;;; * tidied up comments
-;;;; * changed page breaks from lots-of-semicolons Cadabra style
-;;;; to ^L CMUCL style
-;;;; * declared DBI-ERROR to be INLINE
-;;;; * fixed definition of +oci-htype-env+
-;;;; * reviewed and corrected C resource deallocation code
-;;;; 12. * Made load-foreign depend on ORACLE-HOME for more portability.
-
projects / clsql.git / blobdiff