Agreed. It should suffice to put a link in the modules xdocs back to the original api docs.

--jason


On Thursday, August 21, 2003, at 04:17 AM, Cabrera, Alan wrote:

Is it a good idea to put JavaDocs in our API code? For mx4j, the JMX specs
group suggested that we don't put comments into our clean-room API code so,
we didn't. The idea being that there should be a single source for the spec
and JavaDocs, this being www.jcp.org. I see their point but do not feel
strongly about it.



Regards, Alan

-----Original Message-----
From: Aaron Mulder [mailto:[EMAIL PROTECTED]
Sent: Wednesday, August 20, 2003 6:37 PM
To: [EMAIL PROTECTED]
Subject: [PATCH] [JSR-88] JavaDoc


I've started adding the JavaDoc to the JSR-88 spec tree. Here are the first couple packages; the ones we're currently implementing. It's based on the Sun JavaDoc, but with lots of typos fixed and a couple clarifications.

Aaron

(Hopefully this URL will work!)

http://jira.codehaus.org/secure/ViewIssue.jspa?key=GERONIMO-3


---------------------------------------------------------------- Visit our Internet site at http://www.reuters.com

Get closer to the financial markets with Reuters Messaging - for more
information and to register, visit <http://www.reuters.com/messaging>

Any views expressed in this message are those of the individual sender,
except where the sender specifically states them to be the views of The
Reuters Group.





Reply via email to