Re: .PHONY in Bonobo docs build

[Owen Taylor <otaylor redhat com>]

Federico Mena Quintero <federico ximian com> writes:

> "John R. Sheets" <dusk ravendusk org> writes:
> 
> > I was just wondering why the html directory is included in the list of
> > .PHONY targets in bonobo/doc/api/Makefile.am.  Only non-file targets
> > are supposed to be used in .PHONY, IIRC.
> 
> Please look at evolution/doc/devel/calendar/Makefile.am and also the
> same file on the parent directory.  Those do full dependency tracking
> for SGML and source files, and AFAIK are the best cut at gtk-doc
> makefiles so far :-)

Well, my makefiles are much longer, so they must be better! :-)

But really, assuming that LXR isn't playing tricks, I think some
advantages of the GLib/Pango/GTK+ makefiles are:

 - There is a cleaner separation of module-specifics and generics.

 - They build the HTML

 - They install only the HTML, and not lots of random files
   that nobody will need.

 - They use the stamp-generation features of recent gtk-doc
   to do very minimal building along with full dependencies

 - There is some handling for images, for multiple  source directories, etc.

 - They make some (conservative) use of globbing for dependencies,
   so they should be easier to maintain as the source files and 
   templates change.

I've tested them out pretty thoroughly for srcdir != builddir as
well.
   
An example of one of these makefiles is:

 gtk+/docs/reference/gdk-pixbuf/Makefile.am

The main disadvantage is that I ended up doing some funky 
recursive-make stuff to get all the dependency checking
right, which might be a bit fragile.

Regards,
                                        Owen