Bug 18648 – Document the type of std.stdio.stdin and friends

For those familiar with D, you can look at the unittest documentation for std.stdio.stdin and reasonably guess that it's a std.stdio.File. That's not explicitly stated. The template used to initialize it is not documented. So a new user might reasonably look at the docs and be confused about what they can actually do with the variable. They might have to ask on D.learn and wait an hour for a response before they can make progress, because they aren't confident or perspicacious or knowledgeable enough to look at the Phobos source code or add in a `pragma(msg, typeof(stdin).stringof)`. Is this another case of "we might want to change the type later so we can't document it"?

PR https://github.com/dlang/phobos/pull/6329

Commits pushed to master at https://github.com/dlang/phobos https://github.com/dlang/phobos/commit/a502a4731f3ccf0de608c332e37455a8f6044ffc Fix Issue 18648 - Document the type of std.stdio.stdin and friends https://github.com/dlang/phobos/commit/2d8c358f436b1d734e546dc2528f7be045e31145 Merge pull request #6329 from wilzbach/std-stdio-doc Fix Issue 18648 - Document the type of std.stdio.stdin and friends merged-on-behalf-of: Jack Stouffer <[email protected]>