core.stdc in docs?

[Jacob Carlborg]

On 2012-04-11 01:48, Jonathan M Davis wrote:

> Probably a good idea, but it requires putting ddoc comments on all of those
> functions in druntime (either empty ones or ones with links to the C docs
> somewhere online), which is potentially a fair bit of work. Also, in some
> cases, something like the StdDdoc version that Phobos uses (probably either
> CoreDdoc or just reuse StdDdoc) is going to have to be added to enable
> documentation-specific versions (without using D_Ddoc, since that runs into
> issue with people who try and compile their documentation and actual code at
> the same time - not a great practice IMO, but that's why StdDdoc exists).
> Also, there have been some discussions about how druntime should be split up
> as far as architectures and OSes go, and the documentation would be affected by
> that.
>
> - Jonathan M Davis

Perhaps a compiler switch to force outputting everything in the docs, 
even if they don't have any documentation comments. Then the 
declarations will at least show up in the documentation so people can 
find them.

-- 
/Jacob Carlborg