[Issue 8086] New: std.stdio is underdocumented

[d-bugmail at puremagic.com]

http://d.puremagic.com/issues/show_bug.cgi?id=8086

           Summary: std.stdio is underdocumented
           Product: D
           Version: D2
          Platform: All
        OS/Version: All
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Phobos
        AssignedTo: nobody at puremagic.com
        ReportedBy: bugzilla at digitalmars.com


--- Comment #0 from Walter Bright <bugzilla at digitalmars.com> 2012-05-11 12:13:37 PDT ---
1. byLine is documented to return a LinesReader, but that is the only
mention of LinesReader anywhere

2. stdin and stdout are mentioned in passing several times, but they need their
own entries explaining what they are

3. LinesReader should say that it has an element type of dchar, decoding UTF8
as required

4. The canoncial program to read from stdin and write to stdout should be given
as an example:

import std.stdio;
import std.algorithm;

void main() {
    stdin.byChunk(1024).copy(stdout.lockingTextWriter());
}

5. byChunk should document what its element type is

6. byDchar is undocumented

-- 
Configure issuemail: http://d.puremagic.com/issues/userprefs.cgi?tab=email
------- You are receiving this mail because: -------