On 1/8/15 10:41 AM, Andrei Alexandrescu wrote:
On 1/8/15 4:18 AM, Steven Schveighoffer wrote:

Thoughts? I can put together a pull for core.stdc.* if it makes sense.

Blurb LGTM, please make it happen. Also let's experiment with the ///'s.

Just to put a semaphore on this, I'm partway through doing this, please don't someone else do it too, it's tedious work :)

A couple of questions though:

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.

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.

-Steve

Reply via email to