From mboxrd@z Thu Jan 1 00:00:00 1970 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me X-Spam-Level: X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham autolearn_force=no version=3.4.4 X-Google-Language: ENGLISH,ASCII-7-bit X-Google-Thread: 103376,5b3c19b1631bb558 X-Google-Attributes: gid103376,public X-Google-ArrivalTime: 2000-11-01 15:47:36 PST Path: supernews.google.com!sn-xit-02!sn-xit-03!supernews.com!europa.netcrusader.net!152.163.239.129!portc01.blue.aol.com!wn4feed!worldnet.att.net!135.173.83.19!wnmasters2!bgtnsc05-news.ops.worldnet.att.net.POSTED!not-for-mail Message-ID: <3A00ABEE.C563EBBA@worldnet.att.net> From: James Rogers X-Mailer: Mozilla 4.75 [en] (Win98; U) X-Accept-Language: en MIME-Version: 1.0 Newsgroups: comp.lang.ada Subject: Re: The best thing/greatest feature summary References: <39DCB9E3.EAE8F426@ftw.rsc.raytheon.com> <39F9FCCE.D6719C6F@ftw.rsc.raytheon.com> <1c9kvs4uvj4ofd46f7a8vq0pju596iu2gr@4ax.com> <39fed7b6@rsl2.rslnet.net> <39FF1DBD.74184FDC@worldnet.att.net> <39ff792d@rsl2.rslnet.net> <39FF8DE3.EC0055B5@worldnet.att.net> <3A00375E.19433DC0@worldnet.att.net> <3a00924a$1@rsl2.rslnet.net> <1b1M5.747$0M1.56645@nnrp3.sbc.net> Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Date: Wed, 01 Nov 2000 23:47:35 GMT NNTP-Posting-Host: 12.74.130.63 X-Complaints-To: abuse@worldnet.att.net X-Trace: bgtnsc05-news.ops.worldnet.att.net 973122455 12.74.130.63 (Wed, 01 Nov 2000 23:47:35 GMT) NNTP-Posting-Date: Wed, 01 Nov 2000 23:47:35 GMT Organization: AT&T Worldnet Xref: supernews.google.com comp.lang.ada:1697 Date: 2000-11-01T23:47:35+00:00 List-Id: Pat Rogers wrote: > > As a proponent of Ada and a friend of Java, let me say that IMHO it is > not the ease of use of the Java predefined environment that makes > people happy. (I assume you mean both that and the APIs that are > continually being added.) The language itself is rather underpowered; > hence the environment and the APIs are less than they could otherwise > be. Rather, it is the *extent* of these APIs that makes the > difference. > I have to agree with Pat here. The language defined one other feature supporting a large and evolving list of APIs. That is the Javadoc tool. This tool allows decent (not great) documentation of Java APIs in a consistent HTML format from comments in the Java code. It turns out that a large list of APIs is useless without the corresponding documentation. The feature most often missing from Javadoc documents is usage examples. On the other hand, the documentation is complete enough for any Java-knowledgable programmer to use without significant usage examples. Jim Rogers Colorado Springs, Colorado