Building Doxygen documentation

[Chris Tapp]

On 17 Aug 2023, at 17:42, Michael Stahl <mst at libreoffice.org> wrote:
> 
> On 17/08/2023 18:12, Chris Tapp wrote:
>> I am trying to build the doxygen documentation using:
>> make odk
>> as instructed on https://wiki.documentfoundation.org/Development/Doxygen
> 
> this wiki page is very confused.
> 
> almost everything of it is about documenting *internal* LO code with doxygen, except for the "Building" section, which is about building the *public* API documentation with doxygen - 2 different things!
> 
> the internal LO code documentation can be built with "make docs".

Thanks, that gets me a bit further - I am now told that "You need the graphviz tools to create the nice inheritance graphs”. How do I install it into the LODE build environment?

> 
>> However, the following is reported:
>> *** Executable unoapploader must be registered in Repository.mk or RepositoryExternal.mk.  Stop.
>> What do I need to add to these files to fix this?
> 
> the problem is, you can't just build a single module (odk is a top-level directory aka module) without having a complete build of everything first (just "make").
> 
> note that "docs" is not a module, but just a target in the top-level makefile, so you should be able run that one without building LO (just from memory, i haven't done this in ages).


I should have mentioned that I have already run a complete build.

Chris