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