Generate Ddoc without compiling?

Jonathan M. Wilbur jonathan at wilbur.space
Mon May 21 12:37:36 UTC 2018


I want to put in a feature request, but I want to gauge whether 
it is even feasible or not, but a little background first:

I am trying to create a Makefile to build the HTML documentation 
for a Dlang project. I would like to be able to update a single 
HTML file if the corresponding source changes, without having to 
recompile all of the others. My rule looks like this:

$(DCOMPILER) -o- -op -d -Df$@ $<

But that does not work, because some of the compiled modules 
import other modules, and the rule fails because DCOMPILER can't 
intelligently pull in the other source files. I think requiring a 
complete compile of all source to build the HTML documentation is 
a big impediment to making D highly scalable.

Having said that, I don't see why it would be technically 
impossible to make DMD build the HTML (almost) without regard to 
the validity of the source code. Is this possible? And moreover: 
*should* it be done? Is it a bad idea?




More information about the Digitalmars-d mailing list