www.digitalmars.com         C & C++   DMDScript  

digitalmars.D.learn - Is it legal to use std.windows modules?

reply FreeSlave <freeslave93 gmail.com> writes:
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?
Apr 08 2016
next sibling parent reply Jonathan M Davis via Digitalmars-d-learn writes:
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
Apr 08 2016
parent zabruk70 <sorry noem.ail> writes:
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
Apr 09 2016
prev sibling next sibling parent Adam D. Ruppe <destructionator gmail.com> writes:
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.
Apr 11 2016
prev sibling parent reply Vladimir Panteleev <thecybershadow.lists gmail.com> writes:
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
Apr 11 2016
parent Vladimir Panteleev <thecybershadow.lists gmail.com> writes:
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
Apr 11 2016