Return-Path: X-Original-To: apmail-db-derby-dev-archive@www.apache.org Delivered-To: apmail-db-derby-dev-archive@www.apache.org Received: from mail.apache.org (hermes.apache.org [140.211.11.3]) by minotaur.apache.org (Postfix) with SMTP id 4E640115C7 for ; Mon, 16 Jun 2014 19:45:04 +0000 (UTC) Received: (qmail 47715 invoked by uid 500); 16 Jun 2014 19:45:04 -0000 Delivered-To: apmail-db-derby-dev-archive@db.apache.org Received: (qmail 47687 invoked by uid 500); 16 Jun 2014 19:45:04 -0000 Mailing-List: contact derby-dev-help@db.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: Delivered-To: mailing list derby-dev@db.apache.org Received: (qmail 47356 invoked by uid 99); 16 Jun 2014 19:45:03 -0000 Received: from arcas.apache.org (HELO arcas.apache.org) (140.211.11.28) by apache.org (qpsmtpd/0.29) with ESMTP; Mon, 16 Jun 2014 19:45:03 +0000 Date: Mon, 16 Jun 2014 19:45:03 +0000 (UTC) From: "Dag H. Wanvik (JIRA)" To: derby-dev@db.apache.org Message-ID: In-Reply-To: References: Subject: [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 MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 7bit X-JIRA-FingerPrint: 30527f35849b9dde25b450d4833f0394 [ 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-restructure-even-more.diff Here is a further simplification along the lines requested by Knut. It eliminates EmbeddedBaseDataSource. Removed a slew of warnings in the IDE also by some code washing, and regenerated the 10.11 serialized data sources for the SerializedDataSourceTest. I removed some Javadoc from non-public members in the API classes, and replaced them with end-of-line comments instead (to avoid user confusion). Running regressions. > 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-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)