Return-Path: Delivered-To: apmail-db-derby-commits-archive@www.apache.org Received: (qmail 43594 invoked from network); 1 Sep 2006 20:55:20 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 1 Sep 2006 20:55:20 -0000 Received: (qmail 42063 invoked by uid 500); 1 Sep 2006 20:55:20 -0000 Delivered-To: apmail-db-derby-commits-archive@db.apache.org Received: (qmail 42042 invoked by uid 500); 1 Sep 2006 20:55:20 -0000 Mailing-List: contact derby-commits-help@db.apache.org; run by ezmlm Precedence: bulk list-help: list-unsubscribe: List-Post: Reply-To: "Derby Development" List-Id: Delivered-To: mailing list derby-commits@db.apache.org Received: (qmail 42031 invoked by uid 99); 1 Sep 2006 20:55:19 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 01 Sep 2006 13:55:19 -0700 X-ASF-Spam-Status: No, hits=-0.0 required=10.0 tests=SPF_HELO_PASS X-Spam-Check-By: apache.org Received: from [192.87.106.226] (HELO ajax.apache.org) (192.87.106.226) by apache.org (qpsmtpd/0.29) with ESMTP; Fri, 01 Sep 2006 13:55:18 -0700 Received: from ajax.apache.org (localhost [127.0.0.1]) by ajax.apache.org (Postfix) with ESMTP id 29E74D4972 for ; Fri, 1 Sep 2006 21:54:57 +0100 (BST) Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Apache Wiki To: derby-commits@db.apache.org Date: Fri, 01 Sep 2006 20:54:57 -0000 Message-ID: <20060901205457.14712.53905@ajax.apache.org> Subject: [Db-derby Wiki] Update of "ReferenceManualTenTwo" by jeanTanderson X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N Dear Wiki user, You have subscribed to a wiki page or wiki category on "Db-derby Wiki" for change notification. The following page has been changed by jeanTanderson: http://wiki.apache.org/db-derby/ReferenceManualTenTwo The comment on the change is: cleaned up some of the url references (hopefully for the better) ------------------------------------------------------------------------------ ||'''Sub Section''' || '''HTML Url''' or '''PDF Page''' || '''Reviewer'''|| '''Comment''' ||'''Resolution''' || - ||DECLARE GLOBAL TEMPORARY TABLE statement || [http://db.apache.org/derby/docs/dev/ref/rrefdeclaretemptable.html HTML URL] || Yip || Under Restrictions on Declared Global Temporary Tables, GRANT and REVOKE should be added to that restriction list. || || + ||DECLARE GLOBAL TEMPORARY TABLE statement || [http://db.apache.org/derby/docs/dev/ref/rrefdeclaretemptable.html rrefdeclaretemptable.html] || Yip || Under Restrictions on Declared Global Temporary Tables, GRANT and REVOKE should be added to that restriction list. || || - ||CREATE SCHEMA statement || [http://db.apache.org/derby/docs/dev/ref/rrefsqlj31580.html HTML URL] || Yip || CREATE SCHEMA syntax needs to be updated. The following are also allowed: CREATE SCHEMA schema-name AUTHORIZATION user-name and CREATE SCHEMA AUTHORIZATION user-name. Addtional examples to use these new syntax would be nice. || || + ||CREATE SCHEMA statement || [http://db.apache.org/derby/docs/dev/ref/rrefsqlj31580.html rrefsqlj31580.html] || Yip || CREATE SCHEMA syntax needs to be updated. The following are also allowed: CREATE SCHEMA schema-name AUTHORIZATION user-name and CREATE SCHEMA AUTHORIZATION user-name. Addtional examples to use these new syntax would be nice. || || - ||RENAME TABLE statement || [http://db.apache.org/derby/docs/dev/ref/rrefsqljrenametablestatement.html HTML URL] || Yip || RENAME TABLE needs to address that one can only perform renaming of a table if the user is the database owner or the user have the authorization to the schema of the table to be renamed. || || + ||RENAME TABLE statement || [http://db.apache.org/derby/docs/dev/ref/rrefsqljrenametablestatement.html rrefsqljrenametablestatement.html] || Yip || RENAME TABLE needs to address that one can only perform renaming of a table if the user is the database owner or the user have the authorization to the schema of the table to be renamed. || || - ||LOCK TABLE statement || [http://db.apache.org/derby/docs/dev/ref/rrefsqlj40506.html HTML URL] || Yip || LOCK TABLE needs to address that one can only perform locking of a table if the user is the database owner or the user have the proper privilege to execute such an action. This is not covered in the design spec. || || + ||LOCK TABLE statement || [http://db.apache.org/derby/docs/dev/ref/rrefsqlj40506.html rrefsqlj40506.html] || Yip || LOCK TABLE needs to address that one can only perform locking of a table if the user is the database owner or the user have the proper privilege to execute such an action. This is not covered in the design spec. || || - ||CREATE TRIGGER statement || [http://db.apache.org/derby/docs/dev/ref/rrefsqlj43125.html HTML URL] || Yip || The statement "You can create a trigger in any schema except one that starts with SYS." is no longer true when sql authorization is enabled. Also, under the syntax section, { INSERT | DELETE | UPDATE } [OF column-name [, column-name]* ] should be { INSERT | DELETE | UPDATE [ OF column-name [, column-name]* ] } || || + ||CREATE TRIGGER statement || [http://db.apache.org/derby/docs/dev/ref/rrefsqlj43125.html rrefsqlj43125.html] || Yip || The statement "You can create a trigger in any schema except one that starts with SYS." is no longer true when sql authorization is enabled. Also, under the syntax section, { INSERT | DELETE | UPDATE } [OF column-name [, column-name]* ] should be { INSERT | DELETE | UPDATE [ OF column-name [, column-name]* ] } || || - ||Built-in Functions || [http://db.apache.org/derby/docs/dev/ref/toc.html HTML URL] || Susan || The table of contents was edited to include the new Math Functions (see DERBY-1549) ACOS, ASIN, ATAN, etc. The word "function" was added to each of these functions in the toc, whereas the existing functions do not contain this word. For consistency it would be better if this word was removed. || || + ||Built-in Functions || [http://db.apache.org/derby/docs/dev/ref/toc.html ref/toc.html] || Susan || The table of contents was edited to include the new Math Functions (see DERBY-1549) ACOS, ASIN, ATAN, etc. The word "function" was added to each of these functions in the toc, whereas the existing functions do not contain this word. For consistency it would be better if this word was removed. || || - ||ATAN Function || [http://db.apache.org/derby/docs/dev/ref/rreffuncatan.html HTML URL] || Susan || According to DERBY-1548, Derby does not support negative zero, so this statement 'If the specified number is zero (0), the result of this function is zero with the same sign as the specified number. ' should be changed to this 'If the specified number is zero (0), the result of this function is zero.' || || + ||ATAN Function || [http://db.apache.org/derby/docs/dev/ref/rreffuncatan.html rreffuncatan.html] || Susan || According to DERBY-1548, Derby does not support negative zero, so this statement 'If the specified number is zero (0), the result of this function is zero with the same sign as the specified number. ' should be changed to this 'If the specified number is zero (0), the result of this function is zero.' || || - ||CEIL Function || [http://db.apache.org/derby/docs/dev/ref/rreffuncceil.html HTML URL] || Susan || According to DERBY-1548, Derby does not support negative zero, so this statement 'If the specified number is less than zero but greater than -1.0, then the result of these functions is negative zero.' should be changed to this 'If the specified number is less than zero but greater than -1.0, then the result of these functions is zero.' || || + ||CEIL Function || [http://db.apache.org/derby/docs/dev/ref/rreffuncceil.html rreffuncceil.html] || Susan || According to DERBY-1548, Derby does not support negative zero, so this statement 'If the specified number is less than zero but greater than -1.0, then the result of these functions is negative zero.' should be changed to this 'If the specified number is less than zero but greater than -1.0, then the result of these functions is zero.' || || - ||JDBC Escape Syntax - PI Function || [http://db.apache.org/derby/docs/dev/ref/rrefjdbc88908.html HTML URL] || Susan || I think this is a typo - 'Returns an value that is closer than any other value to pi.' I believe this is correct, 'Returns a value that is closer than any other value to pi.' || || + ||JDBC Escape Syntax - PI Function || [http://db.apache.org/derby/docs/dev/ref/rrefjdbc88908.html rrefjdbc88908.html] || Susan || I think this is a typo - 'Returns an value that is closer than any other value to pi.' I believe this is correct, 'Returns a value that is closer than any other value to pi.' || || - ||List of datatypes || http://db.apache.org/derby/docs/dev/ref/ || Dan D || In the list of data types the XML type is listed as 'XML data type', remove the words 'data type', all of the other types are listed just as the type name. Same is true of the page that describes the XML type, it says 'XML data type', other types just have the name of the type, e.g. BLOB || || + ||List of datatypes || [http://db.apache.org/derby/docs/dev/ref/ derv/ref]|| Dan D || In the list of data types the XML type is listed as 'XML data type', remove the words 'data type', all of the other types are listed just as the type name. Same is true of the page that describes the XML type, it says 'XML data type', other types just have the name of the type, e.g. BLOB || || - || XQUERY operator || docs/html/ref/rreffuncxmlquery.html || Dan D || This description: ''The result of the XMLQUERY operator is another Derby XML value. Unlike other XML values, the result might represent an empty sequence of XML nodes or values. Atomic values, such as strings, can be part of the result sequence. The result of an XMLQUERY operator is not guaranteed to represent a valid XML document and it might not be possible to insert the result of an XMLQUERY operator into a Derby XML column'' should be replaced with: The result of the XMLQUERY operator is '''a value of type XML'''. '''The result represents a''' sequence of XML nodes or values. Atomic values, such as strings, can be part of the result sequence. The result of an XMLQUERY operator is not guaranteed to represent a '''well formed''' XML document and it might not be possible to insert the result of an XMLQUERY operator into an XML column - Notes on the changes (bold), a) no need to use Derby b) The old word ing had the use of 'might' and 'empty sequence', I think it wanted to describe a sequence and the result is always a sequence, not that it might be. c) Use of 'well-formed' is better than 'valid'. || || + || XQUERY operator || [http://db.apache.org/derby/docs/dev/ref/rreffuncxmlquery.html rreffuncxmlquery.html] || Dan D || This description: ''The result of the XMLQUERY operator is another Derby XML value. Unlike other XML values, the result might represent an empty sequence of XML nodes or values. Atomic values, such as strings, can be part of the result sequence. The result of an XMLQUERY operator is not guaranteed to represent a valid XML document and it might not be possible to insert the result of an XMLQUERY operator into a Derby XML column'' should be replaced with: The result of the XMLQUERY operator is '''a value of type XML'''. '''The result represents a''' sequence of XML nodes or values. Atomic values, such as strings, can be part of the result sequence. The result of an XMLQUERY operator is not guaranteed to represent a '''well formed''' XML document and it might not be possible to insert the result of an XMLQUERY operator into an XML column - Notes on the chang es (bold), a) no need to use Derby b) The old wording had the use of 'might' and 'empty sequence', I think it wanted to describe a sequence and the result is always a sequence, not that it might be. c) Use of 'well-formed' is better than 'valid'. || || || Date function || [http://db.apache.org/derby/docs/dev/ref/rrefdatefunc.html ref/rrefdatefunc.html] || jta || The number listed in the description "a positive number less than or equal to 3,652,059" gets an error, the max number that works is 2,932,897 ([http://mail-archives.apache.org/mod_mbox/db-derby-dev/200608.mbox/%3c44F722C0.2060203@bristowhill.com%3e posted to derby-dev], added to [https://issues.apache.org/jira/browse/DERBY-1803 DERBY-1803]) || || || XML data type || [http://db.apache.org/derby/docs/dev/ref/rrefsqljtypexml.html rrefsqljtypexml.html] || Army || See following thread: [http://thread.gmane.org/gmane.comp.apache.db.derby.devel/28136/focus=28136 xmlTypeThread] || || || XML operators || [http://db.apache.org/derby/docs/dev/ref/rrefsqlj29026.html rrefsqlj29026.html] || Army || See following thread: [http://thread.gmane.org/gmane.comp.apache.db.derby.devel/28570/focus=28570 xmlOpsThread] || ||