Re: /gnome-common/doc-build/xmldocs.make and docdir

[Shaun McCance <shaunm gnome org>]

On Tue, 2007-10-23 at 23:01 +0300, Stefan Kost wrote:
> Hi Shaun,
> Shaun McCance schrieb:
> > On Tue, 2007-10-23 at 08:24 +0200, Stefan Kost wrote:
> >> hi,
> >>
> >> Quoting Shaun McCance <shaunm gnome org>:
> >>
> >>> On Mon, 2007-10-22 at 15:25 +0200, Stefan Kost wrote:
> >>>> hi,
> >>>>
> >>>> xmldocs.make at
> >>>> http://svn.gnome.org/viewvc/gnome-common/trunk/doc-build/xmldocs.make?revision=3486&view=markup
> >>>> redefines docdir and thus I get
> >>>>
> >>>> xmldocs.make:39: docdir was already defined in condition TRUE, which
> >>>> includes condition ENABLE_SCROLLKEEPER ...
> >>>> help/manual/C/Makefile.am:8:   `xmldocs.make' included from here
> >>>> configure.in:8: ... `docdir' previously defined here
> >>>>
> >>>> when running autogen (e.g. for gtk-doc). Shouldn't xmldocs.make use e.g.
> >>>>
> >>>> - docdir = $(datadir)/gnome/help/$(docname)/$(lang)
> >>>> + helpdocdir = $(datadir)/gnome/help/$(docname)/$(lang)
> >>>>
> >>>> and use the new symbol?
> >>> Are you using xmldocs.make in conjunction with another documentation
> >>> build utility like gnome-doc-utils or gtk-doc?
> >>>
> >> xmldocs.make is used to build the user-manual for gtk-doc. There is a  
> >> plan to switch to gnome-doc-utils for the gtk-doc manual, but its  
> >> blocked on broken libxml on ubuntu edgy. Will check this again after  
> >> upgrading to gutsy.
> >>
> >> Anyway, I still see xmldocs.make use here and there and thus would  
> >> like to figure our whats wrong there and fix it.
> > 
> > All right.  I'm just trying to figure out what else is
> > setting docdir that this conflicts with.  With g-d-u
> > I tried to give all the Makefile variables consistent
> > names prefixed with DOC_ or _DOC_ to avoid conflicts,
> > although it does use docdir as a shell variable a few
> > times.  But this clearly isn't a g-d-u conflict.
> > 
> > And it doesn't seem to be a conflict with gtk-doc either.
> > gtk-doc doesn't seem to use itself to build anything, and
> > it certainly isn't loading gtk-doc.make in that particular
> > directory, which is all that should matter.
> > 
> > So where's the docdir conflict coming from?
> >
> docdir is a standard variable from autotools like 'datadir' and 'builddir'.

Ah.  In that case, it should absolutely be changed.  Malcolm
Tredinnick is in the MAINTAINERS file for gnome-common, but
I haven't seen him around in ages.  I've generally talked to
James Henstridge about gnome-common changes in the past.  I'm
CCing him to see what can be done.

--
Shaun