[ http://issues.apache.org/jira/browse/DERBY-310?page=comments#action_12313949 ]
David Van Couvering commented on DERBY-310: ------------------------------------------- Sorry I didn't respond sooner.. JACK SAID In regards to a separate section, this document has been placed as a subsection to a larger section called "Differences between running Derby in embedded mode and using the network server." There are other subsections to that main section that talk about other differences that dont have to do with updatable result sets. So I'm not sure what you mean by it should have its own section. Take a look at that area of the Server Admin Guide as it exists now: http://incubator.apache.org/derby/docs/adminguide/cadminapps.html MY RESPONSE: OK, I didn't know that JACK SAID - Of the other items linked to this issue, both were unsettled. I wanted to at least get the differences about updatable result sets into the docs. MY RESPONSE OK, I thought this was *the* place where differences were documented JACK SAID - I agree that we should say something about not every difference has been identified and that there could be more. Perhaps I should add that to the "Differences between running Derby in embedded mode and using the network server" page instead of this updatable result sets differences page, since it should be a broader statement than this one subsection. I'll make a new patch. Thanks! MY RESPONSE Great, sounds good JACK SAID - If Kathy has input on XA differences, I'd be happy to doc those too. Again, if it comes down to a timing issue in terms of whether we get some or none of these documented in 10.1, I think it would be better to at least have added what we have than nothing at all. MY RESPONSE ok JACK SAID - I think the formatting issues have to do with the fact that we don't have a css file to format our output to look nicer. Perhaps we can open a JIRA issue as an improvement and someone could write one or find one we can use. Such formatting issues as making the titles of tables bold could easily be accomplished with a good css file. I'd be happy to look into whether the DITA toolkit has some sort of option that we can specify to put css specifications directly into the files during transform. I honestly haven't worked too much with them to know the details, but I'm sure that is how its done. I'm not optimistic that we could have something together before 10.1 though. MY RESPONSE Hm. I am uncomfortable going out with the release when the HTML is so clunky. I don't know how hard it is to set up a css file, but it seems like if we're trying to get people interested in using Derby, having docs that look funky does not send out a good message to interested but hesitant new users. JACK SAID - I'll fix the header as you suggested with my new patch. MY RESPONSE ok, great I'll hold off on the patch for awhile to see if anyone has any other comments, suggestions, or requests due to some of the issues David has raised. Thanks again for the feedback! > Document and/or change Derby client code to match behavior with Embedded > driver where possible. > ----------------------------------------------------------------------------------------------- > > Key: DERBY-310 > URL: http://issues.apache.org/jira/browse/DERBY-310 > Project: Derby > Type: Bug > Components: Documentation, JDBC > Versions: 10.1.1.0 > Reporter: Satheesh Bandaram > Priority: Minor > > There are some behavior differences between Derby client and embedded JDBC > drivers. Change Derby client code to match embedded behavior or document some > of these differences. > This JIRA entry is a top level task for tracking these issues. Individual > subtasks should be created or existing tasks linked to this Jira entry, but > no specific feature content added here. Please create subtaks to this Jira > entry to track any known differences documentation issues or tasks needed to > investigate this issue. > Kathey Marsden also started this effort to compile known > differences.(http://mail-archives.apache.org/mod_mbox/db-derby-dev/200505.mbox/[EMAIL > PROTECTED]) > The Derby community voted that client should match embedded where possible. > See: > http://mail-archives.apache.org/mod_mbox/db-derby-dev/200505.mbox/[EMAIL > PROTECTED] -- 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
