[800] in java-interest
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