www.digitalmars.com         C & C++   DMDScript  

digitalmars.D - Debugging help for generating docs in a simple SCOD/DUB project

reply ulyssesdwolfe <ulyssesdwolfe gmail.com> writes:
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
Jan 08 2019
next sibling parent reply Andre Pany <andre s-e-a-p.de> writes:
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
Jan 09 2019
parent ulyssesdwolfe <ulyssesdwolfe gmail.com> writes:
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.
Jan 10 2019
prev sibling parent reply Adam D. Ruppe <destructionator gmail.com> writes:
Did you use a `/// ditto` comment in that area anywhere?
Jan 09 2019
parent ulyssesdwolfe <ulyssesdwolfe gmail.com> writes:
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
Jan 10 2019