You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@geronimo.apache.org by Bill Dudney <bd...@apache.org> on 2006/03/03 18:10:46 UTC
specs and javadoc question
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.
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.
Thanks!
TTFN,
Bill Dudney
MyFaces - myfaces.apache.org
Re: specs and javadoc question
Posted by Bill Dudney <bd...@apache.org>.
Hi Geir,
They are part of the schema in the spec pdf, no claimed copyright in
the schema definition.
TTFN,
Bill Dudney
MyFaces - myfaces.apache.org
On Mar 8, 2006, at 4:48 AM, Geir Magnusson Jr wrote:
> if the comments are part of someone else's copyrighted material,
> and it's not under a permissive open source license, please don't
> copy them.
>
> geir
>
>
> Bill Dudney wrote:
>> So I will go ahead and type the comments (I'm more than half way
>> through it anyway) and then we can delete them if we need to.
>> OK?
>> Jeff or anyone else, who should I go to for official statement?
>> legal@?
>> TTFN,
>> Bill Dudney
>> MyFaces - myfaces.apache.org
>> Wadi - incubator.apache.org/wadi
>> On Mar 7, 2006, at 4:04 PM, Jeff Genender wrote:
>>>
>>>
>>> John Sisson wrote:
>>>> We shouldn't retype the comments in the XSD just like the
>>>> javadoc in the
>>>> spec. You are welcome to type your own original comments.
>>>
>>> This is debatable for XSDs. We currently seem to be using a lot
>>> of XSDs
>>> verbatim for the SPECs, so we need an official statement on this.
>>>
>>>>
>>>> Thanks,
>>>>
>>>> John
>>>>
>>>> Bill Dudney wrote:
>>>>> Hi All,
>>>>>
>>>>> I think this must have gotten lost in the traffic over the
>>>>> weekend.
>>>>>
>>>>> Anyone know if I should/have to retype all the documentation
>>>>> comments
>>>>> in the XSD?
>>>>>
>>>>> Thanks,
>>>>>
>>>>>
>>>>> Bill Dudney
>>>>> MyFaces - myfaces.apache.org
>>>>>
>>>>>
>>>>> On Mar 5, 2006, at 6:50 AM, Bill Dudney wrote:
>>>>>
>>>>>> 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
>>>>>>>
>>>>>>
>>>>>
>>>>>
>
Re: specs and javadoc question
Posted by Geir Magnusson Jr <ge...@pobox.com>.
if the comments are part of someone else's copyrighted material, and
it's not under a permissive open source license, please don't copy them.
geir
Bill Dudney wrote:
> So I will go ahead and type the comments (I'm more than half way through
> it anyway) and then we can delete them if we need to.
>
> OK?
>
> Jeff or anyone else, who should I go to for official statement? legal@?
>
> TTFN,
>
>
> Bill Dudney
> MyFaces - myfaces.apache.org
> Wadi - incubator.apache.org/wadi
>
>
>
> On Mar 7, 2006, at 4:04 PM, Jeff Genender wrote:
>
>>
>>
>> John Sisson wrote:
>>> We shouldn't retype the comments in the XSD just like the javadoc in the
>>> spec. You are welcome to type your own original comments.
>>
>> This is debatable for XSDs. We currently seem to be using a lot of XSDs
>> verbatim for the SPECs, so we need an official statement on this.
>>
>>>
>>> Thanks,
>>>
>>> John
>>>
>>> Bill Dudney wrote:
>>>> Hi All,
>>>>
>>>> I think this must have gotten lost in the traffic over the weekend.
>>>>
>>>> Anyone know if I should/have to retype all the documentation comments
>>>> in the XSD?
>>>>
>>>> Thanks,
>>>>
>>>>
>>>> Bill Dudney
>>>> MyFaces - myfaces.apache.org
>>>>
>>>>
>>>> On Mar 5, 2006, at 6:50 AM, Bill Dudney wrote:
>>>>
>>>>> 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
>>>>>>
>>>>>
>>>>
>>>>
>
>
Re: specs and javadoc question
Posted by Bill Dudney <bd...@apache.org>.
So I will go ahead and type the comments (I'm more than half way
through it anyway) and then we can delete them if we need to.
OK?
Jeff or anyone else, who should I go to for official statement? legal@?
TTFN,
Bill Dudney
MyFaces - myfaces.apache.org
Wadi - incubator.apache.org/wadi
On Mar 7, 2006, at 4:04 PM, Jeff Genender wrote:
>
>
> John Sisson wrote:
>> We shouldn't retype the comments in the XSD just like the javadoc
>> in the
>> spec. You are welcome to type your own original comments.
>
> This is debatable for XSDs. We currently seem to be using a lot of
> XSDs
> verbatim for the SPECs, so we need an official statement on this.
>
>>
>> Thanks,
>>
>> John
>>
>> Bill Dudney wrote:
>>> Hi All,
>>>
>>> I think this must have gotten lost in the traffic over the weekend.
>>>
>>> Anyone know if I should/have to retype all the documentation
>>> comments
>>> in the XSD?
>>>
>>> Thanks,
>>>
>>>
>>> Bill Dudney
>>> MyFaces - myfaces.apache.org
>>>
>>>
>>> On Mar 5, 2006, at 6:50 AM, Bill Dudney wrote:
>>>
>>>> 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
>>>>>
>>>>
>>>
>>>
Re: specs and javadoc question
Posted by Jeff Genender <jg...@apache.org>.
John Sisson wrote:
> We shouldn't retype the comments in the XSD just like the javadoc in the
> spec. You are welcome to type your own original comments.
This is debatable for XSDs. We currently seem to be using a lot of XSDs
verbatim for the SPECs, so we need an official statement on this.
>
> Thanks,
>
> John
>
> Bill Dudney wrote:
>> Hi All,
>>
>> I think this must have gotten lost in the traffic over the weekend.
>>
>> Anyone know if I should/have to retype all the documentation comments
>> in the XSD?
>>
>> Thanks,
>>
>>
>> Bill Dudney
>> MyFaces - myfaces.apache.org
>>
>>
>> On Mar 5, 2006, at 6:50 AM, Bill Dudney wrote:
>>
>>> 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
>>>>
>>>
>>
>>
Re: specs and javadoc question
Posted by John Sisson <jr...@gmail.com>.
We shouldn't retype the comments in the XSD just like the javadoc in the
spec. You are welcome to type your own original comments.
Thanks,
John
Bill Dudney wrote:
> Hi All,
>
> I think this must have gotten lost in the traffic over the weekend.
>
> Anyone know if I should/have to retype all the documentation comments
> in the XSD?
>
> Thanks,
>
>
> Bill Dudney
> MyFaces - myfaces.apache.org
>
>
> On Mar 5, 2006, at 6:50 AM, Bill Dudney wrote:
>
>> 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
>>>
>>
>
>
Re: specs and javadoc question
Posted by Bill Dudney <bd...@apache.org>.
Hi All,
I think this must have gotten lost in the traffic over the weekend.
Anyone know if I should/have to retype all the documentation comments
in the XSD?
Thanks,
Bill Dudney
MyFaces - myfaces.apache.org
On Mar 5, 2006, at 6:50 AM, Bill Dudney wrote:
> 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
>>
>
Re: specs and javadoc question
Posted by Bill Dudney <bd...@mac.com>.
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
>
Re: specs and javadoc question
Posted by Dain Sundstrom <da...@iq80.com>.
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
Re: specs and javadoc question
Posted by Bill Dudney <bd...@apache.org>.
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
Re: specs and javadoc question
Posted by Dain Sundstrom <da...@iq80.com>.
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
Re: specs and javadoc question
Posted by David Jencks <da...@yahoo.com>.
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.
>
> 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.
thanks
david jencks
>
> Thanks!
>
> TTFN,
>
> Bill Dudney
> MyFaces - myfaces.apache.org
>
>
>