geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Dain Sundstrom <d...@iq80.com>
Subject Re: specs and javadoc question
Date Fri, 03 Mar 2006 17:43:55 GMT
On Mar 3, 2006, at 9:37 AM, David Jencks wrote:

> On Mar 3, 2006, at 9:10 AM, Bill Dudney wrote:
>
>> Hi All,
>>
>> I've started getting ready for JSF 1.2 and figured that a good  
>> place for the api jar to land is the uber spec project @ G for  
>> JavaEE 5.
>>
>> I'm most of the way there for Servlet 2.5 and JSP 2.1 but I was  
>> wondering about javadoc. Does anyone know what the rules are  
>> regarding javadoc in the spec code? I've just been doing a  
>> straight copy/typing of the api and leaving out the javadoc. But  
>> looking back at the Servlet 2.4 and JSP 2.0 spec modules all the  
>> javadoc is there.

No "copying" only "typing" is allowed.

>> I'd like to submit the patch for Servlet 2.5 and JSP 2.1 in the  
>> next week or so. If anyone knows the definitive answer (or since  
>> we are not lawyers as close to definitive as possible:) I'd love  
>> to hear it.
>
> I have not been copying the javadocs into the specs I have worked  
> on.  I think that our servlet 2.4 and jsp 2.0 specs are copied from  
> tomcat where they were IIUC donated complete with javadocs by sun.   
> I think leaving out the javadoc is the wisest course.

Yes, the javadoc comments are owned by Sun.  If you would like to  
write your own *original* javadoc comments, that would be cool, but  
not necessary.

-dain

Mime
View raw message