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

[Stefan Kost <ensonic@xxxxxxxxxxxxxxx>]

Hi,
A. Walton schrieb:
> On Wed, May 14, 2008 at 3:15 PM, Stefan Kost <ensonic@xxxxxxxxxxxxxxx> 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@xxxxxxxxx
>> http://mail.gnome.org/mailman/listinfo/gtk-devel-list
>>

_______________________________________________
gtk-devel-list mailing list
gtk-devel-list@xxxxxxxxx
http://mail.gnome.org/mailman/listinfo/gtk-devel-list