Path: csiph.com!x330-a1.tempe.blueboxinc.net!usenet.pasdenom.info!news.albasani.net!.POSTED!not-for-mail
From: Jan Burse <janburse@fastmail.fm>
Newsgroups: comp.lang.java.programmer
Subject: Re: StringBuilder
Date: Sun, 18 Sep 2011 22:29:13 +0200
Organization: albasani.net
Lines: 31
Message-ID: <j55kaq$bi8$1@news.albasani.net>
References: <96f358c8-a024-40db-b60b-300186c2f813@o10g2000vby.googlegroups.com> <j41fik$3qb$1@news.albasani.net> <j52jgd$iij$1@dont-email.me> <vp7a77lp3e5oe4h79pnmv95vb4lu13spmc@4ax.com> <GeednbWNqODBGOjTnZ2dnUVZ_rqdnZ2d@posted.palinacquisition> <j54nc9$tgk$1@dont-email.me> <j54rss$j3q$1@news.albasani.net> <j54svs$u9u$1@dont-email.me> <j55jcp$9im$1@news.albasani.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=UTF-8; format=flowed
Content-Transfer-Encoding: 7bit
X-Trace: news.albasani.net HkZRHHtEdQ+HW4WqVsQW4ZLItGYn+kK1WhiidHctNrmQHEfeXbP2W6q9KCk24I1nQwtILd2xvCEhrPz1c+qxh4Zw1IuLUo3XuJcz9WRqMCpXRXhV4ofmnQklNgAla3td
NNTP-Posting-Date: Sun, 18 Sep 2011 20:29:14 +0000 (UTC)
Injection-Info: news.albasani.net; logging-data="6AmgVTPqyHybH6RPxG4EcJbR4CcZHbzmRK+QBcew4ywMLdiS+hbWkBaFZnjiKV+F5Af2IWiASGGDPuRR0Rp+tEwFZuk/RhPlQAEnZBjudVqRTcShhNul5FM/fDHd850T"; mail-complaints-to="abuse@albasani.net"
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10.6; rv:6.0.2) Gecko/20110902 Firefox/6.0.2 SeaMonkey/2.3.3
In-Reply-To: <j55jcp$9im$1@news.albasani.net>
Cancel-Lock: sha1:p5mZYCayP9DK9ipStONAPcYz5D0=
Xref: x330-a1.tempe.blueboxinc.net comp.lang.java.programmer:8143

Jan Burse schrieb:
> The implementation advice comment was removed in 1.5 javadoc.
> It was still present in 1.4.1 javadoc:

But I don't see the AbstractStringBuilder in the Oracle javadoc,
maybe  it is filtered out since it is package local(*). Or the class
is specific to OpenJDK, not sure. Slowly getting confused, not
feeling comfortable starting a dozen of different machines to
check the JDK installation... Dammned, isn't there a website
where we see such things side by side?

But StringBuilder has a @since 1.5 tag, so this is the earliest
moment for this class to look for a javadoc.

Bye

P.S.: It really seems that it is filtered out, David Flanagan
was confronted with it:

	This is the first instance that I am aware of of
	a public class extending a non-public one, and it
	raises questions about documenting the public one.
	The javadoc team dealt with it by simply pretending
	that the non-public intermediary class does not
	exist. Now I have to figure out how to document
	this for Java in a Nutshell.

	http://www.davidflanagan.com/2004/10/abstractstringbuilder.html