db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Kristian Waagan <Kristian.Waa...@Sun.COM>
Subject Re: [jira] Updated: (DERBY-1659) Document describe and show tables functionality
Date Sun, 10 Sep 2006 22:07:35 GMT
Andrew McIntyre (JIRA) wrote:

>     [ http://issues.apache.org/jira/browse/DERBY-1659?page=all ]
>Andrew McIntyre updated DERBY-1659:
>    Attachment: derby-1659-andrew-1.diff
>I hadn't realized Kristian had offered to produce a patch for this, since when I checked
earlier today noone was assigned to the issue. So earlier today I started to put together
a patch for this issue based on David's HTML files. I cleaned up what I had done so that it
builds properly and am attaching the patch here in the hopes of preventing duplication of
effort in documenting this.
>I expanded and reorganized what David had suggested, but I'm not sure that this is really
ready to be committed. I put all of the syntax for SHOW into a single page, with examples
for each choice in the next part of the SHOW grammar. This would seem to be slightly at odds
with the way DITA organizes examples, which would have one <example> block with all
of the examples for the <reference> block for SHOW. 
>So, I'd really appreciate it if someone could help review and/or cleanup this patch and
make it ready for commit. I'm always happy to hear suggestions as to where to go from here.
/Hi Andrew,

I've been down with the flu, that's why I haven't submitted my patch.
I went for the other approach, with a "main page" for SHOW, and then 
subpages (another level) for the various show commands. It worked, but I 
did not know if people would like it, that's why I originally requested 
feedback on the approach (after I submitted the patch, which I never got 
around to do before you did).

Anyway, no need now, as another patch is already ready :)


>>Document describe and show tables functionality
>>                Key: DERBY-1659
>>                URL: http://issues.apache.org/jira/browse/DERBY-1659
>>            Project: Derby
>>         Issue Type: Sub-task
>>         Components: Documentation
>>           Reporter: David Van Couvering
>>            Fix For:
>>        Attachments: derby-1659-andrew-1-html.zip, derby-1659-andrew-1.diff, Describe.html,
ShowProcedures.html, ShowSchemas.html, ShowSynonyms.html, ShowTable.html, ShowViews.html
>>Need to add documentation for this new feature

View raw message