Documenting parameters [was: Re: Worst Phobos documentation evar!]

Joseph Rushton Wakeling via Digitalmars-d digitalmars-d at puremagic.com
Mon Dec 29 15:45:54 PST 2014


On 29/12/14 23:42, Adam D. Ruppe via Digitalmars-d wrote:
> On Monday, 29 December 2014 at 22:32:59 UTC, Walter Bright wrote:
>> I'd rather not, as it's another thing to go wrong (i.e. where would that
>> default stylesheet reside?).
>
> Right there:
> https://github.com/D-Programming-Language/dmd/blob/master/src/doc.c#L144
>
> inline, immediately following the <title> tag.

It's what I did for a project of mine:
https://github.com/WebDrake/hap/blob/master/template.ddoc

For something like the Phobos/druntime docs, or the dlang.org website, it's 
probably better to have a separate style.css file which is linked to from the 
template ddoc file, but that shouldn't complicate matters more than needing to 
include that file in the dlang.org "install" option.



More information about the Digitalmars-d mailing list