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
