[Issue 13946] ddox should rebuild documentation incrementally

[via Digitalmars-d-bugs]

https://issues.dlang.org/show_bug.cgi?id=13946

Sönke Ludwig <sludwig at outerproduct.org> changed:

           What    |Removed                     |Added
----------------------------------------------------------------------------
                 CC|                            |sludwig at outerproduct.org

--- Comment #1 from Sönke Ludwig <sludwig at outerproduct.org> ---
There are currently three parts that take considerable time:

1. compiling the "dpl-docs" executable
2. compiling Phobos+Druntime with "-o- -X -D" to generate the JSON file
3. generating the actual HTML files

The first step is currently slow because DUB is executed with --force (thus
rebuilding it on every run) to work around
<https://github.com/D-Programming-Language/dub/issues/331>. This is fixed for
the current RC of DUB (will be tagged final tomorrow), so that we can remove
the --force now.

The second step is relatively fast, so we can probably keep it as it is for
now.

For the third step I've implemented conditional writing of HTML files using a
cache file that keeps track of the MD5 sum of all written files. As a side
effect it now also deletes obsolete HTML files of earlier runs. This is in DDOX
0.10.6.

--