Return-Path: Delivered-To: apmail-commons-user-archive@www.apache.org Received: (qmail 32042 invoked from network); 7 Oct 2009 17:55:11 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 7 Oct 2009 17:55:11 -0000 Received: (qmail 20930 invoked by uid 500); 7 Oct 2009 17:55:10 -0000 Delivered-To: apmail-commons-user-archive@commons.apache.org Received: (qmail 20823 invoked by uid 500); 7 Oct 2009 17:55:10 -0000 Mailing-List: contact user-help@commons.apache.org; run by ezmlm Precedence: bulk List-Help: List-Unsubscribe: List-Post: List-Id: Reply-To: "Commons Users List" Delivered-To: mailing list user@commons.apache.org Received: (qmail 20813 invoked by uid 99); 7 Oct 2009 17:55:09 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Oct 2009 17:55:09 +0000 X-ASF-Spam-Status: No, hits=-0.0 required=10.0 tests=SPF_PASS X-Spam-Check-By: apache.org Received-SPF: pass (nike.apache.org: domain of agrimes@speakeasy.net designates 69.17.117.7 as permitted sender) Received: from [69.17.117.7] (HELO mail5.sea5.speakeasy.net) (69.17.117.7) by apache.org (qpsmtpd/0.29) with ESMTP; Wed, 07 Oct 2009 17:54:58 +0000 Received: (qmail 2782 invoked from network); 7 Oct 2009 17:54:36 -0000 Received: from dsl092-168-049.wdc2.dsl.speakeasy.net (HELO [10.0.0.2]) ([66.92.168.49]) (envelope-sender ) by mail5.sea5.speakeasy.net (qmail-ldap-1.03) with AES256-SHA encrypted SMTP for ; 7 Oct 2009 17:54:36 -0000 Message-ID: <4ACCD596.3050809@speakeasy.net> Date: Wed, 07 Oct 2009 13:53:26 -0400 From: Alan Grimes User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.8.1.23) Gecko/20090925 SeaMonkey/1.1.18 MIME-Version: 1.0 To: Commons Users List Subject: Inherent problem with Java classes. References: <4ACB67CE.10303@speakeasy.net> <4ACB6C76.9000007@speakeasy.net> <4ACB77E0.60407@yale.edu> In-Reply-To: <4ACB77E0.60407@yale.edu> Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit X-Virus-Checked: Checked by ClamAV on apache.org There's an inherent problem with all classes and class packages of all languages. Basically when you package up a bundle of classes there are few clues for a novice to determine which classes are for internal use only and which are the primary front end of the API. Similarly, when there are dozens of non-depreciated methods in a class, it becomes difficult for a novice to determine which are the critical calls that every application will inevitably use and which are there just to handle corner cases or special applications. This is why I had trouble finding the call for dowloading a file in the FTP system. Javadoc is wonderful. It certainly does help when one needs a refference. The VFS package seems to be closer to what I actually need, but at the same time it's much more complex. This is why HowTos and other tutorials are vitally important for all non-trivial packages, especially packages for use as libraries. =( Do you know where I can find useful getting started guides for VFS? -- New president: Here we go again... Chemistry.com: A total rip-off. Powers are not rights. --------------------------------------------------------------------- To unsubscribe, e-mail: user-unsubscribe@commons.apache.org For additional commands, e-mail: user-help@commons.apache.org