[Libreoffice] Doxygen for C/C++ URE Documentation
bjoern.michaelsen at canonical.com
Wed Jan 4 07:17:42 PST 2012
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?
More information about the LibreOffice