Re: Minutes of the GTK+ Team IRC meeting - 2008-05-13

[Stefan Kost <ensonic hora-obscura de>]

Hi,
A. Walton schrieb:
> On Wed, May 14, 2008 at 3:15 PM, Stefan Kost <ensonic hora-obscura de> wrote:
> > Hi,
> >
> > Emmanuele Bassi schrieb:
> > > = minutes for the 2008-05-13 meeting =
> > 8< snip 8<
> >
> > > * rework the gobject tutorial
> > > - it is old and unmaintained
> > > - the signals section is broken
> > > - teaches bad practises
> > I can go over it. Please send me pointers to what you want to have changed. From
> > my own todo list:
> > * G_DEFINE_TYPE and the like could be added (although I dislike their limmitations)
> >
> > Speaking of docs. Whats the opinion of gtk/glib developers regarding inline
> > api-docs. I am much in favour of them. If the core developers are for it, we
> > could do a joint effort and move the docs. I did that once for gstreamer.
> > Unfortunately glib/gdk/gtk/gtk-pixbuf is too much for one person.
>
> When asked on IRC (I'm not sure if it was me who asked or if it just
> came up in discussion though; happened back when I was working on docs
> for GIO so it's been a while), mclasen responded that he was in favor
> of inlining the documentation, and that he was doing it as he went
> along instead of just doing a mass move all at once (/paraphrase). I
> don't know if that means he's against the mass move or not, we could
> use him chiming in on this part.
>
> I completely agree with you on this though, and I'm available to help
> if this is something we really want to knock out. Having the docs in
> the code means it's more likely the documentation will get touched
> when the related code is touched, which means, at least in theory,
> we'll have better documentation everywhere which is definitely a good
> thing, for newer programmers and people like me with short attention
> spans and bad memory.
>
> Maybe we should put this on the next meeting's agenda?
>
Yes, that would be good. I missed yestadays meeting, as my kid is sick and the 
meeting is quite late (for finnish time).

It does not have to be a mass move. WHat imho is important is that it it done 
file by file. Once a file is done, it should be removed from svn (and added to 
the ignore list). Once the whole tmpl dir is done, the module can be switched to 
a tmpl free build (its a bit faster).

Stefan

> 2 cents, etc,
> -A.Walton
>
> > Stefan
> > > irc log available at: http://live.gnome.org/GTK+/Meetings
> > > next meeting: 2008-05-27, 20:00 UTC
> > >
> > > ciao,
> > >  Emmanuele.
> > _______________________________________________
> > gtk-devel-list mailing list
> > gtk-devel-list gnome org
> > http://mail.gnome.org/mailman/listinfo/gtk-devel-list