db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "David Van Couvering (JIRA)" <derby-...@db.apache.org>
Subject [jira] Commented: (DERBY-1655) Document XML functionality for 10.2
Date Thu, 10 Aug 2006 15:42:14 GMT
    [ http://issues.apache.org/jira/browse/DERBY-1655?page=comments#action_12427252 ] 
David Van Couvering commented on DERBY-1655:

Hi, I've read the docs and I have a couple of comments.  Since I'm a complete newbie to SQL/XML
hopefully these comments are valid for other new users...

- As I mentioned in a separate email, it was not clear to me that if I'm running with a 1.4
VM I most likely already have an XML parser in my classpath.  I'd like to see that clarified.

- You refer to the SQL standard for the XML operators/commands, but the majority of users
do not have access to these standards; they require payment and are not available on the web.
 I think we need to assume that users should be able to use our documents as the sole point
of reference for how to use our product.  The documentation so far provides some very high-level
descriptoin of what you use XMLSERIALIZE and XMLPARSE for (although it is not at all clear
what the required input/expected output and syntax is for these operations), and there is
no guidance whatsoever for XMLQUERY and XMLEXISTS.  I was thinking of writing some tests,
but wouldn't know how to do it (unless I were to go and get the SQL standard and slog through

I would like to see the syntax for these commands, as well as some examples.  In my ideal
world I would also love to see some sample programs.

That is not to say that what is provided in the current patch should not be checked in, I
think it's a good start.  I just really want to see more.



> Document XML functionality for 10.2
> -----------------------------------
>                 Key: DERBY-1655
>                 URL: http://issues.apache.org/jira/browse/DERBY-1655
>             Project: Derby
>          Issue Type: Task
>          Components: Documentation
>    Affects Versions:
>            Reporter: A B
>         Assigned To: Laura Stewart
>             Fix For:
>         Attachments: DerbyXMLDoc_v1.html
> DERBY-334 and DERBY-688 have added an XML datatype and four XML operators to Derby. 
These are all going to be exposed to the user for general use as part of the 10.2. release,
so the datatype and operators need to be documented accordingly.

This message is automatically generated by JIRA.
If you think it was sent incorrectly contact one of the administrators: http://issues.apache.org/jira/secure/Administrators.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira


View raw message