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

Andrei Alexandrescu via Digitalmars-d digitalmars-d at puremagic.com
Thu Jan 8 13:14:43 PST 2015


On 1/8/15 1:01 PM, Steven Schveighoffer wrote:
>
> 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.

I don't think there is a way. Making ddoc "cross-compilation" work would 
be an interesting project, but one of a lower priority. -- Andrei



More information about the Digitalmars-d mailing list