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