[800] in java-interest

home help back first fref pref prev next nref lref last post

Re: /** method must be there, or type expected error

daemon@ATHENA.MIT.EDU (larrys@zk3.dec.com)
Thu Jul 20 12:22:17 1995

From: larrys@zk3.dec.com
To: li@deming.Jpl.Nasa.Gov (Tientien Li)
Cc: java-interest@java.sun.com
In-Reply-To: Your message of "Wed, 19 Jul 95 21:15:27 PDT."
             <9507200415.AA06626@deming.> 
Date: Thu, 20 Jul 95 10:59:55 -0400


>2.1 Comments
>
>The Java language has three styles of comments:
>
>// text 
>     All characters from // to the end of the line are ignored. 
>/* text */ 
>     All characters from /* to */ are ignored. 
>/** text */ 
>     These comments are treated specially when they occur immediately
>     before any declaration.  They should not be used any other place
>     in the code. These comments indicate that the enclosed text should
>     be included in automatically generated documentation as a description
>     of the declared item.

/********************************************************
 *  Given the prevalence of this commenting convention  *
 *  in C and C++ code, this may have been a really,     *
 *  really poor choice, and it might be a really good   *
 *  idea to fix it while this is still a relatively     *
 *  small search-and-replace problem in java source.    *
 ********************************************************/

Would it not be reasonable to have a general compiler pragma
facility handle this problem?

regards,
Larry Smith
-
Note to Sun employees: this is an EXTERNAL mailing list!
Info: send 'help' to java-interest-request@java.sun.com

home help back first fref pref prev next nref lref last post