No documentation for core.sys?

Steven Schveighoffer via Digitalmars-d-learn digitalmars-d-learn at puremagic.com
Thu Dec 17 08:33:04 PST 2015


On 12/17/15 2:30 AM, Jacob Carlborg wrote:
> On 2015-12-17 04:47, Jakob Ovrum wrote:
>
>> core.sys contains packages with system-specific D interface files (ports
>> of header files). As with core.stdc, refer to the documentation for the
>> equivalent C header.
>
> core.stdc is documented, in the sense that empty doc comments have been
> added to all symbols to make them show up in the docs [1]. I think the
> same should be done for core.sys as well. Then at least you know it
> exists and then can look up the documentation for the C header file for
> more information.
>
> [1] I think it was Steven Schveighoffer that did that enormous work.
>

s/enormous/tedious

As far as sys, the mapping to c headers may not be as straightforward as 
core.stdc. I agree that we should tag those for documenting, but it may 
not be as easy to refer to the c documentation.

-Steve


More information about the Digitalmars-d-learn mailing list