[
https://issues.apache.org/jira/browse/DERBY-6552?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=14036008#comment-14036008
]
ASF subversion and git services commented on DERBY-6552:
--------------------------------------------------------
Commit 1603549 from [~dagw] in branch 'code/trunk'
[ https://svn.apache.org/r1603549 ]
DERBY-6552 The public api includes methods inherited from superclasses which
aren't in the public api and so have no javadoc comments
Patch derby-6552-only-public-members.
Changes the way we generate public API javadocs by restricting it to
public class members.
Adds back Javadocs for private, class private and protected members
removed before.
Added some missing Javadocs.
Moved the top level class javadocs that were nto visible (root
classes) down to the first level visible data sources, so we can get
the data source properties documented for embedded. Added this for
client. Cf. BasicEmbeddedDataSource40 and BasicClientDataSource40
respectively.
Added missing @serial tags
> 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, JDBC
> Affects Versions: 10.11.0.0
> Reporter: Rick Hillegas
> Assignee: Dag H. Wanvik
> Attachments: derby-6552-exp.diff, derby-6552-exp.status,
> derby-6552-link-fixes.diff, derby-6552-only-public-members.diff,
> derby-6552-restructure-even-more.diff, derby-6552-restructure-more.diff
>
>
> 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)
