Re: build-sys: minor issues

[Ruediger Meier <sweet_f_a@gmx.de>]

On Monday 02 June 2014, Karel Zak wrote:
> On Mon, Jun 02, 2014 at 02:33:38AM +0200, Ruediger Meier wrote:
> > On Monday 02 June 2014, Ruediger Meier wrote:
> > > I have two minor issues with our build-sys:
> >
> > Another issue:
> >
> > 3. --enable-gtk-doc does not work in out-of-tree build:
>
>  I'll try to fix it (it worked time ago if I good remember). Frankly,
>  the way how is gtk-doc designed to work with autotools sucks...

Thanks.

>  BTW, our TODO:
>
>    * use something better than gtk-doc for libmount and libblkid
> (doxyden?)
>
>   ;-)

So maybe we could re-think the point below when doxygen epoch will come.

> > BTW maybe we could consider about adding these docs to dist tarball
> > to not bother users with gtk-doc deps?
>
>  Hmm... not sure, I guess the number of people who care about libs
>  docs is pretty small and for mainstream distros is the dependence on
>  gtk-doc no issue.

I know it's debatable. Just in ideal world the lib interfaces (and docs) 
are fixed for a certain release and do not depend on build host. This 
is shown more clearly if you distribute the fixed documentations along 
with the sources. It's like projects with help2man-man pages often 
distribute these man pages too.

Another minor advantage is that users would be able to compare the docs 
across serveral util-linux versions without need to build all the docs. 
(Might be difficult if an old util-linux build-sys does not work 
anymore on recent host).

cu,
Rudi