[solved] Re: [JavaDoc] javax.faces.** clazzes

[Matthias Wessendorf <mw...@gmail.com>]

fixed in nightly build

On 12/20/05, Matthias Wessendorf <mw...@gmail.com> wrote:
> some clazzes (EditableValueHolder) still contain some... javadoc.
>
> I am +1 on removing this. Only
>
> <snip>
>  * see Javadoc of <a
> href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF
> Specification</a>
>  *
> </snip>
>
> should be used. ok?
>
>
>
> On 12/20/05, Martin Marinschek <ma...@gmail.com> wrote:
> > +1
> >
> > regards,
> >
> > Martin
> >
> > On 12/20/05, Matthias Wessendorf <mw...@gmail.com> wrote:
> > > Hi,
> > >
> > > I saw Simons legal question and Geir recommended to link back to sun,
> > > since rolling our own JavaDoc for spec related stuff is not that best
> > > way.
> > >
> > > We already to on our page (http://myfaces.apache.org/javadoc.html).
> > > Also inside of some clazzes (not at all)
> > >
> > > <snip>
> > > /**
> > >  * see Javadoc of JSF Specification
> > >  *
> > >  * @author Manfred Geiler (latest modification by $Author: mwessendorf $)
> > >  * @version $Revision: 166994 $ $Date: 2004-07-02 00:12:40 +0200 (Fri,
> > > 02 Jul 2004) $
> > >  */
> > > public class UINamingContainer
> > >
> > > </snip>
> > >
> > > However, what do you think... should we use instead of "see Javadoc of
> > > JSF Specification" the hyperlink to the *original* javadocs?
> > >
> > > -Matthias
> > >
> >
> >
> > --
> >
> > http://www.irian.at
> >
> > Your JSF powerhouse -
> > JSF Consulting, Development and
> > Courses in English and German
> >
> > Professional Support for Apache MyFaces
> >
>
>
> --
> Matthias Wessendorf
> Zülpicher Wall 12, 239
> 50674 Köln
> http://www.wessendorf.net
> mwessendorf-at-gmail-dot-com
>


--
Matthias Wessendorf
Zülpicher Wall 12, 239
50674 Köln
http://www.wessendorf.net
mwessendorf-at-gmail-dot-com

Re: [solved] Re: [JavaDoc] javax.faces.** clazzes

[Mike Kienenberger <mk...@gmail.com>]

I'm a bit confused why you're removing all of the javadocs that Simon
spent so much time writing.   I can understand the usefulness of
putting a reference to the official javadoc specs, but it's far better
to have the documentation that Simon wrote plus the reference than it
is to have only the reference!

I didn't see Simon's and Geir's messages (on legal?), and you didn't
repost them on this list, so it's kinda hard to comment on that topic.

-Mike


On 12/20/05, Matthias Wessendorf <mw...@gmail.com> wrote:
> fixed in nightly build
>
> On 12/20/05, Matthias Wessendorf <mw...@gmail.com> wrote:
> > some clazzes (EditableValueHolder) still contain some... javadoc.
> >
> > I am +1 on removing this. Only
> >
> > <snip>
> >  * see Javadoc of <a
> > href="http://java.sun.com/j2ee/javaserverfaces/1.1_01/docs/api/index.html">JSF
> > Specification</a>
> >  *
> > </snip>
> >
> > should be used. ok?
> >
> >
> >
> > On 12/20/05, Martin Marinschek <ma...@gmail.com> wrote:
> > > +1
> > >
> > > regards,
> > >
> > > Martin
> > >
> > > On 12/20/05, Matthias Wessendorf <mw...@gmail.com> wrote:
> > > > Hi,
> > > >
> > > > I saw Simons legal question and Geir recommended to link back to sun,
> > > > since rolling our own JavaDoc for spec related stuff is not that best
> > > > way.
> > > >
> > > > We already to on our page (http://myfaces.apache.org/javadoc.html).
> > > > Also inside of some clazzes (not at all)
> > > >
> > > > <snip>
> > > > /**
> > > >  * see Javadoc of JSF Specification
> > > >  *
> > > >  * @author Manfred Geiler (latest modification by $Author: mwessendorf $)
> > > >  * @version $Revision: 166994 $ $Date: 2004-07-02 00:12:40 +0200 (Fri,
> > > > 02 Jul 2004) $
> > > >  */
> > > > public class UINamingContainer
> > > >
> > > > </snip>
> > > >
> > > > However, what do you think... should we use instead of "see Javadoc of
> > > > JSF Specification" the hyperlink to the *original* javadocs?
> > > >
> > > > -Matthias
> > > >
> > >
> > >
> > > --
> > >
> > > http://www.irian.at
> > >
> > > Your JSF powerhouse -
> > > JSF Consulting, Development and
> > > Courses in English and German
> > >
> > > Professional Support for Apache MyFaces
> > >
> >
> >
> > --
> > Matthias Wessendorf
> > Zülpicher Wall 12, 239
> > 50674 Köln
> > http://www.wessendorf.net
> > mwessendorf-at-gmail-dot-com
> >
>
>
> --
> Matthias Wessendorf
> Zülpicher Wall 12, 239
> 50674 Köln
> http://www.wessendorf.net
> mwessendorf-at-gmail-dot-com
>