geronimo-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Geir Magnusson Jr <g...@pobox.com>
Subject Re: specs and javadoc question
Date Wed, 08 Mar 2006 11:48:58 GMT
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
>>>>>>
>>>>>
>>>>
>>>>
> 
> 


Mime
View raw message