[3502] in java-interest
Re: declaration v.s. definition ambiguity
daemon@ATHENA.MIT.EDU (Gary Aitken)
Tue Nov 14 21:41:52 1995
Date: Tue, 14 Nov 1995 17:03:08 -0700
From: garya@village.org (Gary Aitken)
To: "R. Mark Volkmann"<m224873@svmstr01.mdc.com>
Cc: daconta@PrimeNet.Com, java-interest@java.sun.com
In-Reply-To: <199511141539.IAA24311@information-retrieval.village.org>
>>It would be really
>>nice if /** comments in the code could be preserved in the .class file (new
>>option for javac?), and output by javap. One could then program in a style
>>which allowed shipping a .class file from which javap could extract a
>>reliable, well documented api.
>
>I'm new to Java. Why would you want to use a /** comment instead of //?
>Does it do something different? How does /** differ from /*?
Comments starting with /** are specifically reserved for automatically
generated documentation. If you look at the source in
.../java/src/java/awt/*.java you will see examples of how it is used.
If you compare the text there with the html documentation for the same
function, you'll notice some similarities...
Gary Aitken garya@village.org
-
This message was sent to the java-interest mailing list
Info: send 'help' to java-interest-request@java.sun.com
