[Libreoffice] Doxygen for C/C++ URE Documentation

[Bjoern Michaelsen]

On Wed, Jan 04, 2012 at 03:30:03PM +0100, Stephan Bergmann wrote:
> So, I tried to switch to doxygen when generating the C/C++ header
> documentation in odk/pack/gendocu. 
> And it worked quite well. 
> If there are no objections, I will commit this to master later this week.

Yes, yes, yes! great!

> The build then has an additional dependency on the doxygen
> executable as a prerequisite.  This can be controlled via
> --with-doxygen, where an explicit --without-doxygen disables
> generation of the C/C++ documentation in odk (and --disable-odk
> skips the doxygen check completely in configure).  Tinderboxes that
> have no doxygen installed would need an explicit --without-doxygen
> to avoid configure failures. (Reportedly, doxygen works well on Mac
> OS X and Windows, but I did not check that.)
> 
> With autodoc no longer used to document C++, the next step would be
> to either replace its use to generate IDL docu as well (and
> completely remove autodoc), or at least remove the C++-specific
> autodoc code.  The SDK includes the autodoc executable, but I guess
> it would be OK to change that...

Would you consider that -- or parts of that -- easyhackifiable?

Best,

Bjoern