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

Groups > comp.lang.java.programmer > #20643 > unrolled thread

Re: Designation of a non-static method

Back to article view | Back to comp.lang.java.programmer

This discussion starts older than the indexed window; earlier articles aren't shown. The article labeled Started by below is the oldest one visible, not the original post.

Contents

  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

#20643 — Re: Designation of a non-static method

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

[toc] | [next] | [standalone]

#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

[toc] | [prev] | [standalone]

Back to top | Article view | comp.lang.java.programmer

csiph-web