Re: xmldocs.make and friends

[Andrew Sobala <andrew sobala net>]

On Wed, 2002-09-11 at 13:51, John Fleck wrote:
> On Sat, 2002-09-07 at 20:51, Jody Goldberg wrote:
> > On Thu, Sep 05, 2002 at 08:25:36PM -0600, John Fleck wrote:
> > > 
> > > I'd like to restart the discussion about how to deal with this so that
> > > we can come up with an answer and take care of the problem in the GNOME
> > > 2.2 time frame. I don't have the auto* expertise to suggest the specific
> > > syntax needed in our build files. I can only assume the suggested fixed
> > > offered by James and Tommi on the bug report are correct. I do see more
> > > dragons ahead down the path we're on if we keep trying to fix this one
> > > xmldocs.make file at a time.
> > > 
> > > Suggestions?
> > 
> > My first thought was to have something akin to intltool.  However, I
> > suspect that a low tech approach may be simpler.   Have a module
> > that contains
> >     - a copy of the xmldocs.make file
> >     - pkgconfig info with a pointer to the installed copy of xmldocs.make
> > Then application can cut-n-paste some pkgconfig magic to find and
> > include the common copy of the xmldocs.make file.
> > 
> > It avoids making major changes to the current infrastructure, and
> > does not suffer from the problems associated with the dreaded
> > 'macros' dir approach.
> > 
> 
> This sounds like the simplest approach, but y'all need to explain stuff
> better for me. How does "pkgconfig" work?

It gives the configure script information on where things are installed,
getting it's information from .pc files in $PREFIX/lib/pkgconfig
(normally).

A .pc file specification is at
http://mail.gnome.org/archives/gnome-devel-list/2000-July/msg00208.html

Basically, you'd have a makefile that installed your
xmldocs.make/omf.make files and  xmldocs.pc with the following format:

prefix=/gnome/gnome-2-0/INSTALL/share/xmldocs/  (- this tells you where
it is installed)
Name: xmldocs
Description: Makefiles for XML documentation
Version: 1.0.0
Libs:
Cflags:

And you'd also make an autoconf macro that would tell a configure script
where the makefiles were, based around the command "pkg-config
--variable=prefix xmldocs"

> Where would the installed copy
> of xmldocs.make (and omf.make) go? gnome-common? Or do we still need to
> create our own module to handle this?

This is probably a dependancies question more than anything else.

> And will this approach still be
> subject to the backwards compatibility problem Malcolm alluded to
> earlier?

Don't know.

> The other issue we need to address is finding a hacker to implement
> whatever we come up with. I'll work closely with whoever, but I'm not
> comfortable/competent doing this kind of stuff myself.
> 
> Cheers,
> John
> -- 
> John Fleck
> jfleck inkstain net (h) jfleck abqjournal com (w)
> http://www.inkstain.net http://www.abqjournal.com
> 
> "Sometimes, a diner is all about the mac and cheese." 
>   - Zippy the Pinhead
> 
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list
> 
-- 
Andrew

"Someone needs to make a 'woops' command that reverts the hard disk to
the state it was in 20 seconds ago."
		-- me