X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;f=doc%2Fref-fdml.xml;h=5eb4f070052f9a113c11814b9b6df6c92b2cdf37;hb=2949884623a44f1866a383fb74a88aada9fced93;hp=2908175042d8c71a5f54cb07c8c6df0a32192ff2;hpb=8a13e05588cb35ffeed91cca2dc26c313e387d70;p=clsql.git
diff --git a/doc/ref-fdml.xml b/doc/ref-fdml.xml
index 2908175..5eb4f07 100644
--- a/doc/ref-fdml.xml
+++ b/doc/ref-fdml.xml
@@ -37,7 +37,7 @@
*CACHE-TABLE-QUERIES-DEFAULT*
- Variable *CACHE-TABLE-QUERIES-DEFAULT*
+ *CACHE-TABLE-QUERIES-DEFAULT*
Specifies the default behaviour for caching of
attribute types.
Variable
@@ -94,14 +94,14 @@
CACHE-TABLE-QUERIES
- Function CACHE-TABLE-QUERIES
- Controls the caching of attribute type information for a database table.
+ CACHE-TABLE-QUERIES
+ Control the caching of table attribute types.
Function
Syntax
- cache-table-queries table &key action database) =>
+ cache-table-queries table &key action database =>
Arguments and Values
@@ -189,11 +189,11 @@
Side Effects
-
+
The internal attribute cache for
database is modified.
-
-
+
+
Affected by
@@ -220,15 +220,12 @@
-
-
-
INSERT-RECORDS
- Function INSERT-RECORDS
+ INSERT-RECORDS
Insert tuples of data into a database table.
Function
@@ -391,7 +388,7 @@
UPDATE-RECORDS
- Function UPDATE-RECORDS
+ UPDATE-RECORDS
Updates the values of existing records.
Function
@@ -551,7 +548,7 @@
DELETE-RECORDS
- Function DELETE-RECORDS
+ DELETE-RECORDS
Delete records from a database table.
Function
@@ -665,7 +662,7 @@
EXECUTE-COMMAND
- Generic Function EXECUTE-COMMAND
+ EXECUTE-COMMAND
Execute an SQL command which returns no values.
Generic Function
@@ -769,7 +766,7 @@
QUERY
- Generic Function QUERY
+ QUERY
Execute an SQL query and return the tuples as a
list.
Generic Function
@@ -973,7 +970,7 @@
PRINT-QUERY
- Function PRINT-QUERY
+ PRINT-QUERY
Prints a tabular report of query results.
Function
@@ -1129,14 +1126,14 @@ ID FORENAME SURNAME EMAIL
SELECT
- Function SELECT
+ SELECT
Executes a query given the supplied constraints.
Function
Syntax
- select &rest identifiers &key all distinct from group-by having order-by set-operation where result-types field-names flatp refresh database => result
+ select &rest identifiers &key all distinct from group-by having order-by set-operation where result-types field-names flatp refresh caching database => result
Arguments and Values
@@ -1283,6 +1280,35 @@ ID FORENAME SURNAME EMAIL
+
+ refresh
+
+
+ This value is only considered when CLOS objects are being
+ selected. A boolean with a default value of &nil;. When
+ the value of the caching keyword is
+ &t;, a second equivalent select call
+ will return the same view class instance objects. When
+ refresh is &t;, then slots of the
+ existing instances are updated as necessary. In such
+ cases, you may wish to override the hook
+ instance-refresh.
+
+
+
+
+ caching
+
+
+ This value is only considered when CLOS objects are being
+ selected. A boolean with a default value of
+ *default-caching*. &clsql; caches
+ objects in accordance with the &commonsql; interface: a
+ second equivalent select call will
+ return the same view class instance objects.
+
+
+
result
@@ -1444,10 +1470,8 @@ ID FORENAME SURNAME EMAIL
Side Effects
-
Whatever effects the execution of the SQL query has on
the underlying database, if any.
-
Affected by
@@ -1506,7 +1530,7 @@ ID FORENAME SURNAME EMAIL
DO-QUERY
- Macro DO-QUERY
+ DO-QUERY
Iterate over all the tuples of a query.
Macro
@@ -1687,9 +1711,10 @@ ID FORENAME SURNAME EMAIL
LOOP
- Additional clause for LOOP
- Iterate over all the tuples of a
- query via a loop clause.
+ LOOP
+ Extension to Common Lisp
+ Loop to iterate over all the
+ tuples of a query via a loop clause.
Loop Clause