[jira] [Updated] (DERBY-6552) The public api includes methods inherited from superclasses which aren't in the public api and so have no javadoc comments

["Dag H. Wanvik (JIRA)" <ji...@apache.org>]

     [ https://issues.apache.org/jira/browse/DERBY-6552?page=com.atlassian.jira.plugin.system.issuetabpanels:all-tabpanel ]

Dag H. Wanvik updated DERBY-6552:
---------------------------------

    Attachment: derby-6552-exp.status
                derby-6552-exp.diff

Uploading a patch (passed regressions), which:
- adds wrappers so that the exposed classes have the expected methods and constants.
- changes the doc build for publishedapi so that we have a "sourcepath" for Javadoc which contains all the sources. This is necessary to make the wrappers inherit the (common for Basic* and regular data sources) javadoc from a class that is otherwise not in the API.
- added reference "link"s to official Java Javadocs for ease of reading (SE: 8, J2EE: 7)


> The public api includes methods inherited from superclasses which aren't in the public api and so have no javadoc comments
> --------------------------------------------------------------------------------------------------------------------------
>
>                 Key: DERBY-6552
>                 URL: https://issues.apache.org/jira/browse/DERBY-6552
>             Project: Derby
>          Issue Type: Bug
>          Components: Javadoc
>    Affects Versions: 10.11.0.0
>            Reporter: Rick Hillegas
>            Assignee: Dag H. Wanvik
>         Attachments: derby-6552-exp.diff, derby-6552-exp.status
>
>
> We simplified and cleaned up the public api in 10.11. Now, however, we've lost the javadoc for methods which customers may need to use. For instance, ClientDataSource contains a method called setSsl() which is inherited from ClientBaseDataSourceRoot. But since ClientBaseDataSourceRoot doesn't appear in the public api, there's no method header comment to consult.



--
This message was sent by Atlassian JIRA
(v6.2#6252)