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 :)
Regards,
--
Kristian
/
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: 10.2.1.0
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
