geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Bill Dudney <bdud...@mac.com>
Subject Re: specs and javadoc question
Date Sun, 05 Mar 2006 13:50:39 GMT
One other question - the documentation comments in the XML schema for  
the spec? Should I type in these comments or leave them out?

Thanks,

-bd-

On Mar 3, 2006, at 1:00 PM, Dain Sundstrom wrote:

> 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