[ 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 it). 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. Thanks! David > 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: 10.2.0.0 > Reporter: A B > Assigned To: Laura Stewart > Fix For: 10.2.0.0 > > 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
