[scope] Mr. Docs rendered reference

From: Krystian Stasiowski (sdkrystian_at_[hidden])
Date: 2023-12-04 14:08:19

Hi everyone,

My name is Krystian, and I'm a Staff Engineer at The C++ Alliance. I’ve
been working on Mr. Docs, a clang based C++ documentation generator
intended to serve as an alternative to Doxygen. Although Mr. Docs is not
yet ready for release, I noticed that there was an issue with rendering the
exception specification of destructors due to a bug in Boostbook. Thus, I
would like to present Mr. Docs as a potential future alternative, and have
generated a multi-page reference for Boost.Scope to demonstrate its
capabilities:
https://mrdocs.com/demos/develop/boost-scope/multi/adoc-asciidoc/boost/scope.html

The output was created using the built-in Asciidoc generator and converted
to HTML with asciidoctor. Since the Asciidoc generator uses handlebars
templates to format the output, customizing the rendered documentation is a
matter of modifying the templates.

Unlike Doxygen, Mr. Docs operates directly on the clang AST. This means
that support for new/obscure language features is only limited by the
extent of clang’s conformance to the latest C++ standard.

Any feedback is greatly appreciated. 🙂

Best,

Krystian Stasiowski