X-Git-Url: http://git.kpe.io/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fref-syntax.xml;h=c83cab344d41ad08852dfb922f4db23adba092a7;hb=75fc587eb38dc243370160823906f9cea60326df;hp=b13dd32ff0cd7c279673e28e464efe1592244ffe;hpb=aee3ea30595ebee301ccb1532062053c3c580e19;p=clsql.git
diff --git a/doc/ref-syntax.xml b/doc/ref-syntax.xml
index b13dd32..c83cab3 100644
--- a/doc/ref-syntax.xml
+++ b/doc/ref-syntax.xml
@@ -84,6 +84,11 @@
The symbolic SQL syntax is disabled by default.
+
+ &clsql; differs from &commonsql; in that
+ enable-sql-reader-syntax is defined as a
+ macro rather than a function.
+
@@ -153,6 +158,11 @@
The symbolic SQL syntax is disabled by default.
+
+ &clsql; differs from &commonsql; in that
+ disable-sql-reader-syntax is defined as a
+ macro rather than a function.
+
@@ -225,6 +235,11 @@
The symbolic SQL syntax is disabled by default.
+
+ &clsql; differs from &commonsql; in that
+ locally-enable-sql-reader-syntax is
+ defined as a macro rather than a function.
+
@@ -302,6 +317,11 @@
The symbolic SQL syntax is disabled by default.
+
+ &clsql; differs from &commonsql; in that
+ locally-disable-sql-reader-syntax is
+ defined as a macro rather than a function.
+
@@ -381,6 +401,11 @@
The symbolic SQL syntax is disabled by default.
+
+ &clsql; differs from &commonsql; in that
+ restore-sql-reader-syntax-state is
+ defined as a macro rather than a function.
+
@@ -653,7 +678,7 @@
Syntax
- sql-operationoperation&restargs => result
+ sql-operationoperator&restargs => resultsql-operation 'function func&restargs => result
@@ -661,7 +686,7 @@
Arguments and Values
- operation
+ operatorA symbol denoting an SQL operator.
@@ -689,9 +714,9 @@
DescriptionReturns an SQL expression constructed from the supplied
- SQL operator or function operation and
+ SQL operator or function operator and
its arguments args. If
- operation is passed the symbol 'function
+ operator is passed the symbol 'function
then the first value in args is taken to
be a valid SQL function and the remaining values in
args its arguments.
@@ -728,7 +753,7 @@
Exceptional SituationsAn error of type sql-user-error
- is signalled if operation is not a symbol
+ is signalled if operator is not a symbol
representing a supported SQL operator.
@@ -757,13 +782,13 @@
Syntax
- sql-operatoroperation => result
+ sql-operatoroperator => resultArguments and Values
- operation
+ operatorA symbol denoting an SQL operator.
@@ -779,9 +804,9 @@
Description
- Returns the Lisp symbol corresponding to the SQL operation
- represented by the symbol operation. If
- operation does not represent a supported
+ Returns the Lisp symbol corresponding to the SQL operator
+ represented by the symbol operator. If
+ operator does not represent a supported
SQL operator or is not a symbol, nil is returned.
@@ -816,8 +841,9 @@
Notes
- &clsql;'s symbolic SQL syntax currently has support for
- the following SQL operators:
+
+ &clsql;'s symbolic SQL syntax currently has support for the
+ following &commonsql; compatible SQL operators:
@@ -894,8 +920,15 @@
slot-value
,
userenv
-
,
+
+
+ as well as the pseudo-operator function.
+
+ The following operators are provided as &clsql; extensions to
+ the &commonsql; API.
+
+
concat
,
substring
@@ -920,13 +953,15 @@
,
coalesce
,
- view-class
+ view-class.
-
- as well as the pseudo-operator
- function. Note that some of these operators
- are not supported by all of the RDBMS supported by
- &clsql;.
+
+
+
+ Note that some of these operators are not supported by all of
+ the RDBMS supported by &clsql; (see the Appendix for details).
+