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

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


On 2015-01-08 22:01, Steven Schveighoffer wrote:

> core.stdc.config is not technically a standard C header, and it seems
> pretty strange. I'm going to leave that one alone unless someone objects.

Shouldn't this then be documented like any other druntime/Phobos module.

> There are many cases where the members are dependent on the OS. The one
> that strikes me as the most OS dependent (so far) is errno.d. I'm
> guessing that only one of those docs is going to go into the online
> docs? Is there a standard way to make them all show up (with nice
> categories to show which OS they apply to) which is not painful?
>
> If not, then we really need a good way to solve this... An idea might be
> to make a switch that tells the compiler to override it's internal
> predefinitions (e.g. compile with -DWin32 on Linux) just for doc
> generation, and have the resulting page have a way to "flavor" the page
> based on the OS you select or browse from.

That would be cool.

-- 
/Jacob Carlborg


More information about the Digitalmars-d mailing list