From: Ken Wesson <kwesson@gmail.com>
Subject: Re: JLS 3/e -- Lots Of Errors
Newsgroups: comp.lang.java.programmer
References: <iiflvc$keg$2@lust.ihug.co.nz> <iijg0g$rrc$4@lust.ihug.co.nz> <iijnm4$d5j$1@news.albasani.net> <iil265$ob4$2@lust.ihug.co.nz> <iil5i6$10m$2@news.eternal-september.org> <iini4a$75r$3@lust.ihug.co.nz> <4d4f5275$0$23761$14726298@news.sunsite.dk>
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
NNTP-Posting-Host: $$-cwgml$lsc2q.news.x-privat.org
Message-ID: <4d4f66a1$1@news.x-privat.org>
Date: 7 Feb 2011 04:27:29 +0100
Organization: X-Privat.Org NNTP Server - http://www.x-privat.org
Lines: 37
X-Authenticated-User: $$o-16a0wpsuhxkoyemw
X-Complaints-To: abuse@x-privat.org
Path: csiph.com!eeepc.pasdenom.info!news.pasdenom.info!news.dougwise.org!gegeweb.org!newsfeed.x-privat.org!x-privat.org!not-for-mail
Xref: csiph.com comp.lang.java.programmer:25897

On Sun, 06 Feb 2011 21:01:32 -0500, Arne Vajhøj wrote:

> On 06-02-2011 20:32, Lawrence D'Oliveiro wrote:
>> In message<iil5i6$10m$2@news.eternal-september.org>, Joshua Cranmer
>> wrote:
>>> On 02/05/2011 09:48 PM, Lawrence D'Oliveiro wrote:
>>>> In message<iijnm4$d5j$1@news.albasani.net>, Lew wrote:
>>>>> On 02/05/2011 07:32 AM, Lawrence D'Oliveiro wrote:
>>>>>> * Section 5.1.8, page 88: no mention of what happens when you unbox
>>>>>> a NaN (the previous page said only that the boxed object had
>>>>>> isNaN() evaluating to true, no mention of what floatValue() or
>>>>>> doubleValue() might return).
>>>>>
>>>>> Nor is such a mention required, therefore its omission is not an
>>>>> error. However, it's pretty clear that if 'isNan()' is true, then
>>>>> 'doubleValue()' must return 'Double.NaN'.
>>>>
>>>> No it is not. The spec carefully refrains from mentioning what
>>>> floatValue() and doubleValue() return.
>>>
>>> Why should it mention it? That is what the documentation on the
>>> respective classes in the Java Standard API is for.
>>
>> If that’s the case, there should be a reference to where it’s properly
>> defined.
> 
> Why?
> 
> People that read the JLS should have read the Java API

What, the whole thing? It's tens of megabytes of text. The Encyclopedia 
Brittanica is a shorter English-language work.

The commonly encountered classes in java.lang and java.util and java.io, 
yes, though. String, System, the boxed primitive classes, StringBuilder, 
Iterator, Set, Map, List, HashFoo, ArrayList, InputStream, OutputStream, 
Reader, Writer, and File; and Exception; at the very least.