Debugging help for generating docs in a simple SCOD/DUB project

[Andre Pany]

On Wednesday, 9 January 2019 at 05:24:30 UTC, ulyssesdwolfe wrote:
> Hi,
>
> I have an issue where I am trying to generate docs but the 
> compiler just exits without giving any extra debugging info.
>
> System: OSX
> Compilers:
>
>     * LDC2 LLVM D compiler 1.13.0 installed with Brew.
>     * DMD64 D Compiler v2.084.0 installed from dlang.org DMG 
> package
>
>
> Steps I took to create this error,
>
> 1. Init a new DUB project in a test directory
> 2. add SCOD as a dependency and add in the -ddoxTool switch to 
> use scod  in dub.json
> 3. call `dub run --build=docs`
>
> I get this:
>
>
> semantic3 traits
>     
> ../../../Home/.dub/packages/diet-ng-1.5.0/diet-ng/source/diet/html.d(33,1): Warning: Ddoc: function declaration has no parameter 'dst'
>     
> ../../../Home/.dub/packages/diet-ng-1.5.0/diet-ng/source/diet/html.d(186,8): Warning: Ddoc: function declaration has no parameter 'nodes'
>     
> ../../../Home/.dub/packages/diet-ng-1.5.0/diet-ng/source/diet/html.d(186,8): Warning: Ddoc: parameter count mismatch, expected 3, got 2
>     
> ../../../Home/.dub/packages/diet-ng-1.5.0/diet-ng/source/diet/parser.d(50,10): Warning: Ddoc: function declaration has no parameter 'files'
>     
> ../../../Home/.dub/packages/diet-ng-1.5.0/diet-ng/source/diet/parser.d(50,10): Warning: Ddoc: parameter count mismatch, expected 2, got 3
> /Library/D/dmd/bin/dmd failed with exit code 1.
>
> Earlier versions of the D compilers will compile this (ldc 
> 1.7.0).
> The ddoc warnings are present in these builds as well.
> I would like to use this compiler in my actual project but 
> another of my dependencies requires a newer version of the 
> compiler.
>
> I have tried increasing the verbosity of the compiler. The last 
> line I got from that was
>
> semantic3 traits
>
> I am hoping someone can give me some tips on how to figure out 
> where it is failing...
>
> Thanks in advance

I reported a similiar issue for vibe-core. Sönke assumes it is a 
dmd bug: ```Hm, I can't see what's wrong there. The parameter 
count seems to be identical in the doc comment and in the 
signature. Workaround would be to add buildRequirements 
"allowWarnings", but it looks like this is a Ddoc bug in DMD.```

https://github.com/vibe-d/vibe-core/issues/103


I haven't created an issue so far.

Kind regards
Andre