Ready to make page-per-item ddocs the default?

Jacob Carlborg via Digitalmars-d digitalmars-d at puremagic.com
Thu Jan 8 23:19:29 PST 2015


On 2015-01-08 22:23, Adam D. Ruppe wrote:
> On Thursday, 8 January 2015 at 21:14:43 UTC, Andrei Alexandrescu wrote:
>> I don't think there is a way.
>
> version(Ddoc) dummy prototypes maybe. But that gets painful.

Tango is using this method quite heavily in some modules. It also gives 
the opportunity to simplify signatures.

> Though I think the compiler should NOT do conditional compilation when
> generating documentation. Instead, I'd prefer to just put it all out and
> then maybe group.
>
> So the doc would actually list the separate entries under all version
> headers. Not just OS, but arch or custom bits too. Then the user can see
> it all. Then by attaching classes to the outputted data you could easily
> do a filter by OS.

That would be really nice.

-- 
/Jacob Carlborg


More information about the Digitalmars-d mailing list