Using dub to build documentation

Question

How would I use dub to make DDocs from my source files? There appears to be no default command in dub to do this, and I'd really like to be able to automate this process.

Answer 1

Building docs through dub is actually specified through a build type.

Try dub build --build=docs or dub build --build=ddox.

The former builds 'plain' ddocs, the latter uses dub to fetch ddox to format your docs.

This is actually shown in the help, its just well hidden. Take a look at the 'build' section of dub build -h (you can use dub <command> -h to get detailed help on a specific command).