Thread overview
[Issue 13946] ddox should rebuild documentation incrementally
Apr 05, 2015
Sönke Ludwig
Jul 27, 2015
Sönke Ludwig
Jul 27, 2015
Sönke Ludwig
April 05, 2015
https://issues.dlang.org/show_bug.cgi?id=13946

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

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

--- Comment #1 from Sönke Ludwig <sludwig@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.

--
July 27, 2015
https://issues.dlang.org/show_bug.cgi?id=13946

--- Comment #2 from Sönke Ludwig <sludwig@outerproduct.org> ---
I guess this can be closed now.

1: is solved (the --force workaround has been removed)
2: remains, but is fast.
3: is solved

--
July 27, 2015
https://issues.dlang.org/show_bug.cgi?id=13946

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

           What    |Removed                     |Added
----------------------------------------------------------------------------
             Status|NEW                         |RESOLVED
         Resolution|---                         |FIXED

--