DDoc module description?

Jeremy DeHaan via Digitalmars-d-learn digitalmars-d-learn at puremagic.com
Sun Oct 19 18:58:26 PDT 2014


On Sunday, 19 October 2014 at 18:19:26 UTC, Gary Willoughby wrote:
> On Sunday, 19 October 2014 at 17:43:51 UTC, Jeremy DeHaan wrote:
>> That's ok though. I can live with out it. I'll look through 
>> the bugzilla site and see if I can find a bug report for this 
>> or open up a new one.
>>
>> On a side note, is there any way that I can redefine the DDOC 
>> macro (or any other macro) once and have it be used for every 
>> file? That was the only thing I couldn't seem to find in the 
>> documentation for it.
>
> Just add the following line to your dmd.conf file (on 
> GNU/Linux) or sc.ini file (on Windows):
>
>     DDOCFILE=file
>
> http://dlang.org/dmd-windows.html#sc-ini
> http://dlang.org/dmd-linux.html#dmd-conf

Is there no way to specify one at compile time?

Also, if I were to set the DDoc file like you suggest, does it 
look for one locally to dmd.conf/sc.ini or to the source code?



Additionally, I found out what was going on. When I redefined 
DDOC, I did so right before the module description so it ended up 
combining the two documentation blocks together putting the 
description after the html block. I just swapped them so that the 
module description appeared before I redefined the DDOC macro and 
it worked as expected again.


More information about the Digitalmars-d-learn mailing list