Doxygen newbie

[Jonathan M Davis]

On Monday, April 23, 2018 07:49:00 Chris Katko via Digitalmars-d-learn 
wrote:
> I'm a complete doxygen newbie. But my first thought when writing
> comments is... why not use Markdown? (Which has become almost
> universal online these days.)
>
> So I google it and Moxygen comes up. Which seems pretty good.
>
> https://sourcey.com/generating-beautiful-markdown-documentation-with-moxyg
> en/
>
> So my question is, can you use Markdown with normal Doxygen? Is
> Moxygen needed? And if so, would I run into any complications
> using D instead of C/C++ with Doxygen and Moxygen?
>
> Would there be any strange demangling issues or anything like
> that?

Historically, doxygen would not have interacted well with markdown at all,
but it looks like they added some markdown support with doxygen 1.8.0. This
page discusses it:

http://doxygen.nl/markdown.html

If you want to use doxygen with D, it should work just fine, but it's a
pretty atypical thing to do. D has its own built-in documentation generation
system, ddoc:

https://dlang.org/spec/ddoc.html

However, there are some alternatives that some in the D community use - the
most notable ones being ddox and adrdox. Several are listed on the dlang
wiki:

https://wiki.dlang.org/Documentation_Generators

- Jonathan M Davis