Re: [doc] Who copies doxygen-generated doc/html/reference for Sphinx?

From: Stefan Seefeld (stefan_at_[hidden])
Date: 2019-07-11 22:43:49

Hi Mateusz,

On 2019-07-11 6:24 p.m., Mateusz Loskot wrote:
> Hi,
>
> The doxygen outputs files to doc/html/reference
> The sphinx-build outputs to _build/html
> The doc/index.rst expects the reference folder in _build/html/
> but I can't find who copies the doc/html/reference into the _build/html
> Where does it happen?
> Or, does it not happen and simply deployment of re-generated API
> reference has been overlooked?

Good questions !

Originally doxygen and sphinx were two tools that were used 
side-by-side, and the only cross-links were hard-coded (relative) URLs 
from the sphinx sources to the generated doxygen docs. It was manually 
tuned to fit the final layout. (As far as I can see from the 
doc/Makefile, _build isn't used at all for the "html" target, other than 
for the temporary doctrees.)

I'm not quite sure what the current workflow looks like, but I'll try to 
look into it tonight.

Best,

Stefan
-- 
       ...ich hab' noch einen Koffer in Berlin...