Re: App porting document

[Malcolm Tredinnick <malcolm commsecure com au>]

Michael,

On Sun, Oct 07, 2001 at 07:20:22PM -0400, Michael Meeks wrote:
> On Sun, 7 Oct 2001, Malcolm Tredinnick wrote:
> > If you are a maintainer of a platform package, please have a look at
> > the following status list ...
> 
>         Do you think you could have a brief pre-amble on how to build
> Gnome 2.0 ? you might find this:
> 
>         http://primates.ximian.com/~michael/gnome-2.0-depends.png
> 
>         useful.

Very true and something similar is already included. My capsule summary
yesterday didn't include that I've also put in sections about how to get
the software and how to build it (currently saying use the ftp packages,
module parallel install issues, or build from CVS with
vicious-build-scripts -- I'll keep that section up to date as more
options are added). I've also put a brief description of "what are the
platform libraries" and why those particular libraries made the cut and
others didn't (extracted from the lively thread on gnome-2-0-list).

> > 3. I need a short list of major changes from 1.x to 2.x:
> >       - libglade
> 
>         Almost nothing; the single most annoying thing is the change of
> signatures to include the translation domain:
> 
> - GladeXML *glade_xml_new       (const char *fname, const char *root);
> + GladeXML *glade_xml_new       (const char *fname, const char *root,
>                                  const char *domain);
> 
>         Solution pass NULL as the domain,
> 
>         Also the method: 'glade_xml_new_with_domain' is now marked public
> inside libglade but has no public prototype - hmm; either way this is
> deprecated and can be switched simply to glade_xml_new since this now
> includes the domain argument ...

Cool. Thanks.

> > 4. I have no (or very little) clue and need more complete notes:
> >       - libbonobo/libbonoboui
> 
>         For these, I think it's probably best to point people at
> libbonobo/changes.txt and libbonoboui/changes.txt since these include some
> notes on all the changes and a little on what to do about them. Bonobo has
> had fairly substantial API changes.

OK, I might just wrap some discursive stuff around those points in the
document as well. I think there's a benefit to having porting
information available both in the package itself and accessible from the
web (and I'm not sure that bonsai browsing is web accessible).

Cheers,
Malcolm

-- 
If at first you don't succeed, destroy all evidence that you tried.