Re: gtk-doc cleanification idea / patch

[Damon Chaplin <damon ximian com>]

Peter Williams wrote:
> 
> On 14 May 2001 22:05:28 -0400, Owen Taylor wrote:
> > Well, I'm not sure we are interested in _expanding_ gtk-doc in
> > complexity, but if it can be made simpler to set up, I think we are
> > definitely interested in ideas about doing that.
> 
> Unsurprisingly, I've found that there are tradeoffs to "simplifying".
> What I have written so far makes using gtk-doc in a project this simple
> 
>     1. Run gtkdoc-ize (yeah, that sucks)
>     2. Put AM_PATH_GTKDOC(0.6) in configure.in
>     3. Add @GTKDOC_SGML_RULES@ and @GTKDOC_HTML_RULES@ to Makefiles
>     somewhere (and some other unpleasant garbage that seems to be
>     necessary)
> 
> In some ways, that's a lot nicer than the current setup, but in other
> ways, it's a lot worse. (Whoa, deep.) I guess its worth noting that my
> goal was fairly ambitious: take care of installation, cleaning, and all
> that stuff, not only dependencies or "make scan templates sgml".

I'm still unsure of this, as it does seem a bit complex. I'm not
totally against the idea though.


Though I did have another idea - why not forget about make and do all
the build stuff in another gtk-doc perl script (including the dist,
install & clean targets). And instead of editing the stuff at the top
of the Makefile.am you have a config file.

I think that might be a cleaner way of doing it, though its more work
than I want to do at the moment.


Damon