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