What do you use to generate documentation?
Basile B. via Digitalmars-d-learn
digitalmars-d-learn at puremagic.com
Thu Jan 19 08:47:07 PST 2017
On Wednesday, 13 March 2013 at 09:35:18 UTC, Andrea Fontana wrote:
> I've tried to build documentation using ddoc format and dmd.
>
> dmd -c -D -o- ...
>
> Generated documentation looks ugly and without stylesheet. Am I
> wrong? I expected a phobos-like documentation.
>
> So, what do you use to generate your D docs? Doxygen or
> something else?
I use harbored-mod (https://github.com/kiith-sa/hmod-dub). What I
like about it:
1/ I'm not good with web things. The default styling is Okay for
me so I don't have to lost time at writing some templates or
others css files.
2/ I can call it in a single step from my IDE. For example after
installing a static library, if i don't understand the API:
- a double click to generate, using a custom tool, the doc
using an IDE environment var that symbolize the sources files of
the lib.
- a double click to open the newly generated doc in the
web-browser.
It's really a no-brainer.
Unfortunately It's not maintained anymore, but I'll go back to
harbored the day the fork won't compile anymore.
More information about the Digitalmars-d-learn
mailing list