Is there anything to be learned from JavaDoc and DocLets?

I don't use Java, (I'm still stuck in C++), but I do hear Java programmers
bragging about JavaDoc / DocLets.


Thanks,
Doug Mair

----- Original Message -----
From: <shane at shaneroberts.com>
To: "Doug Clapp" <dclapp at qwest.net>; <squeak-dev at lists.squeakfoundation.org>
Sent: Thursday, February 06, 2003 2:17 PM
Subject: Re: Squeak Documentation Project -- add a Flap


> Doug,
> I would be happy to write the documentation scooper, if someone
> will point the way.  I was already thinking about this.
>
> Presumably the idea here would be to make the Class and Method
> comments "readable" in a more linear fashion textually.  Obviously
> they can all be read in the browser now.  But you can't easlily "scan
> across" lots of them at once, to get more of an overview, if you
> have to poke around with the browser.
>
> So somehow assimilating and formatting them like
> "documentation", would make them more comprehensible.  It would
> also make lack of documentation more visible, so it can be
> added/corrected.
>
> Any more thoughts on this?
>
> Shane
> On 6 Feb 2003 at 12:57, Doug Clapp wrote:
>
> > Documentation???  hooray!!!
> >
> > May I add a small suggestion, at the risk of making this a "too big so
> > it won't get done" kinda thing?
> >
> > I'd like too see a "Documentation" flap added to the Official Image.
> >
> > It would contain:
> >
> > 1 (Minimum)
> > A selection of tutorials, language refs and books now available on the
> > net, after gaining permission for their inclusion, of course.
> >
> > 2 (nice addition to 1.)
> > A set of hyperlinks, updated and checked for every major release, for
> > Squeak info on the net.  (This might also be added to Scamper...)
> >
> > 3 (an awesome addition to the above)
> > If documentation were actually written for all the classes, someone
> > might write a "documentation scooper" to gather them all, from top to
> > bottom, and create a single document that included them all.
> >
> > Since talk doesn't cook rice, I'd happily volunteer to provide (1.),
> > if this idea is approved by whoever's in charge here :-)  (which I've
> > still never figured out; I also think we need a Squeak Benevolent
> > Dictator For Life, as Python does, to have the "final say" on
> > Squeak...which I think would making moving forward more graceful, if
> > not faster.)
> >
> > doug clapp
> >
> >
> >
>
>
>