Thread overview
Debugging help for generating docs in a simple SCOD/DUB project
Jan 09, 2019
ulyssesdwolfe
Jan 09, 2019
Andre Pany
Jan 11, 2019
ulyssesdwolfe
Jan 09, 2019
Adam D. Ruppe
Jan 11, 2019
ulyssesdwolfe
January 09, 2019
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



January 09, 2019
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
January 09, 2019
Did you use a `/// ditto` comment in that area anywhere?
January 11, 2019
On Wednesday, 9 January 2019 at 20:36:39 UTC, Andre Pany wrote:
> 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

Thanks for the tip. Sonke's "buildRequirements allowWarnings" work around does work for me. I can get it to compile with that.
January 11, 2019
On Wednesday, 9 January 2019 at 20:44:22 UTC, Adam D. Ruppe wrote:
> Did you use a `/// ditto` comment in that area anywhere?

There was no `/// ditto` in the project app code.
There is this ditto in the diet-ng source.

https://github.com/rejectedsoftware/diet-ng/blob/f65a31def40f40cba2bf03a8f2093821e28a26d3/source/diet/input.d#L38