Re: gobject API docs and tutorial merge : stage 1

[Stefan Kost <ensonic hora-obscura de>]

Hi Mathieu,

Owen Taylor and Tim Janik agreed that it would be useful to integrate it.
Although I need to appologise, I should have asked you explicitely (I've been 
probably a bit too over entusiastic with this and do too much at once).

IMHO that is what speaks for the integration:
1) still many people don't know about the gobject tutorial
2) easier to update a merged document
3) links from description to API docs

Keeping the CVS history is indeed a probelm and would require manual surgery on 
the server. I (personaly) would discontinue the stand-alone document.

I would be happy to maintain this part of the document. So if you want you can 
just forward me any patches, comment etc..

Ciao
  Stefan

> hi stefan,
>
> I am sorry if I have missed something but would you mind telling me
> exactly what deal has been agreed upon and by who ? i.e., have the glib
> maintainers expressed interest in this ? So far, I have not seen any
> public reply to your gtk-devel emails which is why I wonder how all of
> this is going forward.
>
> Are you going to checkin this new documentation somewhere in the glib
> module ? If so, how do you plan to maintain the CVS history from the
> gobject-doc module ?
>
> I am not sending this email to say that I disagree with all this but I
> would appreciate if someone could keep me in the information loop
> (please, CC me): although I don't really work on new things for the
> gobject-doc module, I still checkin whatever patches are sent to me by
> readers and feel sort of concerned about its future.
>
> thanks,
> Mathieu
>
> On Tue, 2005-03-29 at 16:43 +0200, Stefan Kost wrote:
>
> > Hi all,
> >
> > a second version has been uploaded. Now API entrie link to the API-Docs. The 2nd 
> > "Introduction" is now called "Background".
> > Comments still welcome.
> > Otherwise I'll soon commit.
> >
> > Ciao
> >   Stefan
> >
> > PS.: @glib-maintainers: anything special to take care of?
> >
> >
> > > hi,
> > >
> > > I've now stated with the document merge. The current result is available 
> > > at:
> > > http://www.buzztard.org/apidocs/gobject/
> > >
> > > I currently think about how to best merge the duplicate info from 
> > > Introduction and Concepts/Introduction.
> > >
> > > Next thing is to add links from concepts and tutorial text to API docs.
> > >
> > > Would be nice if you can try and comment, if it generally looks good 
> > > (the order of information, document structure).
> > >
> > > Ciao
> > >  Stefan
> > > _______________________________________________
> > > gtk-devel-list mailing list
> > > gtk-devel-list gnome org
> > > http://mail.gnome.org/mailman/listinfo/gtk-devel-list
> >
> > _______________________________________________
> > gtk-devel-list mailing list
> > gtk-devel-list gnome org
> > http://mail.gnome.org/mailman/listinfo/gtk-devel-list