Re: [gentoo-dev] Gentoo beeping at me!

[Benjamin Schindler <config@gentoo.org>]

I've got to throw an idea in here.... How about a doxygen-style
documentation? No, it doesn't have to be doxygen, but I'm thinking of
this idea. Instead of looking at every eclass, why not have some
standard-format documentation in an eclass itself and let a tool create
the documentation in whichever format he wishes to do so.
Just my 2 cents...
On Tue, 2004-11-23 at 18:26 -0500, Dan Meltzer wrote:
> Uhh... to stick my head in...
> 
> I'd be willing to write up some documentation for the various
> eclasses, what format would you like them in? man-page style or what?
> 
> 
> On Tue, 23 Nov 2004 11:20:35 -0500, Chris Gianelloni
> <wolf31o2@gentoo.org> wrote:
> > On Tue, 2004-11-23 at 10:55 -0500, Hasan Khalil wrote:
> > > AFAIK, there is no user documentation for most eclasses' options,
> > > including this one. That's the whole problem IMO.
> > >
> > > But maybe that's just my opinion and it's not shared with anyone else,
> > > in which case this message should be disregarded.
> > 
> > Like I say any time a dev mentions anything about a lack of
> > documentation...
> > 
> > There will be some as soon as you write it!
> > 
> > *grin*
> > 
> > I will admit that I am pretty bad about documentation myself, so it is
> > definitely something that we all need to work on improving.
> > 
> > --
> > Chris Gianelloni
> > Release Engineering - Operational/QA Manager
> > Games - Developer
> > Gentoo Linux
> > 
> > 
> >
> 
> --
> gentoo-dev@gentoo.org mailing list
> 
> 
-- 
Benjamin Schindler <config@gentoo.org>
Gentoo Foundation


--
gentoo-dev@gentoo.org mailing list