Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.java.programmer > #20644

Re: Designation of a non-static method

Show all headers | View raw

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

Back to comp.lang.java.programmer | Previous | Next — Previous in thread | Find similar | Unroll thread

Thread

Re: Designation of a non-static method Jan Burse <janburse@fastmail.fm> - 2012-12-20 22:15 +0100
  Re: Designation of a non-static method Jan Burse <janburse@fastmail.fm> - 2012-12-20 22:33 +0100

csiph-web