Return-Path: Delivered-To: apmail-beehive-dev-archive@www.apache.org Received: (qmail 71777 invoked from network); 28 Aug 2005 21:05:06 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (209.237.227.199) by minotaur.apache.org with SMTP; 28 Aug 2005 21:05:06 -0000 Received: (qmail 50033 invoked by uid 500); 28 Aug 2005 21:05:05 -0000 Delivered-To: apmail-beehive-dev-archive@beehive.apache.org Received: (qmail 50016 invoked by uid 500); 28 Aug 2005 21:05:05 -0000 Mailing-List: contact dev-help@beehive.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Beehive Developers" Delivered-To: mailing list dev@beehive.apache.org Received: (qmail 50003 invoked by uid 99); 28 Aug 2005 21:05:05 -0000 Received: from asf.osuosl.org (HELO asf.osuosl.org) (140.211.166.49) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 28 Aug 2005 14:05:05 -0700 X-ASF-Spam-Status: No, hits=0.0 required=10.0 tests=RCVD_BY_IP,SPF_HELO_PASS,SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (asf.osuosl.org: domain of richfeit@gmail.com designates 64.233.184.194 as permitted sender) Received: from [64.233.184.194] (HELO wproxy.gmail.com) (64.233.184.194) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 28 Aug 2005 14:05:21 -0700 Received: by wproxy.gmail.com with SMTP id i25so818018wra for ; Sun, 28 Aug 2005 14:05:03 -0700 (PDT) DomainKey-Signature: a=rsa-sha1; q=dns; c=nofws; s=beta; d=gmail.com; h=received:message-id:date:from:user-agent:x-accept-language:mime-version:to:subject:references:in-reply-to:x-enigmail-version:x-enigmail-supports:content-type:content-transfer-encoding; b=LkyE22Ip83fucW/IDoSqORYtp5kbtRUfrnxyhZ4qTzJ5JOeMWXuo8Dz+BKWCfjDs8w/1UrPjFHLxvfGKHUOkhrQ/4qWguGCx7WeeVWWuONY1b8Aj/1reMGBx6SU0h59jripIIoA6pHdl1sSY6G3CY07eooaQaU+zAVjJZaPep3Y= Received: by 10.54.153.10 with SMTP id a10mr5572954wre; Sun, 28 Aug 2005 14:05:03 -0700 (PDT) Received: from ?172.24.28.35? ( [63.96.173.242]) by mx.gmail.com with ESMTP id 66sm5988580wra.2005.08.28.14.05.02; Sun, 28 Aug 2005 14:05:03 -0700 (PDT) Message-ID: <431226FD.8020305@gmail.com> Date: Sun, 28 Aug 2005 15:05:01 -0600 From: Rich Feit User-Agent: Mozilla Thunderbird 1.0.6 (Windows/20050716) X-Accept-Language: en-us, en MIME-Version: 1.0 To: Beehive Developers Subject: Re: NetUI Javadoc issues References: In-Reply-To: X-Enigmail-Version: 0.90.0.0 X-Enigmail-Supports: pgp-inline, pgp-mime Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked by ClamAV on apache.org X-Spam-Rating: minotaur.apache.org 1.6.2 0/1000/N I totally agree about excluding JavaDoc for "internal" packages. Nice catch. I'm happy to do this if you haven't done it locally already. Rich Eddie O'Neil wrote: > In looking through the NetUI Javadoc, I've found a few things that >need to be fixed before 1.0. These include: > >- the netui/src/core package isn't being Javadoc'ed >- the Javadoc is labeled in the title as "Page Flow API" rather than "NetUI API" >- the Controls / WSM / system control Javadoc page titles are >inconsistent with the NetUI ones. Will make all of them say something >like "Beehive xyz API Documentation" >- the Javadoc window titles don't include the version number > >In NetUI, we are also Javadoc'ing **/internal/** packages, which means >that things we've (to date) considered non-public APIs are being >doc'ed along with the rest of the public API. Rich, you've had >thoughts on this before -- maybe we should remove them if we consider >them "internal" APIs. > > Should have this changes in the list above checked in momentarily. > > Thoughts on the **/internal/** Javadoc? > >Eddie > > >