porting.sgml update

[Joe Marcus Clarke]

On Tue, 2003-04-15 at 14:45, Adam Weinberger wrote:
> -----BEGIN PGP SIGNED MESSAGE-----
> Hash: SHA1
> 
> >> (04.15.2003 @ 0947 PST): Joe Marcus Clarke said, in 2.5K: <<
> > On Tue, 2003-04-15 at 04:41, Adam Weinberger wrote:
> > > I have an update to www/en/gnome/docs/porting.sgml.  At this point, it's
> > > pretty rough.  It just added entries for the GNOME2 USE_GNOME pieces,
> > > removed the GNOMENG stuff, added a little bit of text about how to
> > > decide which pieces to put in, and reordered the list to make GNOME2
> > > stuff come before GNOME1 stuff.
> > 
> > I was hoping to consolidate the long list into something more readable. 
> > Maybe we need to divide this into two porting guides.  You might also
> > want to mention GNOME_DESKTOP_VERSION when it comes to ports such as
> > libpanel, nautilus2, gnomepanel, etc.
> >> end of "Re: porting.sgml update" from Joe Marcus Clarke <<
> 
> I've fixed the formatting snafu.

Looks good.

> 
> Joe, while I agree that this should be made greatly more concise, I
> think it'd be good to at least temporarily get something that's at least
> accurate up on the webpace. I'm still grappling with finding a good way
> to represent the USE_GNOME implication structure. Once I do, the
> majority of the Big Ol' List will be irrelevant.

Okay.  I agree we need something up there ASAP.  I do have a few
comments on the existing contents.

Under your section on looking at the output of make configure to
determine which components are needed, you talk about implicit
dependencies.  It should be noted that atk is not explicitly needed here
as it is implied by libgnomeui, libwnck, and atspi.

A paragraph on GNOME_DESKTOP_VERSION, and how it will affect certain
ports would be nice to have.  Basically, if a component requires a
certain desktop version, and the user has specified they want a
different version, the port will be marked BROKEN.  If the port can
optionally use a certain GNOME desktop version, and the user has
specified another version, then the port will not enable those
desktop-specific features.  Along with this, you should add something to
the components that care about GNOME_DESKTOP_VERSION.

Joe

> 
> # Adam
> 
> 
> - --
> Adam Weinberger
> vectors.cx	>>	adam at vectors.cx
> FreeBSD.org	<<	adamw at FreeBSD.ORG
> #vim:set ts=8: 8-char tabs prevent tooth decay.
> -----BEGIN PGP SIGNATURE-----
> Version: GnuPG v1.2.1 (FreeBSD)
> 
> iD8DBQE+nFNmo8KM2ULHQ/0RAtL/AJ9qT2hHY0N4maLKcetMuVyOn1QGcgCgg147
> 7asQuH4aD0XhSQwxCoednCU=
> =foUt
> -----END PGP SIGNATURE-----
-- 
PGP Key : http://www.marcuscom.com/pgp.asc


-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 187 bytes
Desc: This is a digitally signed message part
Url : http://lists.freebsd.org/pipermail/freebsd-gnome/attachments/20030415/0b2bec48/attachment.bin