Re: How to find the content of core.sys.* ?

2017-10-28 Thread Jacob Carlborg via Digitalmars-d-learn

On 2017-10-28 13:48, user1234 wrote:

It's not documented because everything is already well documented either 
at microsoft, posix reference, c reference etc. It would be copy and 
paste monkey work to do that.


I would be nice to have empty Ddoc comments so the symbols show up in 
the generated documentation. That way you'll know which symbols are 
available without having to read the source code.


--
/Jacob Carlborg


Re: How to find the content of core.sys.* ?

2017-10-28 Thread user1234 via Digitalmars-d-learn

On Saturday, 28 October 2017 at 11:41:16 UTC, Ryan Frame wrote:

On Tuesday, 17 May 2016 at 06:56:36 UTC, rikki cattermole wrote:

On 17/05/2016 6:55 PM, chmike wrote:

Hello,

The nice and handy documentation of dlang doesn't provide any 
info on
the core.sys. How can I find out all the things that are in 
there ?


https://github.com/dlang/druntime/tree/master/src/core/sys


So is there a reason it's not being documented? I've got a 
deprecation message saying to switch from std.c.linux.linux to 
core.sys.posix.*


Generally I'd assume undocumented features mean "don't use 
this", or at least "use at your own risk" (I believe that's why 
deprecated features are removed from the docs before they're 
pulled from the code). It looks like doc comments are pretty 
sparse in core/sys - is that the only reason docs aren't being 
generated?


It's not documented because everything is already well documented 
either at microsoft, posix reference, c reference etc. It would 
be copy and paste monkey work to do that.


Re: How to find the content of core.sys.* ?

2017-10-28 Thread Ryan Frame via Digitalmars-d-learn

On Tuesday, 17 May 2016 at 06:56:36 UTC, rikki cattermole wrote:

On 17/05/2016 6:55 PM, chmike wrote:

Hello,

The nice and handy documentation of dlang doesn't provide any 
info on
the core.sys. How can I find out all the things that are in 
there ?


https://github.com/dlang/druntime/tree/master/src/core/sys


So is there a reason it's not being documented? I've got a 
deprecation message saying to switch from std.c.linux.linux to 
core.sys.posix.*


Generally I'd assume undocumented features mean "don't use this", 
or at least "use at your own risk" (I believe that's why 
deprecated features are removed from the docs before they're 
pulled from the code). It looks like doc comments are pretty 
sparse in core/sys - is that the only reason docs aren't being 
generated?


Re: How to find the content of core.sys.* ?

2016-05-17 Thread rikki cattermole via Digitalmars-d-learn

On 17/05/2016 6:55 PM, chmike wrote:

Hello,

The nice and handy documentation of dlang doesn't provide any info on
the core.sys. How can I find out all the things that are in there ?


https://github.com/dlang/druntime/tree/master/src/core/sys


How to find the content of core.sys.* ?

2016-05-17 Thread chmike via Digitalmars-d-learn

Hello,

The nice and handy documentation of dlang doesn't provide any 
info on the core.sys. How can I find out all the things that are 
in there ?