Generating documentation help

Paul Backus snarwin at gmail.com
Sun Jan 17 21:48:20 UTC 2021


On Sunday, 17 January 2021 at 21:07:31 UTC, Tim wrote:
> Hi there,
>
> I have a couple of (probably) fairly simple questions. First, 
> when I generate documentation files (-Dd docs) for my project, 
> it also generates documentation for the library Mir. How can I 
> fix the compiler pulling in those docs as well?
>
> It seems that D won't let me document class constructors. This 
> is a problem as I'd like to be able to document the constructor 
> parameters. If I put the class documentation above the class 
> definition, then ddoc gives an error that the parameters 
> specified can't be found.
>
>
> Thanks

DDoc has a number of annoying bugs like this, and as far as I 
know it isn't really maintained, so they are unlikely to be fixed 
any time soon. I recommend using adrdox instead:

https://code.dlang.org/packages/adrdox


More information about the Digitalmars-d-learn mailing list