Open MPI logo

Hardware Locality Development Mailing List Archives

  |   Home   |   Support   |   FAQ   |   all Hardware Locality Development mailing list

Subject: Re: [hwloc-devel] doxygen autoconf setup
From: Brice Goglin (Brice.Goglin_at_[hidden])
Date: 2009-09-09 17:08:00


Jeff Squyres wrote:
> I'm a little confused by the doxygen setup in configure.ac -- can one
> of you shed some light on this?
>
> After the DX_* macros, I see the following:
>
> AC_CHECK_FILE(${srcdir}/doc/doxygen-doc/man, [hwloc_have_man=yes], [:])
> AC_CHECK_FILE(${srcdir}/doc/doxygen-doc/hwloc.pdf,
> [hwloc_have_pdf=yes], [:])
> AC_CHECK_FILE(${srcdir}/doc/doxygen-doc/html, [hwloc_have_html=yes], [:])
> AC_CHECK_FILE(${srcdir}/doc/doxygen-doc/hwloc.tag,
> [hwloc_have_tag=yes], [:])
>
> What are these supposed to do? None of those directories will exist
> the first time you run configure. Indeed, these tests really only
> test what happened the last time you built the doxygen output -- not
> what *will* happen when you run "make".

I think the idea is that we build the doc before make dist so that it
gets included in the tarball and users don't have to install many
dependencies to rebuild it. So we build it once and configure disables
it when it's already built.

Brice