Path: csiph.com!usenet.pasdenom.info!news.albasani.net!.POSTED!not-for-mail
From: Jan Burse <janburse@fastmail.fm>
Newsgroups: comp.lang.java.programmer
Subject: Re: Designation of a non-static method
Date: Thu, 20 Dec 2012 22:33:56 +0100
Organization: albasani.net
Lines: 49
Message-ID: <kb0080$2td$1@news.albasani.net>
References: <nextDouble-20121220200056@ram.dialup.fu-berlin.de> <kavv4t$g6$1@news.albasani.net>
Mime-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1; format=flowed
Content-Transfer-Encoding: 8bit
X-Trace: news.albasani.net hWyVGWVhSyE18Rs6h0odXnZhXz51d2K08UtsAiCnH0Ye/iuk0eMA83K5MWaVLIqxM21N7oKU6wSqUmJKu6L5aQ==
NNTP-Posting-Date: Thu, 20 Dec 2012 21:33:52 +0000 (UTC)
Injection-Info: news.albasani.net; logging-data="Nj+SX5y4Ov5h+YHVvWwU5IIPpBcMgi8OB9TXnsnsTSGzVl57bzyvOHsWrJ5EbVXq1dnR+cEY7gn/3aL2tEx38B+nHbUQbSWC3+0cwfe0nzeWFNnMt1tRB3mjRRyODiZq"; mail-complaints-to="abuse@albasani.net"
User-Agent: Mozilla/5.0 (Windows NT 6.1; WOW64; rv:17.0) Gecko/20100101 Firefox/17.0 SeaMonkey/2.14.1
In-Reply-To: <kavv4t$g6$1@news.albasani.net>
Cancel-Lock: sha1:o1fZR37lnSXp57AvfmZP9wX7Ad0=
Xref: csiph.com comp.lang.java.programmer:20644

Hi,

For a java comment {@link Integer#MIN_VALUE} you also see
magically morph the hash (#) into a period (.).

This is all done by javadoc. The source of javadoc is open.
For example the see tag is defined here:

http://javasourcecode.org/html/open-source/jdk/jdk-6u23/com/sun/tools/javadoc/SeeTagImpl.java.html

The syntax of a @see tag is:

     <where>#<what>

Whereby <where> is resolved into a ClassDoc or PackageDoc
and <what> is resolved into a MemberDoc.

Bye

Jan Burse schrieb:
> Stefan Ram schrieb:
>>    I used to think that it was common usage to use »C.f()« for
>>    a static method »f()« and »C#f()« for a non-static method
>>    »f()« of a class »C«.
>>  [Snip]
>
> I find in the Java source code:
>
>       * @see Random#nextDouble()
>
> I find in the HTML source code:
>
>       <a
> href="../../java/util/Random.html#nextDouble()"><code>Random.nextDouble()</code></a>
>
>
> I guess the HTML doc was generated via a doclet. The doclet
> that was used for JDK 1.4 did already do the same transformation
> of Java source code, into Java HTML javadoc. You can check for yourself:
>
> http://docs.oracle.com/javase/1.4.2/docs/api/java/lang/Math.html#random%28%29
>
>
> This has not changed since then for JDK 1.7:
>
> http://docs.oracle.com/javase/7/docs/api/java/lang/Math.html#random%28%29
>
> Bye