std.windows.syserror and others have documentation comments, but they are not listed in online documentation on dlang.org. Is it ok to use functions and classes from this modules in D applications?

On Friday, April 08, 2016 22:50:05 FreeSlave via Digitalmars-d-learn wrote:
> std.windows.syserror and others have documentation comments, but they are not listed in online documentation on dlang.org. Is it ok to use functions and classes from this modules in D applications?

I don't know why they're missing from the bar on the left on the website. The documentation is there, even if it's not actually linked to properly. And std.windows.charset _is_ listed on the index page even if it's not on the bar on the left. std.windows.registry is actually used by std.datetime, so that's not going anywhere, and std.windows.syserror gets used by various of the I/O relate modules, so I very much doubt that it's going anywhere either. The only one that's guaranteed to be going away is std.windows.iunknown, because it's being replaced by core.sys.windows.com and is currently deprecated. std.windows.charset should arguably go away given that we advise that folks always use the W functions and don't actually, officially support anything older than Windows 7, and the W functions have been around since at least Win2K. But I doubt that it's going anywhere, and _someone_ out there is probably using it in their code even if they really shouldn't.

So, if anything, I'd open a bug report about how std.windows is missing from the docs rather than assume that std.windows isn't supposed to be used. Presumably, it just got lost in some of the refactoring that's happened to the website in the last year or two.

- Jonathan M Davis

On Saturday, 9 April 2016 at 02:14:48 UTC, Jonathan M Davis wrote:
> So, if anything, I'd open a bug report about how std.windows is

old bug
https://issues.dlang.org/show_bug.cgi?id=13516

On Friday, 8 April 2016 at 22:50:05 UTC, FreeSlave wrote:
> std.windows.syserror and others have documentation comments, but they are not listed in online documentation on dlang.org. Is it ok to use functions and classes from this modules in D applications?

For what it is worth, my dpldocs.info site is able to document it:

http://dpldocs.info/experimental-docs/std.windows.html

and there's nothing in the source about it being private, so you should be ok using it.

On Friday, 8 April 2016 at 22:50:05 UTC, FreeSlave wrote:
> std.windows.syserror and others have documentation comments, but they are not listed in online documentation on dlang.org. Is it ok to use functions and classes from this modules in D applications?

They were documented a while ago:

http://dlang.org/phobos-prerelease/std_windows_syserror.html

https://issues.dlang.org/show_bug.cgi?id=14972

Due to a simple omission, the documentation has not propagated from /phobos-prerelease/ to /phobos/:

https://github.com/D-Programming-Language/dlang.org/pull/1265

On Tuesday, 12 April 2016 at 02:23:40 UTC, Vladimir Panteleev wrote:
> http://dlang.org/phobos-prerelease/std_windows_syserror.html

> Due to a simple omission, the documentation has not propagated from /phobos-prerelease/ to /phobos/:

Err, to correct/expand on that, the documentation has propagated, it's simply not in the navigation:

http://dlang.org/phobos/std_windows_syserror.html