Re: Google Season of Docs

From: Glen Fernandes (glen.fernandes_at_[hidden])
Date: 2020-04-20 20:38:00

On Mon, Apr 20, 2020 at 1:59 PM Hans Dembinski <hans.dembinski_at_[hidden]> wrote:
> My main question: I generate my reference with doxygen in xml. The xml code is then post-
> processed using a Python script. The result is then integrated into my Quickbook docs(*) I
> quickly checked Jamfiles for the example libraries you mentioned, and none of those seem to
> have a doxygen-generated reference. How would I combine doxygen and Asciidoc?

[...]

> (*) How much annoyed I am by the inability of doxygen to produce a proper reference for a
> template-heavy lib like Boost.Histogram is another story, but I really don't want to write the
> reference by hand either and keep it in sync with code changes manually.

I don't have a solution for that, I'm afraid. As you've found, all of
the above have reference documentation manually written. (I stopped
using Doxygen even when Quickbook/Boostbook was involved, though so I
never invested time in finding out how to make things work with
Doxygen)