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
>>>
>>
>
>
|