[ 
https://issues.apache.org/jira/browse/DERBY-6980?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16694957#comment-16694957
 ] 

Rick Hillegas commented on DERBY-6980:
--------------------------------------

Attaching derby-6980-09-aa-removeGibberishAboutGetPropertyInfo.diff and the 
corresponding tarball of generated output: 
derby-6980-09-aa-removeGibberishAboutGetPropertyInfo.tar. This patch removes 
some gibberish about Derby's implementation of java.sql.getPropertyInfo().

I wrote a program to test the claims made about how getPropertyInfo() can be 
used to get a list of booted databases. I could not get such a list by 
following the instructions in the Developer's Guide and the Reference Manual. 
There does not appear to be a regression test to verify these instructions. It 
may be that the instructions once worked. But I can't make sense of them now. 
We can re-write this material and reinstate it if someone can figure out how to 
coax this information out of getPropertyInfo(). But for the moment, I think 
that it is best to scrub this frustrating gibberish from the docs.

Touches the following files:

{noformat}
M       src/devguide/cdevadvjdbc41138.dita
M       src/devguide/cdevdvlp42173.dita
M       src/ref/rrefjdbc34954.dita
{noformat}


> Documentation changes to accompany jigsaw-modularization of derby
> -----------------------------------------------------------------
>
>                 Key: DERBY-6980
>                 URL: https://issues.apache.org/jira/browse/DERBY-6980
>             Project: Derby
>          Issue Type: Task
>          Components: Documentation
>    Affects Versions: 10.15.0.0
>            Reporter: Rick Hillegas
>            Assignee: Rick Hillegas
>            Priority: Major
>         Attachments: derby-6980-01-aa-moduleDiagramsInJavadoc.diff, 
> derby-6980-02-aa-addOverviewPageToInternalJavadoc.diff, 
> derby-6980-03-aa-securityPolicies.diff, 
> derby-6980-03-aa-securityPolicies.tar, 
> derby-6980-04-aa-updateDocsVariables.diff, derby-6980-05-aa-miscCleanup.diff, 
> derby-6980-05-aa-miscCleanup.tar, 
> derby-6980-06-aa-updateMinimumJDK-inDocs.diff, 
> derby-6980-07-aa-gettingStartedGuide.diff, 
> derby-6980-07-aa-gettingStartedGuide.tar, 
> derby-6980-08-aa-referenceGuide.diff, derby-6980-08-aa-referenceGuide.tar, 
> derby-6980-09-aa-removeGibberishAboutGetPropertyInfo.diff, 
> derby-6980-09-aa-removeGibberishAboutGetPropertyInfo.tar
>
>
> This is a place to collect the documentation changes which must be made as a 
> result of the work on DERBY-6945.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)

Reply via email to