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 20:00:20 GMT
BTW add a jira for this, so everyone knows you are working on it.

-dain

On Mar 3, 2006, at 10:02 AM, Bill Dudney wrote:

> Hi All,
>
> Thanks for the comments.
>
> Dain: Yeah its not copying out of the pdf but simply typing, hardly  
> feels like original work though so even though I'm not copying, it  
> sure feels like it. :-)
>
> I'll leave the comments out and post a patch after I get one more  
> pass over it (~early next week).
>
> TTFN,
>
>
> Bill Dudney
> MyFaces - myfaces.apache.org
>
> On Mar 3, 2006, at 10:43 AM, Dain Sundstrom wrote:
>
>> 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